From e1ff579d1a93593b037c3932ed1ca1c9e96da535 Mon Sep 17 00:00:00 2001 From: "PANIK\\chris" Date: Tue, 5 Aug 2025 22:33:23 +0200 Subject: [PATCH] first re-commit. --- .gitignore | 4 + .qmake.stash | 23 + LICENSE | 674 + Makefile | 748 + QtGPIO.qrc | 7 + QtGPIOMain.cpp | 57 + QtGPIOMain.h | 45 + QtGPIOMain.ui | 114 + README.md | 92 + images/Black.png | Bin 0 -> 33728 bytes images/Green.png | Bin 0 -> 27268 bytes images/Red.png | Bin 0 -> 25729 bytes libPiGPIO.pro | 86 + libpigcore.cpp | 24 + libpigcore.h | 136 + libpiglinux.cpp | 407 + libpiglinux.h | 126 + libpigpio.cpp | 310 + libpigpio.h | 373 + libpigwindows.cpp | 301 + libpigwindows.h | 128 + main.cpp | 175 + moc_QtGPIOMain.cpp | 95 + moc_predefs.h | 471 + pigbeeper.cpp | 74 + pigbeeper.h | 50 + pigbin | Bin 0 -> 207576 bytes pigbutton.cpp | 69 + pigbutton.h | 54 + pigbuzzer.cpp | 65 + pigbuzzer.h | 51 + pigcall.cpp | 22 + pigcall.h | 37 + pigchrono.cpp | 49 + pigchrono.h | 53 + pigi2c.cpp | 55 + pigi2c.h | 51 + pigi2cnode.cpp | 12 + pigi2cnode.h | 53 + piglcd.cpp | 182 + piglcd.h | 165 + pigled.cpp | 59 + pigled.h | 50 + pignode.cpp | 41 + pignode.h | 49 + pignodein.cpp | 25 + pignodein.h | 50 + pignodeout.cpp | 48 + pignodeout.h | 57 + pigpin.cpp | 182 + pigpin.h | 92 + pigpio-master/.gitignore | 23 + pigpio-master/CMakeLists.txt | 127 + pigpio-master/CONTRIBUTING.md | 58 + pigpio-master/DOC/HTML/images/LDR-fritz.png | Bin 0 -> 42505 bytes pigpio-master/DOC/HTML/images/LDR-gnup-1.png | Bin 0 -> 47487 bytes pigpio-master/DOC/HTML/images/LDR-gnup-2.png | Bin 0 -> 31410 bytes pigpio-master/DOC/HTML/images/LDR-photo.jpg | Bin 0 -> 109499 bytes pigpio-master/DOC/HTML/images/LDR-wave-1.png | Bin 0 -> 4557 bytes pigpio-master/DOC/HTML/images/LDR-wave-2.png | Bin 0 -> 4438 bytes pigpio-master/DOC/HTML/images/LDR-wave-3.png | Bin 0 -> 4872 bytes pigpio-master/DOC/HTML/images/breadboard.jpg | Bin 0 -> 46953 bytes pigpio-master/DOC/HTML/images/caps.jpg | Bin 0 -> 35397 bytes pigpio-master/DOC/HTML/images/driver.jpg | Bin 0 -> 41058 bytes pigpio-master/DOC/HTML/images/faq-i2c-ss.png | Bin 0 -> 9006 bytes pigpio-master/DOC/HTML/images/faq-i2c.jpg | Bin 0 -> 42782 bytes pigpio-master/DOC/HTML/images/faq-serial.jpg | Bin 0 -> 40297 bytes pigpio-master/DOC/HTML/images/faq-spi.jpg | Bin 0 -> 43222 bytes pigpio-master/DOC/HTML/images/faq1.jpg | Bin 0 -> 14196 bytes pigpio-master/DOC/HTML/images/faq2.jpg | Bin 0 -> 37418 bytes pigpio-master/DOC/HTML/images/faq3.jpg | Bin 0 -> 6686 bytes pigpio-master/DOC/HTML/images/imu-1.jpg | Bin 0 -> 44650 bytes pigpio-master/DOC/HTML/images/imu-2.jpg | Bin 0 -> 42737 bytes pigpio-master/DOC/HTML/images/imu-3.jpg | Bin 0 -> 42800 bytes pigpio-master/DOC/HTML/images/ir-fritz.png | Bin 0 -> 40477 bytes pigpio-master/DOC/HTML/images/ir-motion.jpg | Bin 0 -> 22139 bytes pigpio-master/DOC/HTML/images/ir-photo.jpg | Bin 0 -> 90482 bytes pigpio-master/DOC/HTML/images/ir-rx.jpg | Bin 0 -> 32358 bytes pigpio-master/DOC/HTML/images/ir-wave-1.png | Bin 0 -> 4827 bytes pigpio-master/DOC/HTML/images/ir-wave-2.png | Bin 0 -> 4237 bytes pigpio-master/DOC/HTML/images/ir-wave-3.png | Bin 0 -> 5038 bytes pigpio-master/DOC/HTML/images/keypad.jpg | Bin 0 -> 30294 bytes pigpio-master/DOC/HTML/images/lcd.jpg | Bin 0 -> 29926 bytes pigpio-master/DOC/HTML/images/ldr-cap.jpg | Bin 0 -> 34448 bytes pigpio-master/DOC/HTML/images/ldr.jpg | Bin 0 -> 28458 bytes pigpio-master/DOC/HTML/images/leds.jpg | Bin 0 -> 36146 bytes pigpio-master/DOC/HTML/images/meter.jpg | Bin 0 -> 29610 bytes pigpio-master/DOC/HTML/images/motor.jpg | Bin 0 -> 17593 bytes pigpio-master/DOC/HTML/images/msp430.jpg | Bin 0 -> 43686 bytes pigpio-master/DOC/HTML/images/nano.jpg | Bin 0 -> 40463 bytes pigpio-master/DOC/HTML/images/oled-2.jpg | Bin 0 -> 40888 bytes pigpio-master/DOC/HTML/images/oled.jpg | Bin 0 -> 31872 bytes pigpio-master/DOC/HTML/images/pigpio-logo.gif | Bin 0 -> 375 bytes pigpio-master/DOC/HTML/images/pins.jpg | Bin 0 -> 42788 bytes pigpio-master/DOC/HTML/images/pisc-1.jpg | Bin 0 -> 20520 bytes pigpio-master/DOC/HTML/images/pisc-2.jpg | Bin 0 -> 17527 bytes pigpio-master/DOC/HTML/images/pisc-3.jpg | Bin 0 -> 15915 bytes pigpio-master/DOC/HTML/images/pot.jpg | Bin 0 -> 26518 bytes pigpio-master/DOC/HTML/images/pro-mini.jpg | Bin 0 -> 36398 bytes pigpio-master/DOC/HTML/images/psu.jpg | Bin 0 -> 33988 bytes pigpio-master/DOC/HTML/images/re-fritz.png | Bin 0 -> 39702 bytes pigpio-master/DOC/HTML/images/re-photo.jpg | Bin 0 -> 50100 bytes pigpio-master/DOC/HTML/images/re-wave-1.png | Bin 0 -> 5570 bytes pigpio-master/DOC/HTML/images/re-wave-2.png | Bin 0 -> 5404 bytes pigpio-master/DOC/HTML/images/remote-1.jpg | Bin 0 -> 27199 bytes pigpio-master/DOC/HTML/images/remote-2.jpg | Bin 0 -> 28482 bytes pigpio-master/DOC/HTML/images/reverse.jpg | Bin 0 -> 35860 bytes pigpio-master/DOC/HTML/images/rf-rx-2.jpg | Bin 0 -> 34515 bytes pigpio-master/DOC/HTML/images/rf-rx.jpg | Bin 0 -> 31082 bytes pigpio-master/DOC/HTML/images/rf-tx.jpg | Bin 0 -> 40421 bytes pigpio-master/DOC/HTML/images/rotary.jpg | Bin 0 -> 22765 bytes pigpio-master/DOC/HTML/images/rpi.jpg | Bin 0 -> 37698 bytes pigpio-master/DOC/HTML/images/serial.jpg | Bin 0 -> 29831 bytes pigpio-master/DOC/HTML/images/servo.jpg | Bin 0 -> 28811 bytes pigpio-master/DOC/HTML/images/sidebar.gif | Bin 0 -> 52 bytes pigpio-master/DOC/HTML/images/son-fritz.png | Bin 0 -> 69915 bytes pigpio-master/DOC/HTML/images/son-gnup-1.png | Bin 0 -> 15447 bytes pigpio-master/DOC/HTML/images/son-gnup-2.png | Bin 0 -> 12101 bytes pigpio-master/DOC/HTML/images/son-photo.jpg | Bin 0 -> 69827 bytes pigpio-master/DOC/HTML/images/son-wave-1.png | Bin 0 -> 4410 bytes pigpio-master/DOC/HTML/images/son-wave-2.png | Bin 0 -> 4293 bytes pigpio-master/DOC/HTML/images/son-wave-3.png | Bin 0 -> 4757 bytes pigpio-master/DOC/HTML/images/son-wave-4.png | Bin 0 -> 5270 bytes pigpio-master/DOC/HTML/images/speaker.jpg | Bin 0 -> 34456 bytes .../DOC/HTML/images/spi-lnx-pi3b.png | Bin 0 -> 9134 bytes .../DOC/HTML/images/spi-lnx-pibr1.png | Bin 0 -> 7174 bytes .../DOC/HTML/images/spi-pig-pi3b.png | Bin 0 -> 8896 bytes .../DOC/HTML/images/spi-pig-pibr1.png | Bin 0 -> 8502 bytes pigpio-master/DOC/HTML/images/srf02.jpg | Bin 0 -> 26595 bytes pigpio-master/DOC/HTML/images/srf04.jpg | Bin 0 -> 33664 bytes pigpio-master/DOC/HTML/images/stepper.jpg | Bin 0 -> 30634 bytes pigpio-master/DOC/HTML/images/switches.jpg | Bin 0 -> 43275 bytes pigpio-master/DOC/HTML/images/topbar.gif | Bin 0 -> 1015 bytes pigpio-master/DOC/HTML/images/transistors.jpg | Bin 0 -> 43174 bytes pigpio-master/DOC/HTML/images/ubec-2.jpg | Bin 0 -> 18920 bytes pigpio-master/DOC/HTML/images/uln2003a.jpg | Bin 0 -> 26817 bytes pigpio-master/DOC/HTML/images/wheel.jpg | Bin 0 -> 23241 bytes pigpio-master/DOC/HTML/images/wires.jpg | Bin 0 -> 36804 bytes pigpio-master/DOC/HTML/images/yl-40.jpg | Bin 0 -> 43771 bytes pigpio-master/DOC/HTML/scripts/index.css | 52 + pigpio-master/DOC/HTML/scripts/standard.css | 3 + pigpio-master/DOC/MAN/README | 1 + pigpio-master/DOC/README | 16 + pigpio-master/DOC/bin/backup.sh | 5 + pigpio-master/DOC/bin/body.py | 14 + pigpio-master/DOC/bin/build_site.py | 21 + pigpio-master/DOC/bin/cmakdoc.py | 563 + pigpio-master/DOC/bin/examples.py | 123 + pigpio-master/DOC/bin/html.py | 137 + pigpio-master/DOC/bin/purge.sh | 14 + pigpio-master/DOC/bin/pymakdoc.py | 270 + pigpio-master/DOC/bin/smakdoc.py | 376 + pigpio-master/DOC/bin/tidy.py | 28 + pigpio-master/DOC/bin/updatesql.py | 21 + pigpio-master/DOC/dbase/pigpio.sqlite | Bin 0 -> 1433600 bytes pigpio-master/DOC/makedoc | 47 + pigpio-master/DOC/src/defs/examples.def | 528 + pigpio-master/DOC/src/defs/pig2vcd.def | 110 + pigpio-master/DOC/src/defs/pigpiod.def | 101 + pigpio-master/DOC/src/defs/pigs.def | 3508 ++++ pigpio-master/DOC/src/html/download.html | 68 + pigpio-master/DOC/src/html/ex_LDR.html | 150 + pigpio-master/DOC/src/html/ex_ir_remote.html | 253 + .../DOC/src/html/ex_motor_shield.html | 254 + .../DOC/src/html/ex_rotary_encoder.html | 185 + .../DOC/src/html/ex_sonar_ranger.html | 164 + pigpio-master/DOC/src/html/faq.html | 462 + pigpio-master/DOC/src/html/index.html | 676 + pigpio-master/DOC/src/html/misc.html | 33 + pigpio-master/DOC/src/html/pif.html | 30 + pigpio-master/DOC/src/html/piscope.html | 216 + pigpio-master/DOC/src/html/sif.html | 2004 +++ pigpio-master/EXAMPLES/C/COUNTER_1/README | 3 + .../EXAMPLES/C/COUNTER_1/freq_count_1.c | 238 + pigpio-master/EXAMPLES/C/COUNTER_2/README | 6 + .../EXAMPLES/C/COUNTER_2/freq_count_2.c | 257 + .../EXAMPLES/C/HALL_EFFECT_SENSOR/README | 2 + .../EXAMPLES/C/HALL_EFFECT_SENSOR/hall.c | 51 + pigpio-master/EXAMPLES/C/I2C_SNIFFER/README | 4 + .../EXAMPLES/C/I2C_SNIFFER/pig2i2c.c | 205 + pigpio-master/EXAMPLES/C/IR_RECEIVER/README | 3 + .../EXAMPLES/C/IR_RECEIVER/ir_hasher.c | 136 + .../EXAMPLES/C/IR_RECEIVER/ir_hasher.h | 33 + .../EXAMPLES/C/IR_RECEIVER/test_ir_hasher.c | 47 + .../EXAMPLES/C/PCF8591_YL-40/PCF8591.c | 131 + pigpio-master/EXAMPLES/C/PCF8591_YL-40/README | 1 + .../EXAMPLES/C/POT_CAP_RECHARGE/README | 3 + .../C/POT_CAP_RECHARGE/pot_cap_charge.c | 94 + .../EXAMPLES/C/ROTARY_ENCODER/README | 4 + .../C/ROTARY_ENCODER/rotary_encoder.c | 94 + .../C/ROTARY_ENCODER/rotary_encoder.h | 25 + .../C/ROTARY_ENCODER/test_rotary_encoder.c | 47 + pigpio-master/EXAMPLES/C/WIEGAND_CODE/README | 4 + .../EXAMPLES/C/WIEGAND_CODE/test_wiegand.c | 42 + .../EXAMPLES/C/WIEGAND_CODE/wiegand.c | 137 + .../EXAMPLES/C/WIEGAND_CODE/wiegand.h | 32 + pigpio-master/EXAMPLES/CPP/IR_RECEIVER/README | 4 + .../EXAMPLES/CPP/IR_RECEIVER/ir_hasher.cpp | 91 + .../EXAMPLES/CPP/IR_RECEIVER/ir_hasher.hpp | 44 + .../CPP/IR_RECEIVER/test_ir_hasher.cpp | 44 + .../EXAMPLES/CPP/ROTARY_ENCODER/README | 4 + .../CPP/ROTARY_ENCODER/rotary_encoder.cpp | 84 + .../CPP/ROTARY_ENCODER/rotary_encoder.hpp | 35 + .../ROTARY_ENCODER/test_rotary_encoder.cpp | 45 + .../EXAMPLES/CPP/WIEGAND_CODE/README | 3 + .../CPP/WIEGAND_CODE/test_wiegand.cpp | 40 + .../EXAMPLES/CPP/WIEGAND_CODE/wiegand.cpp | 116 + .../EXAMPLES/CPP/WIEGAND_CODE/wiegand.hpp | 43 + .../EXAMPLES/Python/DHT11_SENSOR/README | 2 + .../EXAMPLES/Python/DHT11_SENSOR/dht11.py | 163 + .../Python/DHT22_AM2302_SENSOR/DHT22.py | 283 + .../Python/DHT22_AM2302_SENSOR/README | 2 + .../EXAMPLES/Python/GPIO_STATUS/README | 2 + .../Python/GPIO_STATUS/gpio_status.py | 65 + .../EXAMPLES/Python/HALL_EFFECT_SENSOR/README | 2 + .../Python/HALL_EFFECT_SENSOR/hall.py | 32 + .../Python/I2C_SNIFFER/I2C_sniffer.py | 163 + .../EXAMPLES/Python/I2C_SNIFFER/README | 2 + .../EXAMPLES/Python/IR_RECEIVER/README | 2 + .../EXAMPLES/Python/IR_RECEIVER/ir_hasher.py | 165 + .../EXAMPLES/Python/MORSE_CODE/README | 2 + .../EXAMPLES/Python/MORSE_CODE/morse_code.py | 72 + .../EXAMPLES/Python/PCF8591_YL-40/PCF8591.py | 64 + .../EXAMPLES/Python/PCF8591_YL-40/README | 2 + .../EXAMPLES/Python/PIGPIO_BENCHMARK/README | 2 + .../Python/PIGPIO_BENCHMARK/bench_1.py | 91 + .../EXAMPLES/Python/ROTARY_ENCODER/README | 2 + .../Python/ROTARY_ENCODER/rotary_encoder.py | 135 + .../EXAMPLES/Python/SENT_PROTOCOL/README.md | 28 + .../Python/SENT_PROTOCOL/read_SENT.py | 322 + .../EXAMPLES/Python/SONAR_RANGER/README | 2 + .../Python/SONAR_RANGER/sonar_trigger_echo.py | 114 + .../EXAMPLES/Python/VIRTUAL_WIRE/README | 2 + .../EXAMPLES/Python/VIRTUAL_WIRE/vw.py | 372 + .../EXAMPLES/Python/WIEGAND_CODE/README | 2 + .../EXAMPLES/Python/WIEGAND_CODE/wiegand.py | 135 + pigpio-master/EXAMPLES/Shell/GPIOTEST/README | 7 + .../EXAMPLES/Shell/GPIOTEST/gpiotest | 126 + pigpio-master/MakeRemote | 101 + pigpio-master/Makefile | 164 + pigpio-master/README | 174 + pigpio-master/README.md | 76 + pigpio-master/SUPPORT.md | 8 + pigpio-master/UNLICENCE | 25 + pigpio-master/cmake/FindRT.cmake | 39 + pigpio-master/cmake/pigpioConfig.cmake | 1 + pigpio-master/cmake/setup.py.in | 24 + pigpio-master/command.c | 1422 ++ pigpio-master/command.h | 124 + pigpio-master/custom.cext | 54 + pigpio-master/pig2vcd.1 | 246 + pigpio-master/pig2vcd.c | 121 + pigpio-master/pigpio.3 | 11126 ++++++++++++ pigpio-master/pigpio.c | 14036 ++++++++++++++++ pigpio-master/pigpio.h | 6572 ++++++++ pigpio-master/pigpio.py | 5821 +++++++ pigpio-master/pigpiod.1 | 273 + pigpio-master/pigpiod.c | 417 + pigpio-master/pigpiod_if.3 | 5339 ++++++ pigpio-master/pigpiod_if.c | 1572 ++ pigpio-master/pigpiod_if.h | 2996 ++++ pigpio-master/pigpiod_if2.3 | 8069 +++++++++ pigpio-master/pigpiod_if2.c | 2126 +++ pigpio-master/pigpiod_if2.h | 4388 +++++ pigpio-master/pigs.1 | 6380 +++++++ pigpio-master/pigs.c | 394 + pigpio-master/pigs.h | 41 + pigpio-master/setup.py | 23 + pigpio-master/util/Findpigpio.cmake | 31 + pigpio-master/util/pigpiod.service | 10 + pigpio-master/util/readme.md | 31 + pigpio-master/x_pigpio.c | 952 ++ pigpio-master/x_pigpio.py | 1041 ++ pigpio-master/x_pigpiod_if.c | 875 + pigpio-master/x_pigpiod_if2.c | 935 + pigpio-master/x_pigs | 330 + pigpio-master/x_pipe | 425 + pigrotarydial.cpp | 131 + pigrotarydial.h | 73 + pigsonar.cpp | 215 + pigsonar.h | 64 + pigstate.cpp | 67 + pigstate.h | 107 + pigtimer.cpp | 140 + pigtimer.h | 68 + pigvalue.cpp | 22 + pigvalue.h | 84 + qrc_QtGPIO.cpp | 5533 ++++++ sigslot/.gitignore | 12 + sigslot/LICENSE | 21 + sigslot/include/sigslot/adapter/boost.hpp | 22 + sigslot/include/sigslot/adapter/qt.hpp | 88 + sigslot/include/sigslot/signal.hpp | 1631 ++ sigslot/readme.md | 718 + ui_QtGPIOMain.h | 105 + 295 files changed, 107130 insertions(+) create mode 100644 .gitignore create mode 100644 .qmake.stash create mode 100644 LICENSE create mode 100644 Makefile create mode 100644 QtGPIO.qrc create mode 100644 QtGPIOMain.cpp create mode 100644 QtGPIOMain.h create mode 100644 QtGPIOMain.ui create mode 100644 README.md create mode 100644 images/Black.png create mode 100644 images/Green.png create mode 100644 images/Red.png create mode 100644 libPiGPIO.pro create mode 100644 libpigcore.cpp create mode 100644 libpigcore.h create mode 100644 libpiglinux.cpp create mode 100644 libpiglinux.h create mode 100644 libpigpio.cpp create mode 100644 libpigpio.h create mode 100644 libpigwindows.cpp create mode 100644 libpigwindows.h create mode 100644 main.cpp create mode 100644 moc_QtGPIOMain.cpp create mode 100644 moc_predefs.h create mode 100644 pigbeeper.cpp create mode 100644 pigbeeper.h create mode 100644 pigbin create mode 100644 pigbutton.cpp create mode 100644 pigbutton.h create mode 100644 pigbuzzer.cpp create mode 100644 pigbuzzer.h create mode 100644 pigcall.cpp create mode 100644 pigcall.h create mode 100644 pigchrono.cpp create mode 100644 pigchrono.h create mode 100644 pigi2c.cpp create mode 100644 pigi2c.h create mode 100644 pigi2cnode.cpp create mode 100644 pigi2cnode.h create mode 100644 piglcd.cpp create mode 100644 piglcd.h create mode 100644 pigled.cpp create mode 100644 pigled.h create mode 100644 pignode.cpp create mode 100644 pignode.h create mode 100644 pignodein.cpp create mode 100644 pignodein.h create mode 100644 pignodeout.cpp create mode 100644 pignodeout.h create mode 100644 pigpin.cpp create mode 100644 pigpin.h create mode 100644 pigpio-master/.gitignore create mode 100644 pigpio-master/CMakeLists.txt create mode 100644 pigpio-master/CONTRIBUTING.md create mode 100644 pigpio-master/DOC/HTML/images/LDR-fritz.png create mode 100644 pigpio-master/DOC/HTML/images/LDR-gnup-1.png create mode 100644 pigpio-master/DOC/HTML/images/LDR-gnup-2.png create mode 100644 pigpio-master/DOC/HTML/images/LDR-photo.jpg create mode 100644 pigpio-master/DOC/HTML/images/LDR-wave-1.png create mode 100644 pigpio-master/DOC/HTML/images/LDR-wave-2.png create mode 100644 pigpio-master/DOC/HTML/images/LDR-wave-3.png create mode 100644 pigpio-master/DOC/HTML/images/breadboard.jpg create mode 100644 pigpio-master/DOC/HTML/images/caps.jpg create mode 100644 pigpio-master/DOC/HTML/images/driver.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq-i2c-ss.png create mode 100644 pigpio-master/DOC/HTML/images/faq-i2c.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq-serial.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq-spi.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq1.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq2.jpg create mode 100644 pigpio-master/DOC/HTML/images/faq3.jpg create mode 100644 pigpio-master/DOC/HTML/images/imu-1.jpg create mode 100644 pigpio-master/DOC/HTML/images/imu-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/imu-3.jpg create mode 100644 pigpio-master/DOC/HTML/images/ir-fritz.png create mode 100644 pigpio-master/DOC/HTML/images/ir-motion.jpg create mode 100644 pigpio-master/DOC/HTML/images/ir-photo.jpg create mode 100644 pigpio-master/DOC/HTML/images/ir-rx.jpg create mode 100644 pigpio-master/DOC/HTML/images/ir-wave-1.png create mode 100644 pigpio-master/DOC/HTML/images/ir-wave-2.png create mode 100644 pigpio-master/DOC/HTML/images/ir-wave-3.png create mode 100644 pigpio-master/DOC/HTML/images/keypad.jpg create mode 100644 pigpio-master/DOC/HTML/images/lcd.jpg create mode 100644 pigpio-master/DOC/HTML/images/ldr-cap.jpg create mode 100644 pigpio-master/DOC/HTML/images/ldr.jpg create mode 100644 pigpio-master/DOC/HTML/images/leds.jpg create mode 100644 pigpio-master/DOC/HTML/images/meter.jpg create mode 100644 pigpio-master/DOC/HTML/images/motor.jpg create mode 100644 pigpio-master/DOC/HTML/images/msp430.jpg create mode 100644 pigpio-master/DOC/HTML/images/nano.jpg create mode 100644 pigpio-master/DOC/HTML/images/oled-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/oled.jpg create mode 100644 pigpio-master/DOC/HTML/images/pigpio-logo.gif create mode 100644 pigpio-master/DOC/HTML/images/pins.jpg create mode 100644 pigpio-master/DOC/HTML/images/pisc-1.jpg create mode 100644 pigpio-master/DOC/HTML/images/pisc-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/pisc-3.jpg create mode 100644 pigpio-master/DOC/HTML/images/pot.jpg create mode 100644 pigpio-master/DOC/HTML/images/pro-mini.jpg create mode 100644 pigpio-master/DOC/HTML/images/psu.jpg create mode 100644 pigpio-master/DOC/HTML/images/re-fritz.png create mode 100644 pigpio-master/DOC/HTML/images/re-photo.jpg create mode 100644 pigpio-master/DOC/HTML/images/re-wave-1.png create mode 100644 pigpio-master/DOC/HTML/images/re-wave-2.png create mode 100644 pigpio-master/DOC/HTML/images/remote-1.jpg create mode 100644 pigpio-master/DOC/HTML/images/remote-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/reverse.jpg create mode 100644 pigpio-master/DOC/HTML/images/rf-rx-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/rf-rx.jpg create mode 100644 pigpio-master/DOC/HTML/images/rf-tx.jpg create mode 100644 pigpio-master/DOC/HTML/images/rotary.jpg create mode 100644 pigpio-master/DOC/HTML/images/rpi.jpg create mode 100644 pigpio-master/DOC/HTML/images/serial.jpg create mode 100644 pigpio-master/DOC/HTML/images/servo.jpg create mode 100644 pigpio-master/DOC/HTML/images/sidebar.gif create mode 100644 pigpio-master/DOC/HTML/images/son-fritz.png create mode 100644 pigpio-master/DOC/HTML/images/son-gnup-1.png create mode 100644 pigpio-master/DOC/HTML/images/son-gnup-2.png create mode 100644 pigpio-master/DOC/HTML/images/son-photo.jpg create mode 100644 pigpio-master/DOC/HTML/images/son-wave-1.png create mode 100644 pigpio-master/DOC/HTML/images/son-wave-2.png create mode 100644 pigpio-master/DOC/HTML/images/son-wave-3.png create mode 100644 pigpio-master/DOC/HTML/images/son-wave-4.png create mode 100644 pigpio-master/DOC/HTML/images/speaker.jpg create mode 100644 pigpio-master/DOC/HTML/images/spi-lnx-pi3b.png create mode 100644 pigpio-master/DOC/HTML/images/spi-lnx-pibr1.png create mode 100644 pigpio-master/DOC/HTML/images/spi-pig-pi3b.png create mode 100644 pigpio-master/DOC/HTML/images/spi-pig-pibr1.png create mode 100644 pigpio-master/DOC/HTML/images/srf02.jpg create mode 100644 pigpio-master/DOC/HTML/images/srf04.jpg create mode 100644 pigpio-master/DOC/HTML/images/stepper.jpg create mode 100644 pigpio-master/DOC/HTML/images/switches.jpg create mode 100644 pigpio-master/DOC/HTML/images/topbar.gif create mode 100644 pigpio-master/DOC/HTML/images/transistors.jpg create mode 100644 pigpio-master/DOC/HTML/images/ubec-2.jpg create mode 100644 pigpio-master/DOC/HTML/images/uln2003a.jpg create mode 100644 pigpio-master/DOC/HTML/images/wheel.jpg create mode 100644 pigpio-master/DOC/HTML/images/wires.jpg create mode 100644 pigpio-master/DOC/HTML/images/yl-40.jpg create mode 100644 pigpio-master/DOC/HTML/scripts/index.css create mode 100644 pigpio-master/DOC/HTML/scripts/standard.css create mode 100644 pigpio-master/DOC/MAN/README create mode 100644 pigpio-master/DOC/README create mode 100644 pigpio-master/DOC/bin/backup.sh create mode 100644 pigpio-master/DOC/bin/body.py create mode 100644 pigpio-master/DOC/bin/build_site.py create mode 100644 pigpio-master/DOC/bin/cmakdoc.py create mode 100644 pigpio-master/DOC/bin/examples.py create mode 100644 pigpio-master/DOC/bin/html.py create mode 100644 pigpio-master/DOC/bin/purge.sh create mode 100644 pigpio-master/DOC/bin/pymakdoc.py create mode 100644 pigpio-master/DOC/bin/smakdoc.py create mode 100644 pigpio-master/DOC/bin/tidy.py create mode 100644 pigpio-master/DOC/bin/updatesql.py create mode 100644 pigpio-master/DOC/dbase/pigpio.sqlite create mode 100644 pigpio-master/DOC/makedoc create mode 100644 pigpio-master/DOC/src/defs/examples.def create mode 100644 pigpio-master/DOC/src/defs/pig2vcd.def create mode 100644 pigpio-master/DOC/src/defs/pigpiod.def create mode 100644 pigpio-master/DOC/src/defs/pigs.def create mode 100644 pigpio-master/DOC/src/html/download.html create mode 100644 pigpio-master/DOC/src/html/ex_LDR.html create mode 100644 pigpio-master/DOC/src/html/ex_ir_remote.html create mode 100644 pigpio-master/DOC/src/html/ex_motor_shield.html create mode 100644 pigpio-master/DOC/src/html/ex_rotary_encoder.html create mode 100644 pigpio-master/DOC/src/html/ex_sonar_ranger.html create mode 100644 pigpio-master/DOC/src/html/faq.html create mode 100644 pigpio-master/DOC/src/html/index.html create mode 100644 pigpio-master/DOC/src/html/misc.html create mode 100644 pigpio-master/DOC/src/html/pif.html create mode 100644 pigpio-master/DOC/src/html/piscope.html create mode 100644 pigpio-master/DOC/src/html/sif.html create mode 100644 pigpio-master/EXAMPLES/C/COUNTER_1/README create mode 100644 pigpio-master/EXAMPLES/C/COUNTER_1/freq_count_1.c create mode 100644 pigpio-master/EXAMPLES/C/COUNTER_2/README create mode 100644 pigpio-master/EXAMPLES/C/COUNTER_2/freq_count_2.c create mode 100644 pigpio-master/EXAMPLES/C/HALL_EFFECT_SENSOR/README create mode 100644 pigpio-master/EXAMPLES/C/HALL_EFFECT_SENSOR/hall.c create mode 100644 pigpio-master/EXAMPLES/C/I2C_SNIFFER/README create mode 100644 pigpio-master/EXAMPLES/C/I2C_SNIFFER/pig2i2c.c create mode 100644 pigpio-master/EXAMPLES/C/IR_RECEIVER/README create mode 100644 pigpio-master/EXAMPLES/C/IR_RECEIVER/ir_hasher.c create mode 100644 pigpio-master/EXAMPLES/C/IR_RECEIVER/ir_hasher.h create mode 100644 pigpio-master/EXAMPLES/C/IR_RECEIVER/test_ir_hasher.c create mode 100644 pigpio-master/EXAMPLES/C/PCF8591_YL-40/PCF8591.c create mode 100644 pigpio-master/EXAMPLES/C/PCF8591_YL-40/README create mode 100644 pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/README create mode 100644 pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/pot_cap_charge.c create mode 100644 pigpio-master/EXAMPLES/C/ROTARY_ENCODER/README create mode 100644 pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.c create mode 100644 pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.h create mode 100644 pigpio-master/EXAMPLES/C/ROTARY_ENCODER/test_rotary_encoder.c create mode 100644 pigpio-master/EXAMPLES/C/WIEGAND_CODE/README create mode 100644 pigpio-master/EXAMPLES/C/WIEGAND_CODE/test_wiegand.c create mode 100644 pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.c create mode 100644 pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.h create mode 100644 pigpio-master/EXAMPLES/CPP/IR_RECEIVER/README create mode 100644 pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.hpp create mode 100644 pigpio-master/EXAMPLES/CPP/IR_RECEIVER/test_ir_hasher.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/README create mode 100644 pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.hpp create mode 100644 pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/test_rotary_encoder.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/README create mode 100644 pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/test_wiegand.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.cpp create mode 100644 pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.hpp create mode 100644 pigpio-master/EXAMPLES/Python/DHT11_SENSOR/README create mode 100644 pigpio-master/EXAMPLES/Python/DHT11_SENSOR/dht11.py create mode 100644 pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/DHT22.py create mode 100644 pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/README create mode 100644 pigpio-master/EXAMPLES/Python/GPIO_STATUS/README create mode 100644 pigpio-master/EXAMPLES/Python/GPIO_STATUS/gpio_status.py create mode 100644 pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/README create mode 100644 pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/hall.py create mode 100644 pigpio-master/EXAMPLES/Python/I2C_SNIFFER/I2C_sniffer.py create mode 100644 pigpio-master/EXAMPLES/Python/I2C_SNIFFER/README create mode 100644 pigpio-master/EXAMPLES/Python/IR_RECEIVER/README create mode 100644 pigpio-master/EXAMPLES/Python/IR_RECEIVER/ir_hasher.py create mode 100644 pigpio-master/EXAMPLES/Python/MORSE_CODE/README create mode 100644 pigpio-master/EXAMPLES/Python/MORSE_CODE/morse_code.py create mode 100644 pigpio-master/EXAMPLES/Python/PCF8591_YL-40/PCF8591.py create mode 100644 pigpio-master/EXAMPLES/Python/PCF8591_YL-40/README create mode 100644 pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/README create mode 100644 pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/bench_1.py create mode 100644 pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/README create mode 100644 pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/rotary_encoder.py create mode 100644 pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/README.md create mode 100644 pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/read_SENT.py create mode 100644 pigpio-master/EXAMPLES/Python/SONAR_RANGER/README create mode 100644 pigpio-master/EXAMPLES/Python/SONAR_RANGER/sonar_trigger_echo.py create mode 100644 pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/README create mode 100644 pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/vw.py create mode 100644 pigpio-master/EXAMPLES/Python/WIEGAND_CODE/README create mode 100644 pigpio-master/EXAMPLES/Python/WIEGAND_CODE/wiegand.py create mode 100644 pigpio-master/EXAMPLES/Shell/GPIOTEST/README create mode 100644 pigpio-master/EXAMPLES/Shell/GPIOTEST/gpiotest create mode 100644 pigpio-master/MakeRemote create mode 100644 pigpio-master/Makefile create mode 100644 pigpio-master/README create mode 100644 pigpio-master/README.md create mode 100644 pigpio-master/SUPPORT.md create mode 100644 pigpio-master/UNLICENCE create mode 100644 pigpio-master/cmake/FindRT.cmake create mode 100644 pigpio-master/cmake/pigpioConfig.cmake create mode 100644 pigpio-master/cmake/setup.py.in create mode 100644 pigpio-master/command.c create mode 100644 pigpio-master/command.h create mode 100644 pigpio-master/custom.cext create mode 100644 pigpio-master/pig2vcd.1 create mode 100644 pigpio-master/pig2vcd.c create mode 100644 pigpio-master/pigpio.3 create mode 100644 pigpio-master/pigpio.c create mode 100644 pigpio-master/pigpio.h create mode 100644 pigpio-master/pigpio.py create mode 100644 pigpio-master/pigpiod.1 create mode 100644 pigpio-master/pigpiod.c create mode 100644 pigpio-master/pigpiod_if.3 create mode 100644 pigpio-master/pigpiod_if.c create mode 100644 pigpio-master/pigpiod_if.h create mode 100644 pigpio-master/pigpiod_if2.3 create mode 100644 pigpio-master/pigpiod_if2.c create mode 100644 pigpio-master/pigpiod_if2.h create mode 100644 pigpio-master/pigs.1 create mode 100644 pigpio-master/pigs.c create mode 100644 pigpio-master/pigs.h create mode 100644 pigpio-master/setup.py create mode 100644 pigpio-master/util/Findpigpio.cmake create mode 100644 pigpio-master/util/pigpiod.service create mode 100644 pigpio-master/util/readme.md create mode 100644 pigpio-master/x_pigpio.c create mode 100644 pigpio-master/x_pigpio.py create mode 100644 pigpio-master/x_pigpiod_if.c create mode 100644 pigpio-master/x_pigpiod_if2.c create mode 100644 pigpio-master/x_pigs create mode 100644 pigpio-master/x_pipe create mode 100644 pigrotarydial.cpp create mode 100644 pigrotarydial.h create mode 100644 pigsonar.cpp create mode 100644 pigsonar.h create mode 100644 pigstate.cpp create mode 100644 pigstate.h create mode 100644 pigtimer.cpp create mode 100644 pigtimer.h create mode 100644 pigvalue.cpp create mode 100644 pigvalue.h create mode 100644 qrc_QtGPIO.cpp create mode 100644 sigslot/.gitignore create mode 100644 sigslot/LICENSE create mode 100644 sigslot/include/sigslot/adapter/boost.hpp create mode 100644 sigslot/include/sigslot/adapter/qt.hpp create mode 100644 sigslot/include/sigslot/signal.hpp create mode 100644 sigslot/readme.md create mode 100644 ui_QtGPIOMain.h diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..fee33f2 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ + +*.o +*.user +*.pro.* diff --git a/.qmake.stash b/.qmake.stash new file mode 100644 index 0000000..15dfdef --- /dev/null +++ b/.qmake.stash @@ -0,0 +1,23 @@ +QMAKE_CXX.QT_COMPILER_STDCXX = 201402L +QMAKE_CXX.QMAKE_GCC_MAJOR_VERSION = 10 +QMAKE_CXX.QMAKE_GCC_MINOR_VERSION = 2 +QMAKE_CXX.QMAKE_GCC_PATCH_VERSION = 1 +QMAKE_CXX.COMPILER_MACROS = \ + QT_COMPILER_STDCXX \ + QMAKE_GCC_MAJOR_VERSION \ + QMAKE_GCC_MINOR_VERSION \ + QMAKE_GCC_PATCH_VERSION +QMAKE_CXX.INCDIRS = \ + /usr/include/c++/10 \ + /usr/include/arm-linux-gnueabihf/c++/10 \ + /usr/include/c++/10/backward \ + /usr/lib/gcc/arm-linux-gnueabihf/10/include \ + /usr/local/include \ + /usr/include/arm-linux-gnueabihf \ + /usr/include +QMAKE_CXX.LIBDIRS = \ + /usr/lib/gcc/arm-linux-gnueabihf/10 \ + /usr/lib/arm-linux-gnueabihf \ + /usr/lib \ + /lib/arm-linux-gnueabihf \ + /lib diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..e62ec04 --- /dev/null +++ b/LICENSE @@ -0,0 +1,674 @@ +GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..ae76f18 --- /dev/null +++ b/Makefile @@ -0,0 +1,748 @@ +############################################################################# +# Makefile for building: pigbin +# Generated by qmake (3.1) (Qt 5.15.2) +# Project: libPiGPIO.pro +# Template: app +# Command: /usr/lib/qt5/bin/qmake -o Makefile libPiGPIO.pro +############################################################################# + +MAKEFILE = Makefile + +EQ = = + +####### Compiler, tools and options + +CC = gcc +CXX = g++ +DEFINES = -DLIBPIGPIO_LIBRARY -DQT_NO_DEBUG -DQT_WIDGETS_LIB -DQT_GUI_LIB -DQT_NETWORK_LIB -DQT_CORE_LIB +CFLAGS = -pipe -O2 -Wall -Wextra -D_REENTRANT -fPIC $(DEFINES) +CXXFLAGS = -pipe -O2 -std=gnu++1z -Wall -Wextra -D_REENTRANT -fPIC $(DEFINES) +INCPATH = -I. -I. -Isigslot/include/sigslot -I/usr/include/arm-linux-gnueabihf/qt5 -I/usr/include/arm-linux-gnueabihf/qt5/QtWidgets -I/usr/include/arm-linux-gnueabihf/qt5/QtGui -I/usr/include/arm-linux-gnueabihf/qt5/QtNetwork -I/usr/include/arm-linux-gnueabihf/qt5/QtCore -I. -I. -I/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++ +QMAKE = /usr/lib/qt5/bin/qmake +DEL_FILE = rm -f +CHK_DIR_EXISTS= test -d +MKDIR = mkdir -p +COPY = cp -f +COPY_FILE = cp -f +COPY_DIR = cp -f -R +INSTALL_FILE = install -m 644 -p +INSTALL_PROGRAM = install -m 755 -p +INSTALL_DIR = cp -f -R +QINSTALL = /usr/lib/qt5/bin/qmake -install qinstall +QINSTALL_PROGRAM = /usr/lib/qt5/bin/qmake -install qinstall -exe +DEL_FILE = rm -f +SYMLINK = ln -f -s +DEL_DIR = rmdir +MOVE = mv -f +TAR = tar -cf +COMPRESS = gzip -9f +DISTNAME = pigbin1.0.0 +DISTDIR = /home/pi/share/projects.nxt/libPiGPIO/.tmp/pigbin1.0.0 +LINK = g++ +LFLAGS = -Wl,-O1 +LIBS = $(SUBLIBS) -lpigpiod_if2 -lrt -pthread /usr/lib/arm-linux-gnueabihf/libQt5Widgets.so /usr/lib/arm-linux-gnueabihf/libQt5Gui.so /usr/lib/arm-linux-gnueabihf/libQt5Network.so /usr/lib/arm-linux-gnueabihf/libQt5Core.so -lGLESv2 -lpthread -latomic +AR = ar cqs +RANLIB = +SED = sed +STRIP = strip + +####### Output directory + +OBJECTS_DIR = ./ + +####### Files + +SOURCES = libpigcore.cpp \ + libpiglinux.cpp \ + libpigpio.cpp \ + libpigwindows.cpp \ + pigbeeper.cpp \ + pigbutton.cpp \ + pigbuzzer.cpp \ + pigcall.cpp \ + pigchrono.cpp \ + pigi2c.cpp \ + pigi2cnode.cpp \ + piglcd.cpp \ + pigled.cpp \ + pignode.cpp \ + pignodein.cpp \ + pignodeout.cpp \ + pigsonar.cpp \ + pigstate.cpp \ + pigvalue.cpp \ + pigpin.cpp \ + pigtimer.cpp \ + pigrotarydial.cpp \ + QtGPIOMain.cpp \ + main.cpp qrc_QtGPIO.cpp \ + moc_QtGPIOMain.cpp +OBJECTS = libpigcore.o \ + libpiglinux.o \ + libpigpio.o \ + libpigwindows.o \ + pigbeeper.o \ + pigbutton.o \ + pigbuzzer.o \ + pigcall.o \ + pigchrono.o \ + pigi2c.o \ + pigi2cnode.o \ + piglcd.o \ + pigled.o \ + pignode.o \ + pignodein.o \ + pignodeout.o \ + pigsonar.o \ + pigstate.o \ + pigvalue.o \ + pigpin.o \ + pigtimer.o \ + pigrotarydial.o \ + QtGPIOMain.o \ + main.o \ + qrc_QtGPIO.o \ + moc_QtGPIOMain.o +DIST = /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_pre.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/linux.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/sanitize.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base-unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-base.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/qconfig.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_accessibility_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bluetooth.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bootstrap_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_devicediscovery_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_edid_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_egl_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfs_kms_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfsdeviceintegration_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eventdispatcher_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fb_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fontdatabase_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_input_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_kms_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_linuxaccessibility_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimedia.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimediawidgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_nfc.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_platformcompositor_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qml.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlmodels.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmltest.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlworkerscript.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quick.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quickwidgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_service_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_theme_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_vulkan_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_x11extras.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xcb_qpa_lib_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xkbcommon_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_functions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_config.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++/qmake.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_post.prf \ + .qmake.stash \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exclusive_builds.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/toolchain.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_pre.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resolve_config.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_post.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/warn_on.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources_functions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/moc.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/opengl.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/uic.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/thread.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qmake_use.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/file_copies.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/testcase_targets.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exceptions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/yacc.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/lex.prf \ + libPiGPIO.pro libpigcore.h \ + libpiglinux.h \ + libpigpio.h \ + libpigwindows.h \ + pigbeeper.h \ + pigbutton.h \ + pigbuzzer.h \ + pigcall.h \ + pigchrono.h \ + pigi2c.h \ + pigi2cnode.h \ + piglcd.h \ + pigled.h \ + pignode.h \ + pignodein.h \ + pignodeout.h \ + pigsonar.h \ + pigstate.h \ + pigvalue.h \ + pigpin.h \ + pigtimer.h \ + pigrotarydial.h \ + QtGPIOMain.h libpigcore.cpp \ + libpiglinux.cpp \ + libpigpio.cpp \ + libpigwindows.cpp \ + pigbeeper.cpp \ + pigbutton.cpp \ + pigbuzzer.cpp \ + pigcall.cpp \ + pigchrono.cpp \ + pigi2c.cpp \ + pigi2cnode.cpp \ + piglcd.cpp \ + pigled.cpp \ + pignode.cpp \ + pignodein.cpp \ + pignodeout.cpp \ + pigsonar.cpp \ + pigstate.cpp \ + pigvalue.cpp \ + pigpin.cpp \ + pigtimer.cpp \ + pigrotarydial.cpp \ + QtGPIOMain.cpp \ + main.cpp +QMAKE_TARGET = pigbin +DESTDIR = +TARGET = pigbin + + +first: all +####### Build rules + +pigbin: ui_QtGPIOMain.h $(OBJECTS) + $(LINK) $(LFLAGS) -o $(TARGET) $(OBJECTS) $(OBJCOMP) $(LIBS) + +Makefile: libPiGPIO.pro /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++/qmake.conf /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_pre.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/linux.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/sanitize.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base-unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-base.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-unix.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/qconfig.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_accessibility_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bluetooth.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bootstrap_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_devicediscovery_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_edid_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_egl_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfs_kms_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfsdeviceintegration_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eventdispatcher_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fb_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fontdatabase_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_input_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_kms_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_linuxaccessibility_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimedia.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimediawidgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_nfc.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_platformcompositor_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qml.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlmodels.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmltest.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlworkerscript.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quick.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quickwidgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_service_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_theme_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_vulkan_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_x11extras.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xcb_qpa_lib_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xkbcommon_support_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml_private.pri \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_functions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_config.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++/qmake.conf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_post.prf \ + .qmake.stash \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exclusive_builds.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/toolchain.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_pre.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resolve_config.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_post.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/warn_on.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources_functions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/moc.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/opengl.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/uic.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/thread.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qmake_use.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/file_copies.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/testcase_targets.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exceptions.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/yacc.prf \ + /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/lex.prf \ + libPiGPIO.pro \ + QtGPIO.qrc + $(QMAKE) -o Makefile libPiGPIO.pro +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_pre.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/unix.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/linux.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/sanitize.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/gcc-base-unix.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-base.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/common/g++-unix.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/qconfig.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_accessibility_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bluetooth.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_bootstrap_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_concurrent_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_core_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_dbus_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_devicediscovery_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_edid_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_egl_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfs_kms_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eglfsdeviceintegration_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_eventdispatcher_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fb_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_fontdatabase_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_gui_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_input_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_kms_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_linuxaccessibility_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimedia.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_multimediawidgets.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_network_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_nfc.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_opengl_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_openglextensions_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_platformcompositor_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_printsupport_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qml.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlmodels.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmltest.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_qmlworkerscript.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quick.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_quickwidgets.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_service_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_sql_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_testlib_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_theme_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_vulkan_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_widgets_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_x11extras.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xcb_qpa_lib_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xkbcommon_support_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/modules/qt_lib_xml_private.pri: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_functions.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt_config.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++/qmake.conf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/spec_post.prf: +.qmake.stash: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exclusive_builds.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/toolchain.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_pre.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resolve_config.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/default_post.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/warn_on.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qt.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources_functions.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/resources.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/moc.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/opengl.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/uic.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/unix/thread.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/qmake_use.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/file_copies.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/testcase_targets.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/exceptions.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/yacc.prf: +/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/lex.prf: +libPiGPIO.pro: +QtGPIO.qrc: +qmake: FORCE + @$(QMAKE) -o Makefile libPiGPIO.pro + +qmake_all: FORCE + + +all: Makefile pigbin + +dist: distdir FORCE + (cd `dirname $(DISTDIR)` && $(TAR) $(DISTNAME).tar $(DISTNAME) && $(COMPRESS) $(DISTNAME).tar) && $(MOVE) `dirname $(DISTDIR)`/$(DISTNAME).tar.gz . && $(DEL_FILE) -r $(DISTDIR) + +distdir: FORCE + @test -d $(DISTDIR) || mkdir -p $(DISTDIR) + $(COPY_FILE) --parents $(DIST) $(DISTDIR)/ + $(COPY_FILE) --parents QtGPIO.qrc $(DISTDIR)/ + $(COPY_FILE) --parents /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/data/dummy.cpp $(DISTDIR)/ + $(COPY_FILE) --parents libpigcore.h libpiglinux.h libpigpio.h libpigwindows.h pigbeeper.h pigbutton.h pigbuzzer.h pigcall.h pigchrono.h pigi2c.h pigi2cnode.h piglcd.h pigled.h pignode.h pignodein.h pignodeout.h pigsonar.h pigstate.h pigvalue.h pigpin.h pigtimer.h pigrotarydial.h QtGPIOMain.h $(DISTDIR)/ + $(COPY_FILE) --parents libpigcore.cpp libpiglinux.cpp libpigpio.cpp libpigwindows.cpp pigbeeper.cpp pigbutton.cpp pigbuzzer.cpp pigcall.cpp pigchrono.cpp pigi2c.cpp pigi2cnode.cpp piglcd.cpp pigled.cpp pignode.cpp pignodein.cpp pignodeout.cpp pigsonar.cpp pigstate.cpp pigvalue.cpp pigpin.cpp pigtimer.cpp pigrotarydial.cpp QtGPIOMain.cpp main.cpp $(DISTDIR)/ + $(COPY_FILE) --parents QtGPIOMain.ui $(DISTDIR)/ + + +clean: compiler_clean + -$(DEL_FILE) $(OBJECTS) + -$(DEL_FILE) *~ core *.core + + +distclean: clean + -$(DEL_FILE) $(TARGET) + -$(DEL_FILE) .qmake.stash + -$(DEL_FILE) Makefile + + +####### Sub-libraries + +mocclean: compiler_moc_header_clean compiler_moc_objc_header_clean compiler_moc_source_clean + +mocables: compiler_moc_header_make_all compiler_moc_objc_header_make_all compiler_moc_source_make_all + +check: first + +benchmark: first + +compiler_rcc_make_all: qrc_QtGPIO.cpp +compiler_rcc_clean: + -$(DEL_FILE) qrc_QtGPIO.cpp +qrc_QtGPIO.cpp: QtGPIO.qrc \ + /usr/lib/qt5/bin/rcc \ + images/Red.png \ + images/Black.png \ + images/Green.png + /usr/lib/qt5/bin/rcc -name QtGPIO QtGPIO.qrc -o qrc_QtGPIO.cpp + +compiler_moc_predefs_make_all: moc_predefs.h +compiler_moc_predefs_clean: + -$(DEL_FILE) moc_predefs.h +moc_predefs.h: /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/data/dummy.cpp + g++ -pipe -O2 -std=gnu++1z -Wall -Wextra -dM -E -o moc_predefs.h /usr/lib/arm-linux-gnueabihf/qt5/mkspecs/features/data/dummy.cpp + +compiler_moc_header_make_all: moc_QtGPIOMain.cpp +compiler_moc_header_clean: + -$(DEL_FILE) moc_QtGPIOMain.cpp +moc_QtGPIOMain.cpp: QtGPIOMain.h \ + ui_QtGPIOMain.h \ + pigrotarydial.h \ + pigbutton.h \ + pignodein.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h \ + moc_predefs.h \ + /usr/lib/qt5/bin/moc + /usr/lib/qt5/bin/moc $(DEFINES) --include /home/pi/share/projects.nxt/libPiGPIO/moc_predefs.h -I/usr/lib/arm-linux-gnueabihf/qt5/mkspecs/linux-g++ -I/home/pi/share/projects.nxt/libPiGPIO -I/home/pi/share/projects.nxt/libPiGPIO -I/home/pi/share/projects.nxt/libPiGPIO/sigslot/include/sigslot -I/usr/include/arm-linux-gnueabihf/qt5 -I/usr/include/arm-linux-gnueabihf/qt5/QtWidgets -I/usr/include/arm-linux-gnueabihf/qt5/QtGui -I/usr/include/arm-linux-gnueabihf/qt5/QtNetwork -I/usr/include/arm-linux-gnueabihf/qt5/QtCore -I/usr/include/c++/10 -I/usr/include/arm-linux-gnueabihf/c++/10 -I/usr/include/c++/10/backward -I/usr/lib/gcc/arm-linux-gnueabihf/10/include -I/usr/local/include -I/usr/include/arm-linux-gnueabihf -I/usr/include QtGPIOMain.h -o moc_QtGPIOMain.cpp + +compiler_moc_objc_header_make_all: +compiler_moc_objc_header_clean: +compiler_moc_source_make_all: +compiler_moc_source_clean: +compiler_uic_make_all: ui_QtGPIOMain.h +compiler_uic_clean: + -$(DEL_FILE) ui_QtGPIOMain.h +ui_QtGPIOMain.h: QtGPIOMain.ui \ + /usr/lib/qt5/bin/uic + /usr/lib/qt5/bin/uic QtGPIOMain.ui -o ui_QtGPIOMain.h + +compiler_yacc_decl_make_all: +compiler_yacc_decl_clean: +compiler_yacc_impl_make_all: +compiler_yacc_impl_clean: +compiler_lex_make_all: +compiler_lex_clean: +compiler_clean: compiler_rcc_clean compiler_moc_predefs_clean compiler_moc_header_clean compiler_uic_clean + +####### Compile + +libpigcore.o: libpigcore.cpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o libpigcore.o libpigcore.cpp + +libpiglinux.o: libpiglinux.cpp libpiglinux.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + libpigcore.h \ + pigi2c.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o libpiglinux.o libpiglinux.cpp + +libpigpio.o: libpigpio.cpp libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigpin.h \ + pignode.h \ + pigcall.h \ + libpigwindows.h \ + libpigcore.h \ + libpiglinux.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o libpigpio.o libpigpio.cpp + +libpigwindows.o: libpigwindows.cpp libpigwindows.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + libpigcore.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o libpigwindows.o libpigwindows.cpp + +pigbeeper.o: pigbeeper.cpp pigbeeper.h \ + pignodeout.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigbeeper.o pigbeeper.cpp + +pigbutton.o: pigbutton.cpp pigbutton.h \ + pignodein.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigbutton.o pigbutton.cpp + +pigbuzzer.o: pigbuzzer.cpp pigbuzzer.h \ + pignodeout.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigbuzzer.o pigbuzzer.cpp + +pigcall.o: pigcall.cpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigcall.o pigcall.cpp + +pigchrono.o: pigchrono.cpp pigchrono.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigchrono.o pigchrono.cpp + +pigi2c.o: pigi2c.cpp pigi2c.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigi2c.o pigi2c.cpp + +pigi2cnode.o: pigi2cnode.cpp pigi2cnode.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pignode.h \ + pigcall.h \ + pigi2c.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigi2cnode.o pigi2cnode.cpp + +piglcd.o: piglcd.cpp piglcd.h \ + pigi2cnode.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pignode.h \ + pigcall.h \ + pigi2c.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o piglcd.o piglcd.cpp + +pigled.o: pigled.cpp pigled.h \ + pignodeout.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigled.o pigled.cpp + +pignode.o: pignode.cpp pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pignode.o pignode.cpp + +pignodein.o: pignodein.cpp pignodein.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pignodein.o pignodein.cpp + +pignodeout.o: pignodeout.cpp pignodeout.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pignodeout.o pignodeout.cpp + +pigsonar.o: pigsonar.cpp pigsonar.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigvalue.h \ + pigpin.h \ + pigchrono.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigsonar.o pigsonar.cpp + +pigstate.o: pigstate.cpp pigstate.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigvalue.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigstate.o pigstate.cpp + +pigvalue.o: pigvalue.cpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigvalue.o pigvalue.cpp + +pigpin.o: pigpin.cpp pigpin.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + libpigcore.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigpin.o pigpin.cpp + +pigtimer.o: pigtimer.cpp pigtimer.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigtimer.o pigtimer.cpp + +pigrotarydial.o: pigrotarydial.cpp pigrotarydial.h \ + pigbutton.h \ + pignodein.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o pigrotarydial.o pigrotarydial.cpp + +QtGPIOMain.o: QtGPIOMain.cpp QtGPIOMain.h \ + ui_QtGPIOMain.h \ + pigrotarydial.h \ + pigbutton.h \ + pignodein.h \ + pignode.h \ + pigcall.h \ + libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigstate.h \ + pigvalue.h \ + pigpin.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o QtGPIOMain.o QtGPIOMain.cpp + +main.o: main.cpp libpigpio.h \ + sigslot/include/sigslot/signal.hpp \ + pigbutton.h \ + pignodein.h \ + pignode.h \ + pigcall.h \ + pigstate.h \ + pigvalue.h \ + pigpin.h \ + pigtimer.h \ + pigrotarydial.h \ + pigchrono.h \ + pigsonar.h \ + piglcd.h \ + pigi2cnode.h \ + pigi2c.h \ + pigbeeper.h \ + pignodeout.h \ + pigbuzzer.h \ + pigled.h \ + QtGPIOMain.h \ + ui_QtGPIOMain.h + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o main.o main.cpp + +qrc_QtGPIO.o: qrc_QtGPIO.cpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o qrc_QtGPIO.o qrc_QtGPIO.cpp + +moc_QtGPIOMain.o: moc_QtGPIOMain.cpp + $(CXX) -c $(CXXFLAGS) $(INCPATH) -o moc_QtGPIOMain.o moc_QtGPIOMain.cpp + +####### Install + +install: FORCE + +uninstall: FORCE + +FORCE: + diff --git a/QtGPIO.qrc b/QtGPIO.qrc new file mode 100644 index 0000000..3c2234f --- /dev/null +++ b/QtGPIO.qrc @@ -0,0 +1,7 @@ + + + images/Green.png + images/Red.png + images/Black.png + + diff --git a/QtGPIOMain.cpp b/QtGPIOMain.cpp new file mode 100644 index 0000000..8926669 --- /dev/null +++ b/QtGPIOMain.cpp @@ -0,0 +1,57 @@ +/*************************************************************************** + + QtGPIO + Copyright © 2013-2022 christoph holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + +***************************************************************************/ + + +#include +#include +#include + + +QtGPIOMain::QtGPIOMain( QWidget* parent ) + : QMainWindow( parent ), _pigDial( pigpio::bcm17, pigpio::bcm27, pigpio::bcm22 ) +{ + + setupUi( this ); + + //_rotaryDial.init( pigpio::bcm17, pigpio::bcm27, pigpio::bcm22 ); + //auto lambda = []() { std::cout << "lambda\n"; }; + //_rotaryDial.sigState.connect( lambda ); + + + //pigRotaryDial dial( pigpio::bcm17, pigpio::bcm27, pigpio::bcm22 ); + //_rotaryDial.add_state_observer( &myMoo ); + //_rotaryDial.add_value_observer( &myMoo ); + + //_pigDial.add_state_observer( this ); + //_pigDial.add_value_observer( this ); + +} + + +QtGPIOMain::~QtGPIOMain() +{ + +} + +void QtGPIOMain::on_state_changed( bool state ) +{ + qDebug() << "onStateChanged: " << state; + _LED->setChecked( state ); + +} + +void QtGPIOMain::on_value_changed( int value ) +{ + qDebug() << "on_value_changed: " << value; + _dial->setValue( value ); +} diff --git a/QtGPIOMain.h b/QtGPIOMain.h new file mode 100644 index 0000000..13cbc39 --- /dev/null +++ b/QtGPIOMain.h @@ -0,0 +1,45 @@ +/*************************************************************************** + + QtGPIO + Copyright © 2013-2022 christoph holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + +***************************************************************************/ + + +#ifndef QPIGPIOMAIN_H +#define QPIGPIOMAIN_H + +#include +#include +#include +#include + + + +class QtGPIOMain : public QMainWindow, private Ui_QtGPIOMain +{ + Q_OBJECT + +public: + + QtGPIOMain( QWidget* parent = nullptr ); + virtual ~QtGPIOMain(); + + void on_state_changed( bool state ); + void on_value_changed( int value ); + + +protected: + + pigRotaryDial _pigDial; + + +}; + +#endif // QPIGPIOMAIN_H diff --git a/QtGPIOMain.ui b/QtGPIOMain.ui new file mode 100644 index 0000000..3742977 --- /dev/null +++ b/QtGPIOMain.ui @@ -0,0 +1,114 @@ + + + QtGPIOMain + + + + 0 + 0 + 473 + 342 + + + + libPiGPio Widget Demo + + + + + + + + + + background: grey + + + QFrame::NoFrame + + + QFrame::Sunken + + + 10 + + + 10 + + + + + 50 + 60 + 91 + 81 + + + + background: grey + + + + + + + :/images/Green.png + :/images/Red.png:/images/Green.png + + + + 64 + 64 + + + + false + + + true + + + + + + 130 + 60 + 80 + 80 + + + + + + + 250 + 90 + 131 + 41 + + + + background:lightgrey + + + + + + + + + + 0 + 0 + 473 + 26 + + + + + + + + + + diff --git a/README.md b/README.md new file mode 100644 index 0000000..7462eea --- /dev/null +++ b/README.md @@ -0,0 +1,92 @@ +# libPiGPIO + +Die libPiGPIO c++ library + +## Getting started + +To make it easy for you to get started with GitLab, here's a list of recommended next steps. + +Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)! + +## Add your files + +- [ ] [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files +- [ ] [Add files using the command line](https://docs.gitlab.com/ee/gitlab-basics/add-file.html#add-a-file-using-the-command-line) or push an existing Git repository with the following command: + +``` +cd existing_repo +git remote add origin http://sourceworx.org:9099/opensource/libpigpio.git +git branch -M main +git push -uf origin main +``` + +## Integrate with your tools + +- [ ] [Set up project integrations](http://sourceworx.org:9099/opensource/libpigpio/-/settings/integrations) + +## Collaborate with your team + +- [ ] [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/) +- [ ] [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html) +- [ ] [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically) +- [ ] [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/) +- [ ] [Automatically merge when pipeline succeeds](https://docs.gitlab.com/ee/user/project/merge_requests/merge_when_pipeline_succeeds.html) + +## Test and Deploy + +Use the built-in continuous integration in GitLab. + +- [ ] [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/index.html) +- [ ] [Analyze your code for known vulnerabilities with Static Application Security Testing(SAST)](https://docs.gitlab.com/ee/user/application_security/sast/) +- [ ] [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html) +- [ ] [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/) +- [ ] [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html) + +*** + +# Editing this README + +When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thank you to [makeareadme.com](https://www.makeareadme.com/) for this template. + +## Suggestions for a good README +Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information. + +## Name +Choose a self-explaining name for your project. + +## Description +Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors. + +## Badges +On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge. + +## Visuals +Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method. + +## Installation +Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection. + +## Usage +Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README. + +## Support +Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc. + +## Roadmap +If you have ideas for releases in the future, it is a good idea to list them in the README. + +## Contributing +State if you are open to contributions and what your requirements are for accepting them. + +For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self. + +You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser. + +## Authors and acknowledgment +Show your appreciation to those who have contributed to the project. + +## License +For open source projects, say how it is licensed. + +## Project status +If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers. diff --git a/images/Black.png b/images/Black.png new file mode 100644 index 0000000000000000000000000000000000000000..f85b723e0e3adb1df47cecf79f6da71e120bc2bb GIT binary patch literal 33728 zcmV)nK%KvdP)004R>004l5008;`004mK004C`008P>0026e000+ooVrmw00002 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 literal 0 HcmV?d00001 diff --git a/images/Red.png b/images/Red.png new file mode 100644 index 0000000000000000000000000000000000000000..f318912e5e34542e4c2df1f643eb0bfad4ceba4d GIT binary patch literal 25729 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 +#include +#include + +#include + +//using namespace pigpio; + +struct pigI2C; + +namespace pigpio +{ + + class LIBPIGPIO_EXPORT pigCore + { + + public: + + /* + - sigX einheitlich, geht das + - stack für sensoren + - threaded sensors / actors? + - timer flicken + */ + + virtual int init( const std::string& host ="" , const std::string& port="" ) = 0; + + // pin config + virtual int set_io_mode( bcm_t bcm, io_t mode ) = 0; + virtual int get_io_mode( bcm_t bcm ) = 0; + virtual int set_pud_mode( bcm_t bcm, pud_t pud ) = 0; + virtual int set_glitch_filter( bcm_t bcm, uint32_t glitch = GlitchDef ) = 0; + virtual int set_noise_filter( bcm_t bcm, uint32_t steady, uint32_t active ) = 0; + + // pin operations + virtual int get_level( bcm_t bcm ) = 0; + virtual int set_level( bcm_t bcm, level_t level ) = 0; + virtual int trigger_level( bcm_t bcm, level_t level, uint32_t pulseLen ) = 0; + virtual int wait_for_edge( bcm_t bcm, edge_t edge, double timeout = TimeoutDef ) = 0; + + // reality interface + virtual int set_callback( bcm_t bcm, pigCall* user, edge_t edge = either ) = 0; + virtual int cancel_callback( int cbId ) = 0; + + // software PWM + /* + set_PWM_dutycycle Start/stop PWM pulses on a GPIO + set_PWM_frequency Configure PWM frequency for a GPIO + set_PWM_range Configure PWM range for a GPIO + get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + get_PWM_frequency Get configured PWM frequency for a GPIO + get_PWM_range Get configured PWM range for a GPIO + get_PWM_real_range Get underlying PWM range for a GPIO + */ + + + // i2c + virtual int i2c_open( pigI2C& i2c ) = 0; + virtual int i2c_close( pigI2C& i2c ) = 0; +/* + virtual int i2c_write_quick( pigI2C& i2c, unsigned bit ) = 0; + virtual int i2c_write_byte( pigI2C& i2c, unsigned bVal ) = 0; + virtual int i2c_write_byte_data( pigI2C& i2c, unsigned reg, unsigned val ) = 0; + virtual int i2c_write_word_data( pigI2C& i2c, unsigned reg, unsigned val ) = 0; + virtual int i2c_write_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) = 0; + virtual int i2c_write_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) = 0; + */ + virtual int i2c_write_device( pigI2C& i2c, char* buf, unsigned count ) = 0; +/* + virtual int i2c_read_byte( pigI2C& i2c ) = 0; + virtual int i2c_read_byte_data( pigI2C& i2c, unsigned reg ) = 0; + virtual int i2c_read_word_data( pigI2C& i2c, unsigned reg ) = 0; + virtual int i2c_read_block_data( pigI2C& i2c, unsigned reg, char* buf ) = 0; + virtual int i2c_read_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) = 0; + virtual int i2c_read_device( pigI2C& i2c, char* buf, unsigned count ) = 0; + + virtual int i2c_process_call( pigI2C& i2c, unsigned i2c_reg, unsigned wVal) = 0; + virtual int i2c_block_process_call( pigI2C& i2c, unsigned i2c_reg, char* buf, unsigned count ) = 0; + virtual int i2c_zip( pigI2C& i2c, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen ) = 0; + */ + + // advanced + virtual int hardware_PWM( bcm_t bcm, uint32_t PWMfreq, uint32_t PWMduty ) = 0; + virtual int hardware_clock( bcm_t bcm, uint32_t clkfreq ) = 0; + virtual uint32_t get_current_tick() = 0; + + // info + virtual int get_hardware_revision() = 0; + virtual int get_pigpio_version() = 0; + virtual unsigned pigpiod_if_version() = 0; + + virtual int show_error( int errNo ) = 0; + + + protected: + + int _Pi; + + }; // class pigCore + +} // namespace pigpio + + +#endif // LIBPIGCORE_H + + + + diff --git a/libpiglinux.cpp b/libpiglinux.cpp new file mode 100644 index 0000000..2bbf871 --- /dev/null +++ b/libpiglinux.cpp @@ -0,0 +1,407 @@ + +#if defined(unix) || defined(__unix__) || defined(__unix) + +#include + +#include +#include + +#include +#include + +using namespace pigpio; + + +pigLinux::pigLinux() noexcept +{ + //::gpioInitialise(); + /// Connect to Pi. + constexpr char* optHost = nullptr; + constexpr char* optPort = nullptr; + _Pi = ::pigpio_start( optHost, optPort ); + if( _Pi < 0 ) + std::cout << "-- pigLinux(): FAIL" << std::endl; +} + + +pigLinux::~pigLinux() +{ + //::gpioTerminate(); + ::pigpio_stop( _Pi ); +} + +int pigLinux::init( const std::string& host, const std::string& port ) +{ + //::gpioInitialise(); + /// Connect to Pi. + _Pi = ::pigpio_start( host.c_str(), port.c_str() ); + if( _Pi < 0 ) + std::cout << "-- pigLinux(): FAIL" << std::endl; + return _Pi; +} + + +/// +/// pin config +/// + +int pigLinux::set_io_mode( bcm_t bcm, io_t mode ) +{ + int result = ::set_mode( _Pi, (unsigned) bcm, (unsigned) mode ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::get_io_mode( bcm_t bcm ) +{ + int result = ::get_mode( _Pi, (unsigned) bcm ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::set_pud_mode( bcm_t bcm, pud_t pud ) +{ + int result = ::set_pull_up_down( _Pi, (unsigned) bcm, (unsigned) pud ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::set_glitch_filter( bcm_t bcm , uint32_t glitch ) +{ + int result = ::set_glitch_filter( _Pi, (unsigned) bcm, glitch ); + if( result < 0 ) + return show_error( result ); + return result; +} + +//Sets a noise filter on a GPIO. +int pigLinux::set_noise_filter( bcm_t bcm , unsigned steady, unsigned active ) +{ + + int result = ::set_noise_filter( _Pi, (unsigned) bcm, steady, active ); + if( result < 0 ) + return show_error( result ); + return result; + + +} + + +/// +/// pin operations +/// + +int pigLinux::get_level( bcm_t bcm ) +{ + return ::gpio_read( _Pi, (unsigned) bcm ); +} + + +int pigLinux::set_level( bcm_t bcm , level_t level ) +{ + int result = ::gpio_write( _Pi, (unsigned) bcm, level ); ; + if( result < 0 ) + return show_error( result ); + return result; + +} + +//This function sends a trigger pulse to a GPIO. The GPIO is set to level for pulseLen microseconds and then reset to not level. +int pigLinux::trigger_level( bcm_t bcm , level_t level, uint32_t pulseLen ) +{ + //int trigger_level(int pi, unsigned user_gpio, unsigned pulseLen, unsigned level) + int result = ::gpio_trigger( _Pi, (unsigned) bcm, pulseLen, level ); ; + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::wait_for_edge( bcm_t bcm , edge_t edge, double tout ) +{ + //std::cout << " --pigLinux::wait_for_edge: " << (uint32_t) bcm << " : " << (uint32_t) edge << std::endl; + + int result = ::wait_for_edge( _Pi, (unsigned) bcm, (unsigned) edge, tout ); + if( result < 0 ) + return show_error( result ); + return result; + +} + + +int pigLinux::set_callback( bcm_t bcm, pigCall* fn, edge_t edge ) +{ + //std::cout << " --pigLinux::set_callback: " << (uint32_t) bcm << " : " << (uint32_t) edge << std::endl; + + /// typedef int (*CBFuncEx_t)(int pi, unsigned user_gpio, unsigned level, uint32_t tick, int * userdata ); + ///int callback_ex(int pi, unsigned user_gpio, unsigned edge, CBFuncEx_t f, int *userdata) + //int result = cbId = ::callback_ex( _Pi, (unsigned) bcm, (unsigned) edge, trigger, widget ); + //int result = ::callback_ex( _Pi, (unsigned) bcm, (unsigned) edge, trigger, widget ); + + int result = ::callback_ex( _Pi, (unsigned) bcm, (unsigned) edge, trigger, fn ); + if( result < 0 ) + return show_error( result ); + + return result; + +} + + +int pigLinux::cancel_callback( int cbId ) +{ + int result = ::callback_cancel( cbId ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +/// +/// ic2 +/// + +int pigLinux::i2c_open( pigI2C& i2c ) +{ + int result = i2c.handle = ::i2c_open( _Pi, i2c.bus, i2c.addr, 0 ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::i2c_close( pigI2C& i2c ) +{ + int result = ::i2c_close( _Pi, i2c.handle ); + if( result < 0 ) + return show_error( result ); + return result; +} + +/* +int pigLinux::i2c_write_quick( pigI2C& i2c, unsigned bit ) +{ + int result = ::i2c_write_quick( _Pi, i2c.handle, bit ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_write_byte( pigI2C& i2c, unsigned bVal ) +{ + int result = ::i2c_write_byte( _Pi, i2c.handle, bVal ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_write_byte_data( pigI2C& i2c, unsigned reg, unsigned val ) +{ + int result = ::i2c_write_byte_data( _Pi, i2c.handle, reg, val ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_write_word_data( pigI2C& i2c, unsigned reg, unsigned val ) +{ + int result = ::i2c_write_word_data( _Pi, i2c.handle, reg, val ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_write_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) +{ + int result = ::i2c_write_block_data( _Pi, i2c.handle, reg, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_write_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) +{ + int result = ::i2c_write_i2c_block_data( _Pi, i2c.handle, reg, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + +*/ + +int pigLinux::i2c_write_device( pigI2C& i2c, char* buf, unsigned count ) +{ + int result = ::i2c_write_device( _Pi, i2c.handle, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + +/* +int pigLinux::i2c_read_byte( pigI2C& i2c ) +{ + int result = ::i2c_read_byte( _Pi, i2c.handle ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_read_byte_data( pigI2C& i2c, unsigned reg ) +{ + int result = ::i2c_read_byte_data( _Pi, i2c.handle, reg ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_read_word_data( pigI2C& i2c, unsigned reg ) +{ + int result = ::i2c_read_word_data( _Pi, i2c.handle, reg ); + if( result < 0 ) + return show_error( result ); + return result; +} + + + +int pigLinux::i2c_read_block_data( pigI2C& i2c, unsigned reg, char* buf ) +{ + int result = ::i2c_read_block_data( _Pi, i2c.handle, reg, buf ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_read_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) +{ + int result = ::i2c_read_i2c_block_data( _Pi, i2c.handle, reg, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::i2c_read_device( pigI2C& i2c, char* buf, unsigned count ) +{ + int result = ::i2c_read_device( _Pi, i2c.handle, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + +int pigLinux::i2c_process_call( pigI2C& i2c, unsigned reg, unsigned wVal ) +{ + int result = ::i2c_process_call( _Pi, i2c.handle, reg, wVal ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::i2c_block_process_call( pigI2C& i2c,unsigned reg, char* buf, unsigned count ) +{ + int result = ::i2c_block_process_call( _Pi, i2c.handle, reg, buf, count ); + if( result < 0 ) + return show_error( result ); + return result; +} + + +int pigLinux::i2c_zip( pigI2C& i2c, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen ) +{ + int result = ::i2c_zip( _Pi, i2c.handle, inBuf, inLen, outBuf, outLen ); + if( result < 0 ) + return show_error( result ); + return result; +} +*/ + + +/// +/// advanced +/// + +//Starts hardware PWM on a GPIO at the specified frequency and dutycycle. Frequencies above 30MHz are unlikely to work. + +int pigLinux::hardware_PWM( bcm_t bcm , unsigned PWMfreq, uint32_t PWMduty ) +{ + //int hardware_PWM(int pi, unsigned gpio, unsigned PWMfreq, uint32_t PWMduty) + int result = ::hardware_PWM( _Pi, (unsigned) bcm, PWMfreq, PWMduty ); + if( result < 0 ) + return show_error( result ); + return result; +} + +//Starts a hardware clock on a GPIO at the specified frequency. Frequencies above 30MHz are unlikely to work. + +int pigLinux::hardware_clock( bcm_t bcm , unsigned clkfreq ) +{ + //int hardware_clock(int pi, unsigned gpio, unsigned clkfreq) + int result = ::hardware_clock( _Pi, (unsigned) bcm, clkfreq ); + if( result < 0 ) + return show_error( result ); + return result; + +} + +uint32_t pigLinux::get_current_tick() +{ + //int hardware_clock(int pi, unsigned gpio, unsigned clkfreq) + return ::get_current_tick( _Pi ); +} + + +/// +/// convenience +/// + + +int pigLinux::show_error( int error ) +{ + + std::cout << "Error: " << ::pigpio_error( error ) << std::endl; + return error; +} + + + +/// --- + +//Get the Pi's hardware revision number. + +int pigLinux::get_hardware_revision() +{ + int result = ::get_hardware_revision( _Pi ); + if( result < 0 ) + return show_error( result ); + return result; + +} + +//Returns the pigpio version. + +int pigLinux::get_pigpio_version() +{ + int result = ::get_pigpio_version( _Pi ); + if( result < 0 ) + return show_error( result ); + return result; + +} + +//Return the pigpiod_if2 version. + +unsigned pigLinux::pigpiod_if_version() +{ + //unsigned pigpiod_if_version(void) + int result = ::pigpiod_if_version(); + if( result < 0 ) + return show_error( result ); + return result; +} + +#endif + diff --git a/libpiglinux.h b/libpiglinux.h new file mode 100644 index 0000000..85f2979 --- /dev/null +++ b/libpiglinux.h @@ -0,0 +1,126 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2.h + by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot.h + by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef LIBPIGLINUX_H +#define LIBPIGLINUX_H + +#if defined(unix) || defined(__unix__) || defined(__unix) + +#include +#include + +namespace pigpio +{ + class LIBPIGPIO_EXPORT pigLinux : public pigCore + { + + friend pigCore& get_instance(); + + public: + + pigLinux( const pigLinux& ) = delete; + void operator=( const pigLinux& ) = delete; + + virtual ~pigLinux(); + + int init( const std::string& host ="", const std::string& port="" ) override; + + // pin config + int set_io_mode( bcm_t bcm, io_t mode ) override; + int get_io_mode( bcm_t bcm ) override; + int set_pud_mode( bcm_t bcm, pud_t pud ) override; + int set_glitch_filter( bcm_t bcm, uint32_t glitch = GlitchDef ) override; + int set_noise_filter( bcm_t bcm, uint32_t steady, uint32_t active ) override; + + // pin operations + int get_level( bcm_t bcm ) override; + int set_level( bcm_t bcm, level_t level ) override; + int wait_for_edge( bcm_t bcm, edge_t edge, double timeout = TimeoutDef ) override; + int trigger_level( bcm_t bcm, level_t level, uint32_t pulseLen ) override; + + // interface + int set_callback( bcm_t bcm, pigCall* user, edge_t edge = either ) override; + int cancel_callback( int cbId ) override; + + // software PWM + /* + set_PWM_dutycycle Start/stop PWM pulses on a GPIO + set_PWM_frequency Configure PWM frequency for a GPIO + set_PWM_range Configure PWM range for a GPIO + get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + get_PWM_frequency Get configured PWM frequency for a GPIO + get_PWM_range Get configured PWM range for a GPIO + get_PWM_real_range Get underlying PWM range for a GPIO + */ + + + // i2c + int i2c_open( pigI2C& i2c ) override; + int i2c_close( pigI2C& i2c ) override; + /* + int i2c_write_quick( pigI2C& i2c, unsigned bit ) override; + int i2c_write_byte( pigI2C& i2c, unsigned bVal ) override; + int i2c_write_byte_data( pigI2C& i2c, unsigned reg, unsigned val ) override; + int i2c_write_word_data( pigI2C& i2c, unsigned reg, unsigned val ) override; + int i2c_write_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + int i2c_write_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + */ + + int i2c_write_device( pigI2C& i2c, char* buf, unsigned count ) override; +/* + int i2c_read_byte( pigI2C& i2c ) override; + int i2c_read_byte_data( pigI2C& i2c, unsigned reg ) override; + int i2c_read_word_data( pigI2C& i2c, unsigned reg ) override; + int i2c_read_block_data( pigI2C& i2c, unsigned reg, char* buf ) override; + int i2c_read_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + int i2c_read_device( pigI2C& i2c, char* buf, unsigned count ) override; + + int i2c_process_call( pigI2C& i2c, unsigned i2c_reg, unsigned wVal ) override; + int i2c_block_process_call( pigI2C& i2c,unsigned i2c_reg, char* buf, unsigned count ) override; + int i2c_zip( pigI2C& i2c, char* inBuf, unsigned inLen, char* outBuf, unsigned outLen ) override; + */ + + // advanced + int hardware_PWM( bcm_t bcm, uint32_t PWMfreq, uint32_t PWMduty ) override; + int hardware_clock( bcm_t bcm, uint32_t clkfreq ) override; + uint32_t get_current_tick() override; + + // info + int get_hardware_revision() override; + int get_pigpio_version() override; + unsigned pigpiod_if_version() override; + + int show_error( int errNo ) override; + + private: + + pigLinux() noexcept; + + }; + +} // namepace + +#endif // def linux + +#endif // LIBPIGLINUX_H diff --git a/libpigpio.cpp b/libpigpio.cpp new file mode 100644 index 0000000..b83c28f --- /dev/null +++ b/libpigpio.cpp @@ -0,0 +1,310 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2.h + by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot.h + by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include +#include + +#include +#include + + +namespace pigpio +{ + + pigCore& get_instance() + { + #if defined(unix) || defined(__unix__) || defined(__unix) + static pigLinux _Instance; // guaranteed to be destroyed. + #endif //Q_OS_LINUX + #ifdef _WIN32 + static pigWindows _Instance; //guaranteed to be destroyed. + #endif // _WIN32 + return _Instance; + } + + // bcm config + int set_io_mode( bcm_t bcm, io_t mode ) + { + return get_instance().set_io_mode( bcm, mode ); + } + + + int get_io_mode( bcm_t bcm ) + { + return get_instance().get_io_mode( bcm ); + } + + + int set_pud_mode( bcm_t bcm, pud_t pud ) + { + return get_instance().set_pud_mode( bcm, pud ); + } + + + int set_glitch_filter(bcm_t bcm, uint32_t glitch ) + { + return get_instance().set_glitch_filter( bcm, glitch ); + } + + + int set_noise_filter(bcm_t bcm, unsigned steady, unsigned active ) + { + return get_instance().set_noise_filter( bcm, steady, active ); + } + + + // bcm operations + int get_level( bcm_t bcm ) + { + return get_instance().get_level( bcm ); + } + + + int set_level( bcm_t bcm , level_t level ) + { + return get_instance().set_level( bcm, level ); + } + + + int trigger_level( bcm_t bcm, level_t level, uint32_t pulseLen ) + { + return get_instance().trigger_level( bcm, pulseLen, level ); + } + + + int wait_for_edge( bcm_t bcm, edge_t edge, double timeout ) + { + return get_instance().wait_for_edge( bcm, edge, timeout ); + } + + // reality interface + int set_callback( bcm_t bcm, pigCall* fn, edge_t edge ) + { + return get_instance().set_callback( bcm, fn, edge ); + } + + + int cancel_callback( int cbId ) + { + return get_instance().cancel_callback( cbId ); + } + + + // software PWM + /* + set_PWM_dutycycle Start/stop PWM pulses on a GPIO + set_PWM_frequency Configure PWM frequency for a GPIO + set_PWM_range Configure PWM range for a GPIO + get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + get_PWM_frequency Get configured PWM frequency for a GPIO + get_PWM_range Get configured PWM range for a GPIO + get_PWM_real_range Get underlying PWM range for a GPIO + */ + + + // i2c + int i2c_open( pigI2C& i2c ) + { + return get_instance().i2c_open( i2c ); + } + + int i2c_close( pigI2C& i2c ) + { + return get_instance().i2c_close( i2c ); + } + + /* + + int i2c_write_quick( pigI2C& i2c, unsigned bit ) + { + return get_instance(). + } + + int i2c_write_byte( pigI2C& i2c, unsigned bVal ) + { + return get_instance(). + } + + int i2c_write_byte_data( pigI2C& i2c, unsigned reg, unsigned val ) + { + return get_instance(). + } + + int i2c_write_word_data( pigI2C& i2c, unsigned reg, unsigned val ) + { + return get_instance(). + } + + int i2c_write_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) + { + return get_instance(). + } + + int i2c_write_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) + { + return get_instance(). + } +*/ + int i2c_write_device( pigI2C& i2c, char* buf, unsigned count ) + { + return get_instance().i2c_write_device( i2c, buf, count ); + } + +/* + + int i2c_read_byte( pigI2C& i2c ) + { + return get_instance(). + } + + int i2c_read_byte_data( pigI2C& i2c, unsigned reg ) + { + return get_instance(). + } + + int i2c_read_word_data( pigI2C& i2c, unsigned reg ) + { + return get_instance(). + } + + int i2c_read_block_data( pigI2C& i2c, unsigned reg, char* buf ) + { + return get_instance(). + } + + int i2c_read_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) + { + return get_instance(). + } + + int i2c_read_device( pigI2C& i2c, char* buf, unsigned count ) + { + return get_instance(). + } + + + int i2c_process_call( pigI2C& i2c, unsigned i2c_reg, unsigned wVal) + { + return get_instance(). + } + + int i2c_block_process_call( pigI2C& i2c, unsigned i2c_reg, char* buf, unsigned count ) + { + get_instance().i2c_block_process_call(); + } + + int i2c_zip( pigI2C& i2c, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen ) + { + get_instance().i2c_zip( i2c, inBuf, inLen, outBuf, outLen ); + } + */ + + // advanced + int hardware_PWM( bcm_t bcm, unsigned PWMfreq, uint32_t PWMduty ) + { + return get_instance().hardware_PWM( bcm, PWMfreq, PWMduty ); + } + + + int hardware_clock( bcm_t bcm, unsigned clkfreq ) + { + return get_instance().hardware_clock( bcm, clkfreq ); + } + + uint32_t get_current_tick() + { + return get_instance().get_current_tick(); + } + + void show_error( const std::string& msg ) + { + std::cout << "error: " << msg << std::endl; + } + + + void show_hint( const std::string& msg ) + { + std::cout << "hint: " << msg << std::endl; + } + + + /// + /// timers + /// + + void delay_seconds( uint32_t tval ) + { + std::this_thread::sleep_for(std::chrono::seconds( tval ) ); + } + + + void delay_millis( uint32_t tval ) + { + std::this_thread::sleep_for(std::chrono::milliseconds( tval ) ); + } + + + void delay_micros( uint32_t tval ) + { + std::this_thread::sleep_for(std::chrono::microseconds( tval ) ); + } + + + void wait_loop() + { + while( true ) + delay_seconds( 10 ); + } + + + // void trigger( int pi, unsigned gpio, unsigned level, uint32_t tick, void *user ) + void trigger( int, unsigned bcm, unsigned level, uint32_t, void *user ) + { + /// Need a static callback to link with C. + pigCall* receiver = static_cast( user ); + if( receiver ) + receiver->trigger( (bcm_t) bcm, level ); /// Call the get_instance callback. + else + std::cout << "-- ONPULSE FAIL" << (uint32_t) bcm << std::endl; + } + + + void greet() + { + std::cout << "lib:\t" << pigpio::Version << std::endl; + std::cout << "gpio:\t" << get_instance().get_pigpio_version() << std::endl; + std::cout << "hw rev:\t" << get_instance().get_hardware_revision() << std::endl; + std::cout << "deamon:\t" << get_instance().pigpiod_if_version() << std::endl; + std::cout << "\n" << std::endl; + } + + + int show_error( int error ) + { + return error; + } + + +} // namespace pigpio diff --git a/libpigpio.h b/libpigpio.h new file mode 100644 index 0000000..fede9f2 --- /dev/null +++ b/libpigpio.h @@ -0,0 +1,373 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2.h + by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot.h + by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef LIBPIGPIO_H +#define LIBPIGPIO_H + +#if defined(_MSC_VER) || defined(WIN64) || defined(_WIN64) || defined(__WIN64__) || defined(WIN32) || defined(_WIN32) || defined(__WIN32__) || defined(__NT__) +# define Q_DECL_EXPORT __declspec(dllexport) +# define Q_DECL_IMPORT __declspec(dllimport) +#else +# define Q_DECL_EXPORT __attribute__((visibility("default"))) +# define Q_DECL_IMPORT __attribute__((visibility("default"))) +#endif + +#if defined(LIBPIGPIO_LIBRARY) +# define LIBPIGPIO_EXPORT Q_DECL_EXPORT +#else +# define LIBPIGPIO_EXPORT Q_DECL_IMPORT +#endif + +#include +#include +#include +#include +#include + +#include +#include +#include +#include + +struct pigI2C; +class pigCall; + + +namespace pigpio +{ + + class pigCore; + + [[maybe_unused]] const int GlitchDef = 500; + [[maybe_unused]] const double TimeoutDef = 0.2; + + enum class edge_t : uint32_t + { + rising = 0, + falling = 1, + either = 2, + edge_off = 99 + }; + + enum class io_t : uint32_t + { + input = 0, + output = 1, + io_off = 99 + }; + + enum class bcm_t : uint32_t + { + /// left side, pin 1,3 ... 39 + + bcm02 = 2, + bcm03 = 3, + bcm04 = 4, + + bcm17 = 17, + bcm27 = 27, + bcm22 = 22, + + bcm10 = 10, + bcm09 = 9, + bcm11 = 11, + + bcm05 = 5, + bcm06 = 6, + bcm13 = 7, + + bcm19 = 19, + bcm26 = 9, + + /// right side, pin 2,4 .. 40 + + bcm14 = 14, + bcm15 = 15, + bcm18 = 18, + + bcm23 = 23, + bcm24 = 24, + + bcm25 = 25, + bcm08 = 8, + bcm07 = 07, + + bcm12 = 12, + + bcm16 = 16, + bcm20 = 20, + bcm21 = 21, + + bcm_off = 99 + + }; + + enum class pud_t : uint32_t + { + pull_off = 0, + pull_down = 1, + pull_up = 2, + }; + + + using level_t = uint32_t; + + /// + /// i2c + /// + + using i2c_bus_t = uint32_t; // uint8_t ?? + using i2c_addr_t = uint32_t; + using i2c_flag_t = uint32_t; + + /// sugar + [[maybe_unused]] constexpr static edge_t rising = edge_t::rising; + [[maybe_unused]] constexpr static edge_t falling = edge_t::falling; + [[maybe_unused]] constexpr static edge_t either = edge_t::either; + + ///--- + + [[maybe_unused]] constexpr static io_t input = io_t::input; + [[maybe_unused]] constexpr static io_t output = io_t::output; + + ///--- + + [[maybe_unused]] constexpr static pud_t pull_off = pud_t::pull_off; + [[maybe_unused]] constexpr static pud_t pull_down = pud_t::pull_down; + [[maybe_unused]] constexpr static pud_t pull_up = pud_t::pull_up; + + ///--- + + /// left side, pin 1,3 ... 39 + [[maybe_unused]] constexpr static bcm_t bcm02 = bcm_t::bcm02; + [[maybe_unused]] constexpr static bcm_t bcm03 = bcm_t::bcm03; + [[maybe_unused]] constexpr static bcm_t bcm04 = bcm_t::bcm04; + + [[maybe_unused]] constexpr static bcm_t bcm17 = bcm_t::bcm17; + [[maybe_unused]] constexpr static bcm_t bcm27 = bcm_t::bcm27; + [[maybe_unused]] constexpr static bcm_t bcm22 = bcm_t::bcm22; + + [[maybe_unused]] constexpr static bcm_t bcm10 = bcm_t::bcm10; + [[maybe_unused]] constexpr static bcm_t bcm09 = bcm_t::bcm09; + [[maybe_unused]] constexpr static bcm_t bcm11 = bcm_t::bcm11; + + [[maybe_unused]] constexpr static bcm_t bcm05 = bcm_t::bcm05; + [[maybe_unused]] constexpr static bcm_t bcm06 = bcm_t::bcm06; + [[maybe_unused]] constexpr static bcm_t bcm13 = bcm_t::bcm07; + + [[maybe_unused]] constexpr static bcm_t bcm19 = bcm_t::bcm19; + [[maybe_unused]] constexpr static bcm_t bcm26 = bcm_t::bcm09; + + /// right side, pin 2,4 .. 40 + [[maybe_unused]] constexpr static bcm_t bcm14 = bcm_t::bcm04; + [[maybe_unused]] constexpr static bcm_t bcm15 = bcm_t::bcm15; + [[maybe_unused]] constexpr static bcm_t bcm18 = bcm_t::bcm18; + + [[maybe_unused]] constexpr static bcm_t bcm23 = bcm_t::bcm23; + [[maybe_unused]] constexpr static bcm_t bcm24 = bcm_t::bcm24; + + [[maybe_unused]] constexpr static bcm_t bcm25 = bcm_t::bcm25; + [[maybe_unused]] constexpr static bcm_t bcm08 = bcm_t::bcm08; + [[maybe_unused]] constexpr static bcm_t bcm07 = bcm_t::bcm07; + + [[maybe_unused]] constexpr static bcm_t bcm12 = bcm_t::bcm12; + + [[maybe_unused]] constexpr static bcm_t bcm16 = bcm_t::bcm16; + [[maybe_unused]] constexpr static bcm_t bcm20 = bcm_t::bcm20; + [[maybe_unused]] constexpr static bcm_t bcm21 = bcm_t::bcm21; + + /// more sugar + + /// left side, pin 1,3 ... 39 + [[maybe_unused]] constexpr static bcm_t pin03 = bcm_t::bcm02; + [[maybe_unused]] constexpr static bcm_t pin05 = bcm_t::bcm03; + [[maybe_unused]] constexpr static bcm_t pin07 = bcm_t::bcm04; + + [[maybe_unused]] constexpr static bcm_t pin11 = bcm_t::bcm17; + [[maybe_unused]] constexpr static bcm_t pin13 = bcm_t::bcm27; + [[maybe_unused]] constexpr static bcm_t pin15 = bcm_t::bcm22; + + [[maybe_unused]] constexpr static bcm_t pin19 = bcm_t::bcm10; + [[maybe_unused]] constexpr static bcm_t pin21 = bcm_t::bcm09; + [[maybe_unused]] constexpr static bcm_t pin23 = bcm_t::bcm11; + + [[maybe_unused]] constexpr static bcm_t pin29 = bcm_t::bcm05; + [[maybe_unused]] constexpr static bcm_t pin31 = bcm_t::bcm06; + [[maybe_unused]] constexpr static bcm_t pin33 = bcm_t::bcm13; + + [[maybe_unused]] constexpr static bcm_t pin35 = bcm_t::bcm19; + [[maybe_unused]] constexpr static bcm_t pin37 = bcm_t::bcm26; + + /// right side, pin 2,4 .. 40 + [[maybe_unused]] constexpr static bcm_t pin08 = bcm_t::bcm14; + [[maybe_unused]] constexpr static bcm_t pin10 = bcm_t::bcm15; + [[maybe_unused]] constexpr static bcm_t pin12 = bcm_t::bcm18; + + [[maybe_unused]] constexpr static bcm_t pin16 = bcm_t::bcm23; + [[maybe_unused]] constexpr static bcm_t pin18 = bcm_t::bcm24; + + [[maybe_unused]] constexpr static bcm_t pin22 = bcm_t::bcm25; + [[maybe_unused]] constexpr static bcm_t pin24 = bcm_t::bcm08; + [[maybe_unused]] constexpr static bcm_t pin26 = bcm_t::bcm07; + + [[maybe_unused]] constexpr static bcm_t pin32 = bcm_t::bcm12; + + [[maybe_unused]] constexpr static bcm_t pin36 = bcm_t::bcm16; + [[maybe_unused]] constexpr static bcm_t pin38 = bcm_t::bcm20; + [[maybe_unused]] constexpr static bcm_t pin40 = bcm_t::bcm21; + + /* + + GPIO pin pin GPIO + 3V3 1 2 5V + 2 (SDA) 3 4 5V + 3 (SCL) 5 6 0V + 4 7 8 14 (TXD) + 0V 9 10 15 (RXD) + 17 (ce1) 11 12 18 (ce0) + 27 13 14 0V + 22 15 16 23 + 3V3 17 18 24 + 10 (MOSI) 19 20 0V + 9 (MISO) 21 22 25 + 11 (SCLK) 23 24 8 (CE0) + 0V 25 26 7 (CE1) + ....... + 0 (ID_SD) 27 28 1 (ID_SC) + 5 29 30 0V + 6 31 32 12 + 13 33 34 0V + 19 (miso) 35 36 16 (ce2) + 26 37 38 20 (mosi) + 0V 39 40 21 (sclk) + + + */ + + // fragwürdig + [[maybe_unused]] constexpr static level_t low = 0; + [[maybe_unused]] constexpr static level_t high = 1; + + [[maybe_unused]] constexpr static level_t off = 0; + [[maybe_unused]] constexpr static level_t on = 1; + + + //map -> pin + // op< + + [[maybe_unused]] constexpr static uint32_t TimeOut = 2; + [[maybe_unused]] constexpr static const char* Version = "libPiGPIO 0.1.27 / 16.09.2022 2022 chris@sourceworx.org"; + + + LIBPIGPIO_EXPORT pigCore& get_instance(); + + LIBPIGPIO_EXPORT int init( const std::string& host ="" , const std::string& port="" ); + + // pin config + LIBPIGPIO_EXPORT int get_io_mode( bcm_t bcm ); + LIBPIGPIO_EXPORT int set_io_mode( bcm_t bcm, io_t mode ); + LIBPIGPIO_EXPORT int set_pud_mode( bcm_t bcm, pud_t pud ); + LIBPIGPIO_EXPORT int set_glitch_filter( bcm_t bcm, uint32_t glitch = GlitchDef ); + LIBPIGPIO_EXPORT int set_noise_filter( bcm_t bcm, uint32_t steady, uint32_t active ) ; + + // pin operations + LIBPIGPIO_EXPORT int get_level( bcm_t bcm ); + LIBPIGPIO_EXPORT int set_level( bcm_t bcm, level_t level ) ; + LIBPIGPIO_EXPORT int trigger_level( bcm_t bcm, level_t level, uint32_t pulseLen ); + LIBPIGPIO_EXPORT int wait_for_edge( bcm_t bcm, edge_t edge, double timeout = TimeoutDef ); + + // reality interface + LIBPIGPIO_EXPORT int set_callback( bcm_t bcm, pigCall* fn, edge_t edge ); + LIBPIGPIO_EXPORT int cancel_callback( int cbId ); + + // software PWM + /* + set_PWM_dutycycle Start/stop PWM pulses on a GPIO + set_PWM_frequency Configure PWM frequency for a GPIO + set_PWM_range Configure PWM range for a GPIO + get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + get_PWM_frequency Get configured PWM frequency for a GPIO + get_PWM_range Get configured PWM range for a GPIO + get_PWM_real_range Get underlying PWM range for a GPIO + */ + + // i2c + LIBPIGPIO_EXPORT int i2c_open( pigI2C& i2c ); + LIBPIGPIO_EXPORT int i2c_close( pigI2C& i2c ); + /* + LIBPIGPIO_EXPORT int i2c_write_quick( pigI2C& i2c, uint32_t bit ); + LIBPIGPIO_EXPORT int i2c_write_byte( pigI2C& i2c, uint32_t bVal ); + LIBPIGPIO_EXPORT int i2c_write_byte_data( pigI2C& i2c, uint32_t reg, uint32_t val ); + LIBPIGPIO_EXPORT int i2c_write_word_data( pigI2C& i2c, uint32_t reg, uint32_t val ); + LIBPIGPIO_EXPORT int i2c_write_block_data( pigI2C& i2c, uint32_t reg, char* buf, uint32_t count ); + LIBPIGPIO_EXPORT int i2c_write_i2c_block_data( pigI2C& i2c, uint32_t reg, char* buf, uint32_t count ); + */ + LIBPIGPIO_EXPORT int i2c_write_device( pigI2C& i2c, char* buf, uint32_t count ); + /* + LIBPIGPIO_EXPORT int i2c_read_byte( pigI2C& i2c ); + LIBPIGPIO_EXPORT int i2c_read_byte_data( pigI2C& i2c, uint32_t reg ); + LIBPIGPIO_EXPORT int i2c_read_word_data( pigI2C& i2c, uint32_t reg ); + LIBPIGPIO_EXPORT int i2c_read_block_data( pigI2C& i2c, uint32_t reg, char* buf ); + LIBPIGPIO_EXPORT int i2c_read_i2c_block_data( pigI2C& i2c, uint32_t reg, char* buf, uint32_t count ); + LIBPIGPIO_EXPORT int i2c_read_device( pigI2C& i2c, char* buf, uint32_t count ); + + LIBPIGPIO_EXPORT int i2c_process_call( pigI2C& i2c, uint32_t i2c_reg, uint32_t wVal); + LIBPIGPIO_EXPORT int i2c_block_process_call( pigI2C& i2c, uint32_t i2c_reg, char* buf, uint32_t count ); + LIBPIGPIO_EXPORT int i2c_zip( pigI2C& i2c, char *inBuf, uint32_t inLen, char *outBuf, uint32_t outLen ); + */ + + // advanced + LIBPIGPIO_EXPORT int hardware_PWM( bcm_t bcm, uint32_t PWMfreq, uint32_t PWMduty ) ; + LIBPIGPIO_EXPORT int hardware_clock( bcm_t bcm, uint32_t clkfreq ); + LIBPIGPIO_EXPORT uint32_t get_current_tick(); + + // finally + //LIBPIGPIO_EXPORT void trigger( int pi, bcm_t pin, level_t level, uint32_t tick, void *user ); + LIBPIGPIO_EXPORT void trigger( int pi, unsigned bcm, unsigned level, uint32_t tick, void *user ); + LIBPIGPIO_EXPORT void greet(); + LIBPIGPIO_EXPORT void wait_loop(); + + // timer + LIBPIGPIO_EXPORT void delay_seconds( uint32_t ); + LIBPIGPIO_EXPORT void delay_millis( uint32_t ); + LIBPIGPIO_EXPORT void delay_micros( uint32_t ); + + // util + template< typename T > + LIBPIGPIO_EXPORT std::string val2str( T value, int fixed=2 ) + { + std::ostringstream sout; + sout << std::fixed << std::setprecision( fixed ); + sout << value; + return sout.str(); + } + +} // namespace + +using signalBool = sigslot::signal; +using signalInt = sigslot::signal; +using signalFloat = sigslot::signal; + + +#endif // LIBPIGPIO_H diff --git a/libpigwindows.cpp b/libpigwindows.cpp new file mode 100644 index 0000000..46623cf --- /dev/null +++ b/libpigwindows.cpp @@ -0,0 +1,301 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2.h + by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot.h + by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + + + +/// --- + +#ifdef _WIN32 + +#include + +#include + +#include +#include +#include + +namespace pigpio +{ + + +int pigWindows::init( const std::string& , const std::string& ) +{ + //::gpioInitialise(); + return 42; +} +// +// pin config +// + +int pigWindows::set_io_mode( bcm_t, io_t ) +{ + //::set_io_mode( _Pi, pin.bcm, pin.mode ); + return 0; +} + +int pigWindows::get_io_mode( bcm_t ) +{ + return 0; +} + +int pigWindows::set_pud_mode( bcm_t, pud_t ) +{ + //::set_pud_mode( _Pi, pin.bcm, pin.pud ); + return 0; +} + + +int pigWindows::set_glitch_filter( bcm_t, uint32_t ) +{ + // ::set_glitch_filter( _Pi, pin.bcm, glitch ); + return 0; +} + + +//Sets a noise filter on a GPIO. +int pigWindows::set_noise_filter( bcm_t, uint32_t, uint32_t ) +{ + //int set_noise_filter(int pi, unsigned user_gpio, unsigned steady, unsigned active) + return 0; +} + + +/// +/// pin operations +/// + +int pigWindows::get_level( bcm_t ) +{ + return 0; +} + + +int pigWindows::set_level( bcm_t, level_t ) +{ + return 0; +} + +int pigWindows::wait_for_edge( bcm_t, edge_t, double ) +{ + return 0; +} + + +//This function sends a trigger pulse to a GPIO. The GPIO is set to level for pulseLen microseconds and then reset to not level. +int pigWindows::trigger_level( bcm_t, level_t, uint32_t ) +{ + //int trigger_level(int pi, unsigned user_gpio, unsigned pulseLen, unsigned level) + return 0; +} + + +/// +/// interface +/// + +int pigWindows::set_callback( bcm_t, pigCall*, edge_t ) +{ + //::callback_ex( _Pi, pin.bcm, pin.edge, &pigNode::trigger, (void*) &widget ); + //pin.cbId = ::callback_ex( _Pi, pin.bcm, pin.edge, trigger, widget ); + return 0; +} + + +int pigWindows::cancel_callback( int ) +{ + return 0; +} + + +/// +/// ic2 +/// + + +int pigWindows::i2c_open( pigI2C& ) +{ + return 0; +} + +int pigWindows::i2c_close( pigI2C& ) +{ + return 0; +} + +/* +int pigWindows::i2c_write_quick( pigI2C&, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_write_byte( pigI2C&, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_write_byte_data( pigI2C&, unsigned, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_write_word_data( pigI2C&, unsigned, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_write_block_data( pigI2C&, unsigned, char* buf, unsigned count ) +{ + return 0; +} + +int pigWindows::i2c_write_i2c_block_data( pigI2C&, unsigned, char* buf, unsigned count ) +{ + return 0; +}*/ + + +int pigWindows::i2c_write_device( pigI2C&, char*, unsigned ) +{ + return 0; +} + +/* +int pigWindows::i2c_read_byte( pigI2C& ) +{ + return 0; +} + +int pigWindows::i2c_read_byte_data( pigI2C&, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_read_word_data( pigI2C&, unsigned ) +{ + return 0; +} + + + +int pigWindows::i2c_read_block_data( pigI2C&, unsigned, char* ) +{ + return 0; +} + +int pigWindows::i2c_read_i2c_block_data( pigI2C&, unsigned, char*, unsigned ) +{ + return 0; +} + + +int pigWindows::i2c_read_device( pigI2C&, char* buf, unsigned ) +{ + return 0; +} + +int pigWindows::i2c_process_call( pigI2C&, unsigned, unsigned ) +{ + return 0; +} + + +int pigWindows::i2c_block_process_call( pigI2C&, unsigned, char*, unsigned ) +{ + return 0; +} + + +int pigWindows::i2c_zip( pigI2C&, char*, unsigned, char*, unsigned ) +{ + return 0; +} +*/ + + +/// +/// advanced +/// + +//Starts hardware PWM on a GPIO at the specified frequency and dutycycle. Frequencies above 30MHz are unlikely to work. +int pigWindows::hardware_PWM( bcm_t, uint32_t, uint32_t ) +{ + //int hardware_PWM(int pi, unsigned gpio, unsigned PWMfreq, uint32_t PWMduty) + return 0; +} + + +/// +/// convenience +/// + + +int pigWindows::show_error( int error ) +{ + + std::cout << "Error: " << std::endl; + return error; +} + +//Starts a hardware clock on a GPIO at the specified frequency. Frequencies above 30MHz are unlikely to work. +int pigWindows::hardware_clock( bcm_t, uint32_t ) +{ + //int hardware_clock(int pi, unsigned gpio, unsigned clkfreq) + return 0; +} + +uint32_t pigWindows::get_current_tick() +{ + //int hardware_clock(int pi, unsigned gpio, unsigned clkfreq) + return 0; +} + + +//Get the Pi's hardware revision number. +int pigWindows::get_hardware_revision() +{ + //uint32_t get_hardware_revision(int pi) + return 0; +} + + +//Returns the pigpio version. +int pigWindows::get_pigpio_version() +{ + //uint32_t get_pigpio_version(int pi) + return 0; +} + + +//Return the pigpiod_if2 version. +unsigned pigWindows::pigpiod_if_version() +{ + //unsigned pigpiod_if_version(void) + return 0; +} + +} // namespace + + +#endif diff --git a/libpigwindows.h b/libpigwindows.h new file mode 100644 index 0000000..6dac4ab --- /dev/null +++ b/libpigwindows.h @@ -0,0 +1,128 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2.h + by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot.h + by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef LIBPIGWINDOWS_H +#define LIBPIGWINDOWS_H + +#include +#include + +struct pigI2C; + +namespace pigpio +{ + + class LIBPIGPIO_EXPORT pigWindows : public pigCore + { + + friend pigCore& get_instance(); + + public: + + pigWindows( const pigWindows& ) = delete; + void operator=( const pigWindows& ) = delete; + + virtual ~pigWindows() = default; + + int init( const std::string& host ="", const std::string& port="" ) override; + + // pin config + int set_io_mode( bcm_t bcm, io_t mode ) override; + int get_io_mode( bcm_t bcm ) override; + int set_pud_mode( bcm_t bcm, pud_t pud ) override; + int set_glitch_filter( bcm_t bcm, uint32_t glitch = GlitchDef ) override; + int set_noise_filter( bcm_t bcm, uint32_t steady, uint32_t active ) override; + + // pin operations + int get_level( bcm_t bcm ) override; + int set_level( bcm_t bcm, level_t level ) override; + int wait_for_edge( bcm_t bcm, edge_t edge, double timeout = 60 ) override; + int trigger_level( bcm_t bcm, level_t level, uint32_t pulseLen ) override; + + // interface + int set_callback( bcm_t bcm, pigCall* user, edge_t edge = either ) override; + int cancel_callback( int cbId ) override; + + // software PWM + /* + set_PWM_dutycycle Start/stop PWM pulses on a GPIO + set_PWM_frequency Configure PWM frequency for a GPIO + set_PWM_range Configure PWM range for a GPIO + get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + get_PWM_frequency Get configured PWM frequency for a GPIO + get_PWM_range Get configured PWM range for a GPIO + get_PWM_real_range Get underlying PWM range for a GPIO + */ + + + // i2c + int i2c_open( pigI2C& i2c ) override; + int i2c_close( pigI2C& i2c ) override; + + /* + int i2c_write_quick( pigI2C& i2c, unsigned bit ) override; + int i2c_write_byte( pigI2C& i2c, unsigned bVal ) override; + int i2c_write_byte_data( pigI2C& i2c, unsigned reg, unsigned val ) override; + int i2c_write_word_data( pigI2C& i2c, unsigned reg, unsigned val ) override; + int i2c_write_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + int i2c_write_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + */ + + int i2c_write_device( pigI2C& i2c, char* buf, unsigned count ) override; + + /* + int i2c_read_byte( pigI2C& i2c ) override; + int i2c_read_byte_data( pigI2C& i2c, unsigned reg ) override; + int i2c_read_word_data( pigI2C& i2c, unsigned reg ) override; + int i2c_read_block_data( pigI2C& i2c, unsigned reg, char* buf ) override; + int i2c_read_i2c_block_data( pigI2C& i2c, unsigned reg, char* buf, unsigned count ) override; + int i2c_read_device( pigI2C& i2c, char* buf, unsigned count ) override; + + int i2c_process_call( pigI2C& i2c, unsigned i2c_reg, unsigned wVal ) override; + int i2c_block_process_call( pigI2C& i2c,unsigned i2c_reg, char* buf, unsigned count ) override; + int i2c_zip( pigI2C& i2c, char* inBuf, unsigned inLen, char* outBuf, unsigned outLen ) override; + */ + + // advanced + int hardware_PWM( bcm_t bcm, uint32_t PWMfreq, uint32_t PWMduty ) override; + int hardware_clock( bcm_t bcm, uint32_t clkfreq ) override; + uint32_t get_current_tick() override; + // convenience + int show_error( int error ) override; + + // info + int get_hardware_revision() override; + int get_pigpio_version() override; + unsigned pigpiod_if_version() override; + + private: + + pigWindows() = default; + + }; + +} // namespace pigpio + + +#endif // LIBPIGWINDOWS_H diff --git a/main.cpp b/main.cpp new file mode 100644 index 0000000..bb2ecc5 --- /dev/null +++ b/main.cpp @@ -0,0 +1,175 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + + +#include +#include + + + +using namespace std; +using namespace pigpio; + + + +void on_level( level_t level ) +{ + cout << "on_level:" << level << endl; +} + + + +namespace qtgpio +{ + // LED + [[maybe_unused]] static const char* const icnRed = ":images/Red.png"; + [[maybe_unused]] static const char* const icnGreen = ":images/Green.png"; + + /// misc + [[maybe_unused]] static const char* const version = "Version 0.8.43, 19.10.2022 © 2022 chris@sourceworx.org"; + +} + +//#define high true +[[maybe_unused]] constexpr static const char* mainVersion = "libPiGPIO 0.2.11 / 19.10.2022 © 2022 chris@sourceworx.org"; + +void funktion( double state ) { std::cout << "free function: " << state << std::endl; } + +int main( int argc, char** argv ) +{ + Q_UNUSED(argc) + Q_UNUSED(argv) + + //pigpio::init( "host", "port" ); + greet(); + + // Blink is the “Hello World” of the microcontroller world. + // It usually does nothing more than flash an LED or 2. + // (Gordon Henderson, WiringPi ) + + pigLCD lcd( 0x27 ); + lcd.set_backlight( on ); + lcd.write( 0, 0, "blink!" ); + + /* + on_level( 1 ); + on_level( true ); + on_level( pigpio::high ); + on_level( high ); + */ + + /* + // ein 'Drückschalter' an Pin GPIO 16 + pigButton button( bcm16 ); + // eine LED und ein Summer an Pin 12 und Pin 23 + pigLED LED( bcm12 ); + pigBuzzer buzzer( bcm23 ); + // Zustände verknüpfen + button.connect_state( LED ); + button.connect_state( buzzer ); + // 'connect_state' ist die Kurzform von + // sigState.connect( &T::change_state, &listener ); + */ + /* + pigBeeper beeper( bcm25 ); + std::vector tnv = { 262.0, 294.0, 330.0, 262.0 }; + std::vector drv = { 0.5, 0.5, 0.5, 0.5 }; + beeper.play_tune( tnv, drv ); + beeper.play_tone( 295, 0.3 ); + */ + + + //pigRotaryDial dial( pigpio::bcm17, pigpio::bcm27, pigpio::bcm22 ); + //pigRotaryDial dial( board17, board27, board22 ); + pigRotaryDial dialA( bcm17, bcm27, bcm22 ); + pigRotaryDial dialB( bcm16, bcm20, bcm21 ); + + dialA.sigValue.connect( [&](int value){ cout << "Dial A: " << value << endl; } ); + dialB.sigValue.connect( [&](int value){ cout << "Dial B: " << value << endl; } ); + + + + /* + pigSonar sonar( bcm21, bcm20 ); + sonar.sigValue.connect( [&](double dist){ buzzer.buzz( 100, dist*50 ); } ); + sonar.start( 20 ); + */ + + /* + while( loop ) + { + //double dist = sonar.distance(); + //lcd.write( 0, 0, "Dist.: " + val2str( dist) + " cm" ); + + if( dist < 20 ) + { + buzzer.buzz( 100, dist*50 ); + LED.blink( dist*30 ); + } + delay_millis( 200 ); + } + */ + + /* + + + + bool loop = true; + button.sigState.connect( [&](bool){ loop = false; } ); + + while( loop ) + { + lcd.write( 0,0, format_time() ); + delay_seconds( 1 ); + } + + lcd.reset(); + + +*/ + + wait_loop(); + + /* + QApplication application( argc, argv ); + QtGPIOMain window; + window.show(); + return application.exec(); + */ + + +} diff --git a/moc_QtGPIOMain.cpp b/moc_QtGPIOMain.cpp new file mode 100644 index 0000000..4ced33c --- /dev/null +++ b/moc_QtGPIOMain.cpp @@ -0,0 +1,95 @@ +/**************************************************************************** +** Meta object code from reading C++ file 'QtGPIOMain.h' +** +** Created by: The Qt Meta Object Compiler version 67 (Qt 5.15.2) +** +** WARNING! All changes made in this file will be lost! +*****************************************************************************/ + +#include +#include "QtGPIOMain.h" +#include +#include +#if !defined(Q_MOC_OUTPUT_REVISION) +#error "The header file 'QtGPIOMain.h' doesn't include ." +#elif Q_MOC_OUTPUT_REVISION != 67 +#error "This file was generated using the moc from 5.15.2. It" +#error "cannot be used with the include files from this version of Qt." +#error "(The moc has changed too much.)" +#endif + +QT_BEGIN_MOC_NAMESPACE +QT_WARNING_PUSH +QT_WARNING_DISABLE_DEPRECATED +struct qt_meta_stringdata_QtGPIOMain_t { + QByteArrayData data[1]; + char stringdata0[11]; +}; +#define QT_MOC_LITERAL(idx, ofs, len) \ + Q_STATIC_BYTE_ARRAY_DATA_HEADER_INITIALIZER_WITH_OFFSET(len, \ + qptrdiff(offsetof(qt_meta_stringdata_QtGPIOMain_t, stringdata0) + ofs \ + - idx * sizeof(QByteArrayData)) \ + ) +static const qt_meta_stringdata_QtGPIOMain_t qt_meta_stringdata_QtGPIOMain = { + { +QT_MOC_LITERAL(0, 0, 10) // "QtGPIOMain" + + }, + "QtGPIOMain" +}; +#undef QT_MOC_LITERAL + +static const uint qt_meta_data_QtGPIOMain[] = { + + // content: + 8, // revision + 0, // classname + 0, 0, // classinfo + 0, 0, // methods + 0, 0, // properties + 0, 0, // enums/sets + 0, 0, // constructors + 0, // flags + 0, // signalCount + + 0 // eod +}; + +void QtGPIOMain::qt_static_metacall(QObject *_o, QMetaObject::Call _c, int _id, void **_a) +{ + Q_UNUSED(_o); + Q_UNUSED(_id); + Q_UNUSED(_c); + Q_UNUSED(_a); +} + +QT_INIT_METAOBJECT const QMetaObject QtGPIOMain::staticMetaObject = { { + QMetaObject::SuperData::link(), + qt_meta_stringdata_QtGPIOMain.data, + qt_meta_data_QtGPIOMain, + qt_static_metacall, + nullptr, + nullptr +} }; + + +const QMetaObject *QtGPIOMain::metaObject() const +{ + return QObject::d_ptr->metaObject ? QObject::d_ptr->dynamicMetaObject() : &staticMetaObject; +} + +void *QtGPIOMain::qt_metacast(const char *_clname) +{ + if (!_clname) return nullptr; + if (!strcmp(_clname, qt_meta_stringdata_QtGPIOMain.stringdata0)) + return static_cast(this); + return QMainWindow::qt_metacast(_clname); +} + +int QtGPIOMain::qt_metacall(QMetaObject::Call _c, int _id, void **_a) +{ + _id = QMainWindow::qt_metacall(_c, _id, _a); + return _id; +} +QT_WARNING_POP +QT_END_MOC_NAMESPACE diff --git a/moc_predefs.h b/moc_predefs.h new file mode 100644 index 0000000..480b955 --- /dev/null +++ b/moc_predefs.h @@ -0,0 +1,471 @@ +#define __DBL_MIN_EXP__ (-1021) +#define __HQ_FBIT__ 15 +#define __cpp_nontype_template_parameter_auto 201606L +#define __UINT_LEAST16_MAX__ 0xffff +#define __ARM_SIZEOF_WCHAR_T 4 +#define __SFRACT_IBIT__ 0 +#define __FLT_MIN__ 1.1754943508222875e-38F +#define __GCC_IEC_559_COMPLEX 2 +#define __cpp_aggregate_nsdmi 201304L +#define __UFRACT_MAX__ 0XFFFFP-16UR +#define __UINT_LEAST8_TYPE__ unsigned char +#define __FLT_MAX_EXP__ 128 +#define __DQ_FBIT__ 63 +#define __INTMAX_C(c) c ## LL +#define __ARM_FEATURE_SAT 1 +#define __ULFRACT_FBIT__ 32 +#define __CHAR_BIT__ 8 +#define __USQ_IBIT__ 0 +#define __UINT8_MAX__ 0xff +#define __ACCUM_FBIT__ 15 +#define __WINT_MAX__ 0xffffffffU +#define __FLT32_MIN_EXP__ (-125) +#define __cpp_static_assert 201411L +#define __USFRACT_FBIT__ 8 +#define __ORDER_LITTLE_ENDIAN__ 1234 +#define __SIZE_MAX__ 0xffffffffU +#define __ARM_ARCH_ISA_ARM 1 +#define __WCHAR_MAX__ 0xffffffffU +#define __LACCUM_IBIT__ 32 +#define __GCC_HAVE_SYNC_COMPARE_AND_SWAP_4 1 +#define __DBL_DENORM_MIN__ double(4.9406564584124654e-324L) +#define __GCC_ATOMIC_CHAR_LOCK_FREE 1 +#define __GCC_IEC_559 2 +#define __FLT32X_DECIMAL_DIG__ 17 +#define __FLT_EVAL_METHOD__ 0 +#define __TQ_IBIT__ 0 +#define __cpp_binary_literals 201304L +#define __LLACCUM_MAX__ 0X7FFFFFFFFFFFFFFFP-31LLK +#define __FLT64_DECIMAL_DIG__ 17 +#define __cpp_noexcept_function_type 201510L +#define __GCC_ATOMIC_CHAR32_T_LOCK_FREE 2 +#define __cpp_variadic_templates 200704L +#define __INTPTR_WIDTH__ 32 +#define __UINT_FAST64_MAX__ 0xffffffffffffffffULL +#define __SIG_ATOMIC_TYPE__ int +#define __DBL_MIN_10_EXP__ (-307) +#define __FINITE_MATH_ONLY__ 0 +#define __ARMEL__ 1 +#define __cpp_variable_templates 201304L +#define __FLT32X_MAX_EXP__ 1024 +#define __LFRACT_IBIT__ 0 +#define __GNUC_PATCHLEVEL__ 1 +#define __FLT32_HAS_DENORM__ 1 +#define __USA_FBIT__ 16 +#define __UINT_FAST8_MAX__ 0xff +#define __cpp_rvalue_reference 200610L +#define __INT8_C(c) c +#define __INT_LEAST8_WIDTH__ 8 +#define __cpp_variadic_using 201611L +#define __UINT_LEAST64_MAX__ 0xffffffffffffffffULL +#define __INT16_MAX__ 0x7fff +#define __cpp_attributes 200809L +#define __SA_FBIT__ 15 +#define __cpp_capture_star_this 201603L +#define __APCS_32__ 1 +#define __SHRT_MAX__ 0x7fff +#define __LDBL_MAX__ 1.7976931348623157e+308L +#define __FRACT_MAX__ 0X7FFFP-15R +#define __cpp_if_constexpr 201606L +#define __UFRACT_FBIT__ 16 +#define __ARM_FP 12 +#define __UFRACT_MIN__ 0.0UR +#define __UINT_LEAST8_MAX__ 0xff +#define __GCC_ATOMIC_BOOL_LOCK_FREE 1 +#define __UINTMAX_TYPE__ long long unsigned int +#define __LLFRACT_EPSILON__ 0x1P-63LLR +#define __linux 1 +#define __FLT_EVAL_METHOD_TS_18661_3__ 0 +#define __CHAR_UNSIGNED__ 1 +#define __UINT32_MAX__ 0xffffffffU +#define __GXX_EXPERIMENTAL_CXX0X__ 1 +#define __ULFRACT_MAX__ 0XFFFFFFFFP-32ULR +#define __TA_IBIT__ 64 +#define __LDBL_MAX_EXP__ 1024 +#define __WINT_MIN__ 0U +#define __INT_LEAST16_WIDTH__ 16 +#define __ULLFRACT_MIN__ 0.0ULLR +#define __SCHAR_MAX__ 0x7f +#define __WCHAR_MIN__ 0U +#define __INT64_C(c) c ## LL +#define __GCC_ATOMIC_POINTER_LOCK_FREE 2 +#define __LLACCUM_MIN__ (-0X1P31LLK-0X1P31LLK) +#define __SIZEOF_INT__ 4 +#define __FLT32X_MANT_DIG__ 53 +#define __GCC_ATOMIC_CHAR16_T_LOCK_FREE 1 +#define __USACCUM_IBIT__ 8 +#define __cpp_aligned_new 201606L +#define __USER_LABEL_PREFIX__ +#define __STDC_HOSTED__ 1 +#define __FLT_DIG__ 6 +#define __LFRACT_MIN__ (-0.5LR-0.5LR) +#define __HA_IBIT__ 8 +#define __cpp_decltype_auto 201304L +#define __FLT32_DIG__ 6 +#define __FLT_EPSILON__ 1.1920928955078125e-7F +#define __GXX_WEAK__ 1 +#define __SHRT_WIDTH__ 16 +#define __USFRACT_IBIT__ 0 +#define __LDBL_MIN__ 2.2250738585072014e-308L +#define __FRACT_MIN__ (-0.5R-0.5R) +#define __DA_IBIT__ 32 +#define __ARM_SIZEOF_MINIMAL_ENUM 4 +#define __FLT32X_HAS_INFINITY__ 1 +#define __UQQ_FBIT__ 8 +#define __SIZEOF_LONG__ 4 +#define __UACCUM_MAX__ 0XFFFFFFFFP-16UK +#define __STDC_IEC_559__ 1 +#define __STDC_ISO_10646__ 201706L +#define __DECIMAL_DIG__ 17 +#define __LFRACT_EPSILON__ 0x1P-31LR +#define __STDC_IEC_559_COMPLEX__ 1 +#define __FLT64_EPSILON__ 2.2204460492503131e-16F64 +#define __gnu_linux__ 1 +#define __FLT64_MIN_EXP__ (-1021) +#define __ARM_PCS_VFP 1 +#define __LDBL_HAS_QUIET_NAN__ 1 +#define __ULACCUM_IBIT__ 32 +#define __FLT64_MANT_DIG__ 53 +#define __GXX_RTTI 1 +#define __UACCUM_EPSILON__ 0x1P-16UK +#define __GNUC__ 10 +#define __ULLACCUM_MAX__ 0XFFFFFFFFFFFFFFFFP-32ULLK +#define __HQ_IBIT__ 0 +#define __FLT_HAS_DENORM__ 1 +#define __SIZEOF_LONG_DOUBLE__ 8 +#define __SA_IBIT__ 16 +#define __BIGGEST_ALIGNMENT__ 8 +#define __STDC_UTF_16__ 1 +#define __INTPTR_TYPE__ int +#define __FLT64_MAX_10_EXP__ 308 +#define __DBL_DIG__ 15 +#define __ULLACCUM_FBIT__ 32 +#define __GNUC_STDC_INLINE__ 1 +#define __DQ_IBIT__ 0 +#define __DBL_MAX__ double(1.7976931348623157e+308L) +#define __ULFRACT_IBIT__ 0 +#define __cpp_raw_strings 200710L +#define __INT_FAST32_MAX__ 0x7fffffff +#define __DBL_HAS_INFINITY__ 1 +#define __HAVE_SPECULATION_SAFE_VALUE 1 +#define __cpp_fold_expressions 201603L +#define __ACCUM_IBIT__ 16 +#define __THUMB_INTERWORK__ 1 +#define __UINT_LEAST32_MAX__ 0xffffffffU +#define __ULLACCUM_IBIT__ 32 +#define __LACCUM_MAX__ 0X7FFFFFFFFFFFFFFFP-31LK +#define __cpp_delegating_constructors 200604L +#define __FLT32X_HAS_DENORM__ 1 +#define __INT_FAST16_TYPE__ int +#define __LDBL_HAS_DENORM__ 1 +#define __ARM_FEATURE_LDREX 4 +#define __cplusplus 201703L +#define __cpp_ref_qualifiers 200710L +#define __FLT32_DECIMAL_DIG__ 9 +#define __INT_LEAST32_MAX__ 0x7fffffff +#define __ACCUM_MAX__ 0X7FFFFFFFP-15K +#define __DEPRECATED 1 +#define __cpp_rvalue_references 200610L +#define __DBL_MAX_EXP__ 1024 +#define __USACCUM_EPSILON__ 0x1P-8UHK +#define __WCHAR_WIDTH__ 32 +#define __FLT32_MAX__ 3.4028234663852886e+38F32 +#define __SFRACT_MAX__ 0X7FP-7HR +#define __FRACT_IBIT__ 0 +#define __PTRDIFF_MAX__ 0x7fffffff +#define __UACCUM_MIN__ 0.0UK +#define __UACCUM_IBIT__ 16 +#define __FLT32_HAS_QUIET_NAN__ 1 +#define __GNUG__ 10 +#define __LONG_LONG_MAX__ 0x7fffffffffffffffLL +#define __ULACCUM_MAX__ 0XFFFFFFFFFFFFFFFFP-32ULK +#define __cpp_nsdmi 200809L +#define __SIZEOF_WINT_T__ 4 +#define __ARM_FEATURE_UNALIGNED 1 +#define __LONG_LONG_WIDTH__ 64 +#define __cpp_initializer_lists 200806L +#define __FLT32_MAX_EXP__ 128 +#define __ULLACCUM_MIN__ 0.0ULLK +#define __cpp_hex_float 201603L +#define __cpp_threadsafe_static_init 200806L +#define __GXX_ABI_VERSION 1014 +#define __UTA_FBIT__ 64 +#define __UFRACT_IBIT__ 0 +#define __USQ_FBIT__ 32 +#define __cpp_enumerator_attributes 201411L +#define __cpp_lambdas 200907L +#define __ARM_FEATURE_QBIT 1 +#define __INT_FAST64_TYPE__ long long int +#define __FLT64_DENORM_MIN__ 4.9406564584124654e-324F64 +#define __DBL_MIN__ double(2.2250738585072014e-308L) +#define __SIZEOF_POINTER__ 4 +#define __INT16_TYPE__ short int +#define __DBL_HAS_QUIET_NAN__ 1 +#define __FLT32X_EPSILON__ 2.2204460492503131e-16F32x +#define __LACCUM_MIN__ (-0X1P31LK-0X1P31LK) +#define __FRACT_FBIT__ 15 +#define __FLT64_MIN_10_EXP__ (-307) +#define __ULLFRACT_EPSILON__ 0x1P-64ULLR +#define __REGISTER_PREFIX__ +#define __UINT16_MAX__ 0xffff +#define __ACCUM_MIN__ (-0X1P15K-0X1P15K) +#define __SQ_IBIT__ 0 +#define __UINT8_TYPE__ unsigned char +#define __UHA_FBIT__ 8 +#define __SFRACT_MIN__ (-0.5HR-0.5HR) +#define __UTQ_FBIT__ 128 +#define __DEC_EVAL_METHOD__ 2 +#define __FLT_MANT_DIG__ 24 +#define __LDBL_DECIMAL_DIG__ 17 +#define __VERSION__ "10.2.1 20210110" +#define __UINT64_C(c) c ## ULL +#define __cpp_unicode_characters 201411L +#define __FRACT_EPSILON__ 0x1P-15R +#define __ULACCUM_MIN__ 0.0ULK +#define _STDC_PREDEF_H 1 +#define __UDA_FBIT__ 32 +#define __GCC_ATOMIC_INT_LOCK_FREE 2 +#define __FLT_MIN_EXP__ (-125) +#define __FLOAT_WORD_ORDER__ __ORDER_LITTLE_ENDIAN__ +#define __USFRACT_MIN__ 0.0UHR +#define __FLT32_MANT_DIG__ 24 +#define __ULLFRACT_FBIT__ 64 +#define __cpp_aggregate_bases 201603L +#define __UQQ_IBIT__ 0 +#define __SCHAR_WIDTH__ 8 +#define __INT32_C(c) c +#define __ORDER_PDP_ENDIAN__ 3412 +#define __UHQ_FBIT__ 16 +#define __LLACCUM_FBIT__ 31 +#define __INT_FAST32_TYPE__ int +#define __UINT_LEAST16_TYPE__ short unsigned int +#define unix 1 +#define __DBL_HAS_DENORM__ 1 +#define __cpp_rtti 199711L +#define __SIZE_TYPE__ unsigned int +#define __UINT64_MAX__ 0xffffffffffffffffULL +#define __UDQ_FBIT__ 64 +#define __INT8_TYPE__ signed char +#define __cpp_digit_separators 201309L +#define __ELF__ 1 +#define __SACCUM_EPSILON__ 0x1P-7HK +#define __ULFRACT_EPSILON__ 0x1P-32ULR +#define __LLFRACT_FBIT__ 63 +#define __FLT_RADIX__ 2 +#define __INT_LEAST16_TYPE__ short int +#define __LDBL_EPSILON__ 2.2204460492503131e-16L +#define __UINTMAX_C(c) c ## ULL +#define __SACCUM_MAX__ 0X7FFFP-7HK +#define __FLT32X_MIN__ 2.2250738585072014e-308F32x +#define __SIG_ATOMIC_MAX__ 0x7fffffff +#define __UACCUM_FBIT__ 16 +#define __GCC_ATOMIC_WCHAR_T_LOCK_FREE 2 +#define __VFP_FP__ 1 +#define __SIZEOF_PTRDIFF_T__ 4 +#define __ATOMIC_ACQUIRE 2 +#define __unix__ 1 +#define __INT_WIDTH__ 32 +#define __OPTIMIZE__ 1 +#define __LACCUM_EPSILON__ 0x1P-31LK +#define __LDBL_DIG__ 15 +#define __FLT32X_MIN_EXP__ (-1021) +#define __INT_FAST16_MAX__ 0x7fffffff +#define __LFRACT_MAX__ 0X7FFFFFFFP-31LR +#define __ARM_ARCH_6__ 1 +#define __FLT64_DIG__ 15 +#define __UINT_FAST32_MAX__ 0xffffffffU +#define __UINT_LEAST64_TYPE__ long long unsigned int +#define __SFRACT_EPSILON__ 0x1P-7HR +#define __GCC_ASM_FLAG_OUTPUTS__ 1 +#define __FLT_HAS_QUIET_NAN__ 1 +#define __FLT_MAX_10_EXP__ 38 +#define __LONG_MAX__ 0x7fffffffL +#define __SIZEOF_SIZE_T__ 4 +#define __FLT_HAS_INFINITY__ 1 +#define __unix 1 +#define __cpp_unicode_literals 200710L +#define __cpp_init_captures 201304L +#define __UINT_FAST16_TYPE__ unsigned int +#define __ARM_32BIT_STATE 1 +#define __INT_FAST32_WIDTH__ 32 +#define __CHAR16_TYPE__ short unsigned int +#define __PRAGMA_REDEFINE_EXTNAME 1 +#define __SIZE_WIDTH__ 32 +#define __INT_LEAST16_MAX__ 0x7fff +#define __INT64_MAX__ 0x7fffffffffffffffLL +#define __SACCUM_FBIT__ 7 +#define __FLT32_DENORM_MIN__ 1.4012984643248171e-45F32 +#define __SIG_ATOMIC_WIDTH__ 32 +#define __INT_LEAST64_TYPE__ long long int +#define __ARM_FEATURE_CLZ 1 +#define __INT_LEAST8_TYPE__ signed char +#define __cpp_structured_bindings 201606L +#define __SQ_FBIT__ 31 +#define __USFRACT_MAX__ 0XFFP-8UHR +#define __ARM_ARCH_ISA_THUMB 1 +#define __INT_FAST8_MAX__ 0x7f +#define __ARM_ARCH 6 +#define __INTPTR_MAX__ 0x7fffffff +#define __cpp_sized_deallocation 201309L +#define __cpp_guaranteed_copy_elision 201606L +#define __QQ_FBIT__ 7 +#define linux 1 +#define __UTA_IBIT__ 64 +#define __FLT64_HAS_QUIET_NAN__ 1 +#define __UINT16_C(c) c +#define __PTRDIFF_WIDTH__ 32 +#define __LDBL_MANT_DIG__ 53 +#define __SFRACT_FBIT__ 7 +#define __cpp_range_based_for 201603L +#define __SACCUM_MIN__ (-0X1P7HK-0X1P7HK) +#define __FLT64_HAS_INFINITY__ 1 +#define __STDCPP_DEFAULT_NEW_ALIGNMENT__ 8 +#define __SIG_ATOMIC_MIN__ (-__SIG_ATOMIC_MAX__ - 1) +#define __GCC_ATOMIC_LONG_LOCK_FREE 2 +#define __cpp_nontype_template_args 201411L +#define __UINT16_TYPE__ short unsigned int +#define __WCHAR_TYPE__ unsigned int +#define __SIZEOF_FLOAT__ 4 +#define __TQ_FBIT__ 127 +#define __UINTPTR_MAX__ 0xffffffffU +#define __INT_FAST64_WIDTH__ 64 +#define __cpp_decltype 200707L +#define __cpp_nested_namespace_definitions 201411L +#define __INT_FAST64_MAX__ 0x7fffffffffffffffLL +#define __GCC_ATOMIC_TEST_AND_SET_TRUEVAL 1 +#define __FLT_NORM_MAX__ 3.4028234663852886e+38F +#define __FLT32_HAS_INFINITY__ 1 +#define __UINT_FAST64_TYPE__ long long unsigned int +#define __cpp_inline_variables 201606L +#define __LACCUM_FBIT__ 31 +#define __HA_FBIT__ 7 +#define __UHA_IBIT__ 8 +#define __INT64_TYPE__ long long int +#define __UTQ_IBIT__ 0 +#define __DBL_MANT_DIG__ 53 +#define __cpp_inheriting_constructors 201511L +#define __INT_LEAST64_MAX__ 0x7fffffffffffffffLL +#define __WINT_TYPE__ unsigned int +#define __UINT_LEAST32_TYPE__ unsigned int +#define __SIZEOF_SHORT__ 2 +#define __ULLFRACT_IBIT__ 0 +#define __FLT32_NORM_MAX__ 3.4028234663852886e+38F32 +#define __LDBL_MIN_EXP__ (-1021) +#define __GXX_TYPEINFO_EQUALITY_INLINE 0 +#define __INTMAX_MAX__ 0x7fffffffffffffffLL +#define __arm__ 1 +#define __FLT64_MAX__ 1.7976931348623157e+308F64 +#define __UDA_IBIT__ 32 +#define __INT_MAX__ 0x7fffffff +#define __WINT_WIDTH__ 32 +#define __cpp_template_auto 201606L +#define __INT_LEAST8_MAX__ 0x7f +#define __INT_LEAST64_WIDTH__ 64 +#define __FLT32X_MAX_10_EXP__ 308 +#define __LLACCUM_EPSILON__ 0x1P-31LLK +#define __LFRACT_FBIT__ 31 +#define __WCHAR_UNSIGNED__ 1 +#define __LDBL_MAX_10_EXP__ 308 +#define __ATOMIC_RELAXED 0 +#define __DBL_EPSILON__ double(2.2204460492503131e-16L) +#define __ARM_FEATURE_SIMD32 1 +#define __UINT8_C(c) c +#define __FLT64_MAX_EXP__ 1024 +#define __INT_LEAST32_TYPE__ int +#define __cpp_return_type_deduction 201304L +#define __SIZEOF_WCHAR_T__ 4 +#define __LLFRACT_MAX__ 0X7FFFFFFFFFFFFFFFP-63LLR +#define __FLT64_NORM_MAX__ 1.7976931348623157e+308F64 +#define __INT_FAST8_TYPE__ signed char +#define __cpp_namespace_attributes 201411L +#define __ULLACCUM_EPSILON__ 0x1P-32ULLK +#define __USACCUM_MAX__ 0XFFFFP-8UHK +#define __LDBL_HAS_INFINITY__ 1 +#define __FLT32_MAX_10_EXP__ 38 +#define __UHQ_IBIT__ 0 +#define __ARM_FEATURE_COPROC 15 +#define __LLACCUM_IBIT__ 32 +#define __ULFRACT_MIN__ 0.0ULR +#define __FLT64_HAS_DENORM__ 1 +#define __FLT32_EPSILON__ 1.1920928955078125e-7F32 +#define __DBL_DECIMAL_DIG__ 17 +#define __STDC_UTF_32__ 1 +#define __INT_FAST8_WIDTH__ 8 +#define __BYTE_ORDER__ __ORDER_LITTLE_ENDIAN__ +#define __FLT32X_MAX__ 1.7976931348623157e+308F32x +#define __TA_FBIT__ 63 +#define __DBL_NORM_MAX__ double(1.7976931348623157e+308L) +#define __UDQ_IBIT__ 0 +#define __INTMAX_WIDTH__ 64 +#define __ORDER_BIG_ENDIAN__ 4321 +#define __ARM_FEATURE_DSP 1 +#define __cpp_runtime_arrays 198712L +#define __UINT64_TYPE__ long long unsigned int +#define __ACCUM_EPSILON__ 0x1P-15K +#define __UINT32_C(c) c ## U +#define __cpp_alias_templates 200704L +#define __QQ_IBIT__ 0 +#define __FLT_DENORM_MIN__ 1.4012984643248171e-45F +#define __LLFRACT_IBIT__ 0 +#define __INT8_MAX__ 0x7f +#define __LONG_WIDTH__ 32 +#define __INT32_MAX__ 0x7fffffff +#define __UINT_FAST32_TYPE__ unsigned int +#define __FLT32X_NORM_MAX__ 1.7976931348623157e+308F32x +#define __CHAR32_TYPE__ unsigned int +#define __FLT32_MIN_10_EXP__ (-37) +#define __FLT_MAX__ 3.4028234663852886e+38F +#define __cpp_constexpr 201603L +#define __USACCUM_FBIT__ 8 +#define __cpp_deduction_guides 201703L +#define __INT32_TYPE__ int +#define __SIZEOF_DOUBLE__ 8 +#define __cpp_exceptions 199711L +#define __FLT_MIN_10_EXP__ (-37) +#define __UFRACT_EPSILON__ 0x1P-16UR +#define __FLT64_MIN__ 2.2250738585072014e-308F64 +#define __INT_LEAST32_WIDTH__ 32 +#define __INTMAX_TYPE__ long long int +#define __FLT32X_HAS_QUIET_NAN__ 1 +#define __ATOMIC_CONSUME 1 +#define __GNUC_MINOR__ 2 +#define __INT_FAST16_WIDTH__ 32 +#define __UINTMAX_MAX__ 0xffffffffffffffffULL +#define __FLT32X_DENORM_MIN__ 4.9406564584124654e-324F32x +#define __cpp_template_template_args 201611L +#define __ATOMIC_ACQ_REL 4 +#define __DBL_MAX_10_EXP__ 308 +#define __LDBL_DENORM_MIN__ 4.9406564584124654e-324L +#define __INT16_C(c) c +#define __STDC__ 1 +#define __FLT32X_DIG__ 15 +#define __PTRDIFF_TYPE__ int +#define __LLFRACT_MIN__ (-0.5LLR-0.5LLR) +#define __USACCUM_MIN__ 0.0UHK +#define __FLT32_MIN__ 1.1754943508222875e-38F32 +#define __ATOMIC_SEQ_CST 5 +#define __DA_FBIT__ 31 +#define __EXCEPTIONS 1 +#define __UINT32_TYPE__ unsigned int +#define __FLT32X_MIN_10_EXP__ (-307) +#define __UINTPTR_TYPE__ unsigned int +#define __USA_IBIT__ 16 +#define __ARM_EABI__ 1 +#define __linux__ 1 +#define __LDBL_MIN_10_EXP__ (-307) +#define __cpp_generic_lambdas 201304L +#define __SIZEOF_LONG_LONG__ 8 +#define __ULACCUM_EPSILON__ 0x1P-32ULK +#define __cpp_user_defined_literals 200809L +#define __SACCUM_IBIT__ 8 +#define __GCC_ATOMIC_LLONG_LOCK_FREE 1 +#define __FLT_DECIMAL_DIG__ 9 +#define __UINT_FAST16_MAX__ 0xffffffffU +#define __LDBL_NORM_MAX__ 1.7976931348623157e+308L +#define __GCC_ATOMIC_SHORT_LOCK_FREE 1 +#define __ULLFRACT_MAX__ 0XFFFFFFFFFFFFFFFFP-64ULLR +#define __UINT_FAST8_TYPE__ unsigned char +#define _GNU_SOURCE 1 +#define __USFRACT_EPSILON__ 0x1P-8UHR +#define __ULACCUM_FBIT__ 32 +#define __ATOMIC_RELEASE 3 diff --git a/pigbeeper.cpp b/pigbeeper.cpp new file mode 100644 index 0000000..d35e72e --- /dev/null +++ b/pigbeeper.cpp @@ -0,0 +1,74 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + + + +pigBeeper::pigBeeper( bcm_t bcmNo ) + : pigNodeOut( bcmNo , pull_off ) +{ + +} + + +pigBeeper::~pigBeeper() +{ + +} + +void pigBeeper::play_tone( double freq, double duration ) +{ + double halveWaveTime = 1 / ( freq * 2 ); + int ms = (int)( 1000 * halveWaveTime ); + double waves = duration * freq; + int wv = (int) waves; + //std::cout << "sleep: " << halveWaveTime << " in micros: " << ms << " waves: " << waves << std::endl; + + std::thread thrd( + [=]() + { + for( int i=0; i < wv; ++i ) + { + _pinOut.set_level( high ); + delay_millis( ms ); + _pinOut.set_level( low ); + delay_millis( ms ); + } + } ); + thrd.detach(); + + +} + + +void pigBeeper::play_tune( std::vector frv, std::vector drv ) +{ + size_t count = std::max( frv.size(), drv.size() ); + for( size_t i=0; i +#include + +/** + * @brief The pigBeeper class + * ein __passiver__ Beeper, muss per PWM angesteuert + * werden. + */ + + +class LIBPIGPIO_EXPORT pigBeeper : public pigNodeOut +{ +public: + + explicit pigBeeper( pigpio::bcm_t bcmNo ); + virtual ~pigBeeper(); + + void play_tone( double freq, double duration ); + void play_tune( std::vector frv, std::vector drv ); + +}; + + + +#endif // PIGBEEPER_H diff --git a/pigbin b/pigbin new file mode 100644 index 0000000000000000000000000000000000000000..01fe154f08cfb48372c4e25b13400c7a590ed8c4 GIT binary patch literal 207576 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%0A<|tVt)-4Fn-&ZOGo&3{TOXqw&&---A!aWwwVhg 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 O88g5-R}(?gkN*!L6 +#include + + +pigButton::pigButton() +{ + +} + + +pigButton::pigButton( pigpio::bcm_t bcmNo ) + +{ + init( bcmNo ); +} + + +pigButton::~pigButton() +{ + +} + + +void pigButton::init( pigpio::bcm_t bcmNo ) +{ + _pinIn.init( bcmNo, pull_up ); + //pinIn.set_callback( this, rising ); + _pinIn.set_callback( this, falling ); + _pinIn.set_glitch_filter( 500 ); +} + + +void pigButton::change_state( bool newState ) +{ + if( newState == state() ) + return; + set_state( newState ); + sigState( _state ); + //_pinOut.set_level( _state ); +} + + +void pigButton::trigger( pigpio::bcm_t, uint32_t ) +{ + //std::cout << "pigButton::trigger: " << (uint32_t) bcm << " : " << level << std::endl; + change_state( !state() ); +} diff --git a/pigbutton.h b/pigbutton.h new file mode 100644 index 0000000..a4c1fc7 --- /dev/null +++ b/pigbutton.h @@ -0,0 +1,54 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGBUTTON_H +#define PIGBUTTON_H + +#include + +class LIBPIGPIO_EXPORT pigButton : public pigNodeIn +{ + + +public: + + pigButton(); + pigButton( pigpio::bcm_t bcmNo ); + virtual ~pigButton(); + + void init( pigpio::bcm_t bcmNo ); + + void change_state( bool newState ) override; + +protected: + + virtual void trigger( pigpio::bcm_t bcm, uint32_t level ) override; + + + +}; + + +#endif // PIGBUTTON_H + + + diff --git a/pigbuzzer.cpp b/pigbuzzer.cpp new file mode 100644 index 0000000..a1fdeff --- /dev/null +++ b/pigbuzzer.cpp @@ -0,0 +1,65 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + +#include +#include +#include + + +pigBuzzer::pigBuzzer( bcm_t bcmNo ) + : pigNodeOut( bcmNo , pull_off ) +{ + +} + + +pigBuzzer::~pigBuzzer() +{ + +} + + +void pigBuzzer::buzz( int millisOn, int millisOff ) +{ +/* + std::thread thrd( + [=]() + { + _pinOut.set_level( high ); + std::this_thread::sleep_for( std::chrono::milliseconds( millisOn ) ); + _pinOut.set_level( low ); + if( millisOff ) + std::this_thread::sleep_for( std::chrono::milliseconds( millisOff ) ); + } ); + thrd.detach(); + */ + + _pinOut.set_level( high ); + std::this_thread::sleep_for( std::chrono::milliseconds( millisOn ) ); + _pinOut.set_level( low ); + if( millisOff ) + std::this_thread::sleep_for( std::chrono::milliseconds( millisOff ) ); + +} diff --git a/pigbuzzer.h b/pigbuzzer.h new file mode 100644 index 0000000..8f8925d --- /dev/null +++ b/pigbuzzer.h @@ -0,0 +1,51 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGBUZZER_H +#define PIGBUZZER_H + +#include +#include + +/** + * @brief The pigBeeper class + * ein __passiver__ Beeper, muss per PWM angesteuert + * werden. + */ + + +class LIBPIGPIO_EXPORT pigBuzzer : public pigNodeOut +{ +public: + + explicit pigBuzzer( pigpio::bcm_t bcmNo ); + virtual ~pigBuzzer(); + + void buzz( int millisOn, int millisOff = 0 ); + + +}; + + + + +#endif // PIGBUZZER_H diff --git a/pigcall.cpp b/pigcall.cpp new file mode 100644 index 0000000..4164cbe --- /dev/null +++ b/pigcall.cpp @@ -0,0 +1,22 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + diff --git a/pigcall.h b/pigcall.h new file mode 100644 index 0000000..418d55d --- /dev/null +++ b/pigcall.h @@ -0,0 +1,37 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGCALL_H +#define PIGCALL_H + +#include + +class pigCall +{ + +public: + + virtual void trigger( pigpio::bcm_t, uint32_t ) = 0; + +}; + +#endif // PIGCALL_H diff --git a/pigchrono.cpp b/pigchrono.cpp new file mode 100644 index 0000000..2b74330 --- /dev/null +++ b/pigchrono.cpp @@ -0,0 +1,49 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + + +//using namespace std::chrono; + +pigChrono::pigChrono() + : _beg{ _clock::now() } +{ + +} + +void pigChrono::start() +{ + _beg = _clock::now(); +} + + +double pigChrono::elapsed_millis() const +{ + return (double) duration_cast( _clock::now() - _beg ).count() ; +} + + +double pigChrono::elapsed_micros() const +{ + return (double) duration_cast( _clock::now() - _beg ).count() ; +} diff --git a/pigchrono.h b/pigchrono.h new file mode 100644 index 0000000..e53e8ac --- /dev/null +++ b/pigchrono.h @@ -0,0 +1,53 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGCHRONO_H +#define PIGCHRONO_H + + +#include +#include + +using namespace std; +using namespace chrono; + +class LIBPIGPIO_EXPORT pigChrono +{ + +public: + + pigChrono(); + virtual ~pigChrono() = default; + + void start(); + double elapsed_millis() const; + double elapsed_micros() const; + +protected: + + using _clock = high_resolution_clock; + time_point<_clock> _beg; + +}; + + +#endif // PIGCHRONO_H diff --git a/pigi2c.cpp b/pigi2c.cpp new file mode 100644 index 0000000..ef8b087 --- /dev/null +++ b/pigi2c.cpp @@ -0,0 +1,55 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + +pigI2C::pigI2C() +{ + +} + + +pigI2C::pigI2C( i2c_addr_t aaddr, i2c_bus_t abus ) +{ + init( aaddr, abus ); +} + + +pigI2C::~pigI2C() +{ + pigpio::i2c_close( *this ); +} + + +void pigI2C::init( i2c_addr_t aaddr , i2c_bus_t abus ) +{ + addr = aaddr; + bus = abus; + + handle = pigpio::i2c_open( *this ); +} + + +int pigI2C::i2c_write_device( char* buf, unsigned count ) +{ + return pigpio::i2c_write_device( *this, buf, count ); +} diff --git a/pigi2c.h b/pigi2c.h new file mode 100644 index 0000000..e452959 --- /dev/null +++ b/pigi2c.h @@ -0,0 +1,51 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGI2C_H +#define PIGI2C_H + +#include +#include + +using namespace pigpio; + +struct LIBPIGPIO_EXPORT pigI2C +{ + + i2c_addr_t addr = 0; + i2c_bus_t bus = 1; + uint32_t handle = 0; + + pigI2C(); + explicit pigI2C( i2c_addr_t, i2c_bus_t = 1 ); + virtual ~pigI2C(); + + void init( i2c_addr_t, i2c_bus_t = 1 ); + + int i2c_write_device( char* buf, unsigned count ); + //void dump(); + + +}; + + +#endif // PIGI2C_H diff --git a/pigi2cnode.cpp b/pigi2cnode.cpp new file mode 100644 index 0000000..6cd541c --- /dev/null +++ b/pigi2cnode.cpp @@ -0,0 +1,12 @@ +#include "pigi2cnode.h" + +pigI2CNode::pigI2CNode( i2c_addr_t aaddr, i2c_bus_t abus ) +{ + init( aaddr, abus ); +} + + +void pigI2CNode::init( i2c_addr_t aaddr, i2c_bus_t abus ) +{ + _i2c.init( aaddr, abus ); +} diff --git a/pigi2cnode.h b/pigi2cnode.h new file mode 100644 index 0000000..3f77dee --- /dev/null +++ b/pigi2cnode.h @@ -0,0 +1,53 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGI2CNODE_H +#define PIGI2CNODE_H + + +#include +#include +#include + + +class LIBPIGPIO_EXPORT pigI2CNode : public pigNode +{ + +public: + + pigI2CNode() = default; + pigI2CNode( i2c_addr_t aaddr, i2c_bus_t abus ); + virtual ~pigI2CNode() = default; + + void init( i2c_addr_t aaddr, i2c_bus_t abus ); + + +protected: + + pigI2C _i2c; + +}; + + +#endif // PIGI2CNODE_H + + diff --git a/piglcd.cpp b/piglcd.cpp new file mode 100644 index 0000000..d607599 --- /dev/null +++ b/piglcd.cpp @@ -0,0 +1,182 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + + + +pigLCD::pigLCD( i2c_addr_t addr, i2c_bus_t bus ) +{ + init( addr, bus ); +} + + +pigLCD::~pigLCD() +{ + reset(); +} + + +void pigLCD::init( i2c_addr_t addr, i2c_bus_t bus, int width, bool bl, uint8_t RS, uint8_t , uint8_t E, uint8_t BL, uint8_t B4 ) +{ + _i2c.init( addr, bus ); + + _width = width; + _backlight = bl; + + _RS = (1<>4) & 0x0F; + uint8_t LSN = bits & 0x0F; + + uint8_t MSb = MSN << _B4; + uint8_t LSb = LSN << _B4; + + put_byte( MSb, LSb ); + +} + + +void pigLCD::put_data( uint8_t bits ) +{ + + uint8_t MSN = (bits>>4) & 0x0F; + uint8_t LSN = bits & 0x0F; + + uint8_t MSb = (MSN << _B4) | _RS; + uint8_t LSb = (LSN << _B4) | _RS; + + put_byte( MSb, LSb ); + +} + + + diff --git a/piglcd.h b/piglcd.h new file mode 100644 index 0000000..fe61fdd --- /dev/null +++ b/piglcd.h @@ -0,0 +1,165 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGLCD_H +#define PIGLCD_H + +//#include +//#include + +#include +/* +""" + This class provides simple functions to display text on an I2C LCD + based on the PCF8574T I2C 8-bit port expander. + + PCF8574T P7 P6 P5 P4 P3 P2 P1 P0 + HD44780 B7 B6 B5 B4 BL E RW RS + + This code defaults to working with an adapter with the above + configuration. + + If yours is different you will have to specify the mapping + when you instantiate the LCD. + """ + + """ + Commands + + LCD_CLEARDISPLAY = 0x01 + LCD_RETURNHOME = 0x02 + LCD_ENTRYMODESET = 0x04 + LCD_DISPLAYCONTROL = 0x08 + LCD_CURSORSHIFT = 0x10 + LCD_FUNCTIONSET = 0x20 + LCD_SETCGRAMADDR = 0x40 + LCD_SETDDRAMADDR = 0x80 + + Flags for display entry mode + + LCD_ENTRYRIGHT = 0x00 + LCD_ENTRYLEFT = 0x02 + LCD_ENTRYSHIFTINCREMENT = 0x01 + LCD_ENTRYSHIFTDECREMENT = 0x00 + + Flags for display on/off control + + LCD_DISPLAYON = 0x04 + LCD_DISPLAYOFF = 0x00 + LCD_CURSORON = 0x02 + LCD_CURSOROFF = 0x00 + LCD_BLINKON = 0x01 + LCD_BLINKOFF = 0x00 + + Flags for display/cursor shift + + LCD_DISPLAYMOVE = 0x08 + LCD_CURSORMOVE = 0x00 + LCD_MOVERIGHT = 0x04 + LCD_MOVELEFT = 0x00 + + Flags for function set + + LCD_8BITMODE = 0x10 + LCD_4BITMODE = 0x00 + LCD_2LINE = 0x08 + LCD_1LINE = 0x00 + LCD_5x10DOTS = 0x04 + LCD_5x8DOTS = 0x00 + + Flags for backlight control + + LCD_BACKLIGHT = 0x08 + LCD_NOBACKLIGHT = 0x00 + """ +*/ + + +/** + * @brief The pigLCD class für //HD44780 + * Back-Port von python, siehe: https://abyz.me.uk/rpi/pigpio/code/i2c_lcd_py.zip + * + */ + +class pigLCD : public pigI2CNode +{ +//HD44780 +public: + + pigLCD() = default; + pigLCD( i2c_addr_t addr, i2c_bus_t bus = 1 ); + virtual ~pigLCD(); + + void init( i2c_addr_t addr, i2c_bus_t bus=1, int width=16, bool bl=true, + uint8_t RS=0, uint8_t RW=1, uint8_t E=2, uint8_t BL=3, uint8_t B4=4 ); + + void set_backlight( bool bl ); + void move_to( int row, int col ); + void write( const char c ); + void write( const std::string text ); + void write( int row, int col, const std::string text ); + + + // inwieweit notwendig? + void reset(); + +protected: + + void put_byte( uint8_t MSb, uint8_t LSb ); + void put_inst( uint8_t bits ); + void put_data( uint8_t bits ); + + uint8_t _LCD_ROW[4] = { 0x80, 0xC0, 0x94, 0xD4 }; + + bool _backlight = false; + int _width = 16; + + //?? Type? + uint8_t _RS; + uint8_t _E; + uint8_t _BL; + uint8_t _B4; + /* + // GPIO chip i2c address + uint8_t i2c=0x27; + // Control line PINs + uint8_t en=2; + uint8_t rw=1; + uint8_t rs=0; + + // Data line PINs + uint8_t d4=4; + uint8_t d5=5; + uint8_t d6=6; + uint8_t d7=7; + + // Backlight PIN + uint8_t bl=3; + + // LCD display size (1x16, 2x16, 4x20) + uint8_t rows=2; + uint8_t cols=16; + */ + +}; + +#endif // PIGLCD_H diff --git a/pigled.cpp b/pigled.cpp new file mode 100644 index 0000000..16a38c3 --- /dev/null +++ b/pigled.cpp @@ -0,0 +1,59 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + +#include +#include +#include + + +pigLED::pigLED( bcm_t bcmNo ) + : pigNodeOut( bcmNo , pull_off ) +{ + +} + + +pigLED::~pigLED() +{ + +} + + +void pigLED::blink( int millisOn, int millisOff ) +{ + if( !millisOff ) + millisOff = millisOn; + + std::thread thrd( + [=]() + { + _pinOut.set_level( high ); + std::this_thread::sleep_for( std::chrono::milliseconds( millisOn ) ); + _pinOut.set_level( low ); + //std::this_thread::sleep_for( std::chrono::milliseconds( millisOff ) ); + } ); + thrd.detach(); + +} diff --git a/pigled.h b/pigled.h new file mode 100644 index 0000000..93b32c9 --- /dev/null +++ b/pigled.h @@ -0,0 +1,50 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGLED_H +#define PIGLED_H + +#include +#include + +/** + * @brief The pigBeeper class + * ein __passiver__ Beeper, muss per PWM angesteuert + * werden. + */ + + +class LIBPIGPIO_EXPORT pigLED : public pigNodeOut +{ +public: + + explicit pigLED( pigpio::bcm_t bcmNo ); + virtual ~pigLED(); + + void blink( int millisOn, int millisOff = 0 ); + + +}; + + + +#endif // PIGLED_H diff --git a/pignode.cpp b/pignode.cpp new file mode 100644 index 0000000..c1e529d --- /dev/null +++ b/pignode.cpp @@ -0,0 +1,41 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + + +/** + * @brief Maa im Footer pigNode::pigNode + */ + + +pigNode::pigNode() +{ + +} + +pigNode::~pigNode() +{ + +} + + diff --git a/pignode.h b/pignode.h new file mode 100644 index 0000000..78d5d06 --- /dev/null +++ b/pignode.h @@ -0,0 +1,49 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGNODE_H +#define PIGNODE_H + +#include +#include + + + +/** + * @brief im HEADER The pigNode class + */ + +class pigNode +{ + +public: + + pigNode(); + virtual ~pigNode(); + +}; + + + + + +#endif // PIGNODE_H diff --git a/pignodein.cpp b/pignodein.cpp new file mode 100644 index 0000000..c44fa1e --- /dev/null +++ b/pignodein.cpp @@ -0,0 +1,25 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + + diff --git a/pignodein.h b/pignodein.h new file mode 100644 index 0000000..0028603 --- /dev/null +++ b/pignodein.h @@ -0,0 +1,50 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGNODEIN_H +#define PIGNODEIN_H + + +#include +#include +#include +#include + + +/** + * @brief im HEADER The pigNode class + */ + +class LIBPIGPIO_EXPORT pigNodeIn : public pigNode, public pigCall, public pigState +{ + +public: + + pigNodeIn() = default; + virtual ~pigNodeIn() = default; + +protected: + + pigPinIn _pinIn; + +}; +#endif // PIGNODEIN_H diff --git a/pignodeout.cpp b/pignodeout.cpp new file mode 100644 index 0000000..22c2fe7 --- /dev/null +++ b/pignodeout.cpp @@ -0,0 +1,48 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + + +pigNodeOut::pigNodeOut( bcm_t bcmNo, pigpio::pud_t pud ) + : _pinOut( bcmNo, pud ) +{ + +} + + +pigNodeOut::~pigNodeOut() +{ + +} + + + +void pigNodeOut::change_state( bool newState ) +{ + if( newState == state() ) + return; + set_state( newState ); + //sigState( _state ); + _pinOut.set_level( _state ); +} diff --git a/pignodeout.h b/pignodeout.h new file mode 100644 index 0000000..d3bbba4 --- /dev/null +++ b/pignodeout.h @@ -0,0 +1,57 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGNODEOUT_H +#define PIGNODEOUT_H + + +#include +#include +#include + +/** + * @brief Eine Signal Senke aka receiver, drain, + * _empfängt_ status änderungen + * ein _aktiver_ Buzzer, nur an/aus, keine PWM, oder eben eine LED + * werden. + */ + +class LIBPIGPIO_EXPORT pigNodeOut : public pigNode, public pigState +{ + +public: + + explicit pigNodeOut( pigpio::bcm_t bcmNo, pigpio::pud_t pud = pigpio::pull_off ); + virtual ~pigNodeOut(); + + void change_state( bool newState ) override; + +protected: + + pigPinOut _pinOut; + +}; + + + + +#endif // PIGNODEOUT_H diff --git a/pigpin.cpp b/pigpin.cpp new file mode 100644 index 0000000..3965c99 --- /dev/null +++ b/pigpin.cpp @@ -0,0 +1,182 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include + +#include +#include + + +//using namespace pigpio; + + +pigPin::pigPin( bcm_t bcmNo, io_t modeNo, pud_t pudType ) +{ + init( bcmNo, modeNo, pudType ); +} + + +pigPin::~pigPin() +{ + +} + + +void pigPin::init( bcm_t bcmNo, io_t modeNo, pud_t pudType ) +{ + bcm = bcmNo; + set_io_mode( modeNo ); + set_pud_mode( pudType ); +} + + +int pigPin::get_level() +{ + return pigpio::get_level( bcm ); +} + + +void pigPin::set_level( level_t level ) +{ + pigpio::set_level( bcm, level ); +} + + +int pigPin::trigger_level( unsigned level, unsigned pulseLen ) +{ + return pigpio::trigger_level( bcm, pulseLen, level ); +} + + +int pigPin::wait_for_edge( pigpio::edge_t edge, double timeout ) +{ + return pigpio::wait_for_edge( bcm, edge, timeout ); +} + + +// pin config +int pigPin::set_io_mode( io_t modType ) +{ + mode = modType; + return pigpio::set_io_mode( bcm, mode ); +} + + +int pigPin::get_io_mode() +{ + return pigpio::get_io_mode( bcm ); +} + + +int pigPin::set_pud_mode( pud_t pudType ) +{ + pud = pudType; + return pigpio::set_pud_mode( bcm, pud ); +} + + +int pigPin::set_glitch_filter( uint32_t glitch ) +{ + return pigpio::set_glitch_filter( bcm, glitch ); +} + + +int pigPin::set_noise_filter( uint32_t steady, uint32_t active ) +{ + return pigpio::set_noise_filter( bcm, steady, active ); +} + +// reality interface +int pigPin::set_callback( pigCall* fn, edge_t edge ) +{ + return pigpio::set_callback( bcm, fn, edge); +} + +int pigPin::cancel_callback( int cbId ) +{ + return pigpio::cancel_callback( cbId ); +} + + +void pigPin::dump() +{ + std::cout << "\nPin: " << (uint32_t) bcm << " " << std::endl; + std::cout << "Mode: " << (uint32_t) mode << " " << std::endl; + std::cout << "Pud: " << (uint32_t) pud << " " << std::endl; +} + +/// --- + + +pigPinIn::pigPinIn() +{ + mode = pigpio::input; +} + + +pigPinIn::pigPinIn( pigpio::bcm_t bcmNo, pigpio::pud_t pudType ) + : pigPin{ bcmNo, pigpio::input, pudType } +{ + + +} + + +pigPinIn::~pigPinIn() +{ + if( cbId > -1 ) + pigpio::cancel_callback( cbId ); +} + +void pigPinIn::init( bcm_t bcmNo, pud_t pudType ) +{ + pigPin::init( bcmNo, pigpio::input, pudType ); +} + + +/// --- + + +pigPinOut::pigPinOut() +{ + mode = pigpio::output; +} + + +pigPinOut::pigPinOut( pigpio::bcm_t bcmNo, pigpio::pud_t pudType ) + : pigPin{ bcmNo, pigpio::output, pudType } +{ + +} + + +pigPinOut::~pigPinOut() +{ + +} + +void pigPinOut::init( bcm_t bcmNo, pud_t pudType ) +{ + pigPin::init( bcmNo, pigpio::output, pudType ); +} + + diff --git a/pigpin.h b/pigpin.h new file mode 100644 index 0000000..7c7a12f --- /dev/null +++ b/pigpin.h @@ -0,0 +1,92 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGPIN_H +#define PIGPIN_H + + +#include + +using namespace pigpio; + +//class pigCall; + +struct LIBPIGPIO_EXPORT pigPin +{ + + bcm_t bcm = bcm_t::bcm_off; + io_t mode = io_t::io_off; + pud_t pud = pud_t::pull_off; + int cbId = -1; + + pigPin() = default; + explicit pigPin( bcm_t bcmNo, io_t modType, pud_t pudType = pull_off ); + virtual ~pigPin(); + // delete copy/assign const? + + void init( bcm_t bcmNo, io_t modType, pud_t pudType = pull_off ); + virtual void dump(); + + // pin operations + int get_level(); + void set_level( level_t level ); + int trigger_level( level_t level, uint32_t pulseLen ); + int wait_for_edge( edge_t edge, double timeout = TimeoutDef ); + + // pin config + int set_io_mode( io_t modType ); + int get_io_mode(); + int set_pud_mode( pud_t pudType ); + + int set_glitch_filter( uint32_t glitch = GlitchDef ); + int set_noise_filter( uint32_t steady, uint32_t active ); + + // reality interface + int set_callback( pigCall* fn, edge_t = either ); + int cancel_callback( int cbId ); + +}; + + +struct LIBPIGPIO_EXPORT pigPinIn : public pigPin +{ + pigPinIn(); + pigPinIn( bcm_t bcmNo, pud_t pudType = pull_off ); + virtual ~pigPinIn(); + + void init( bcm_t bcmNo, pud_t pudType = pull_off ); + +}; + + +struct LIBPIGPIO_EXPORT pigPinOut : public pigPin +{ + pigPinOut(); + pigPinOut( pigpio::bcm_t bcmNo, pud_t pudType = pull_off ); + virtual ~pigPinOut(); + + void init( bcm_t bcmNo, pud_t pudType = pull_off ); + +}; + + +#endif // PIGPIN_H diff --git a/pigpio-master/.gitignore b/pigpio-master/.gitignore new file mode 100644 index 0000000..fcdcc13 --- /dev/null +++ b/pigpio-master/.gitignore @@ -0,0 +1,23 @@ +*.o +*.so +*.so.* +*.pyc +pig2vcd +pigpiod +pigs +x_pigpio +x_pigpiod_if +x_pigpiod_if2 +__pycache__ +build +dist +*.egg-info + +tmp/ + +# DOC files +DOC/dbase/pigpio.sqlite.* +DOC/tmp +DOC/MAN/* +!DOC/MAN/README* +DOC/HTML/*.html diff --git a/pigpio-master/CMakeLists.txt b/pigpio-master/CMakeLists.txt new file mode 100644 index 0000000..383c445 --- /dev/null +++ b/pigpio-master/CMakeLists.txt @@ -0,0 +1,127 @@ +cmake_minimum_required(VERSION 3.0) + +project(pigpio LANGUAGES C VERSION 0.71) + +list (APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/cmake) + +find_package(Threads REQUIRED) +find_package(RT REQUIRED) + +option(BUILD_SHARED_LIBS "Create shared libraries" ON) + +add_compile_options(-Wall) + +# libpigpio.(so|a) +add_library(pigpio pigpio.c command.c custom.cext) + +# libpigpiod_if.(so|a) +add_library(pigpiod_if pigpiod_if.c command.c) + +# libpigpiod_if2.(so|a) +add_library(pigpiod_if2 pigpiod_if2.c command.c) + +# x_pigpio +add_executable(x_pigpio x_pigpio.c) +target_link_libraries(x_pigpio pigpio RT::RT Threads::Threads) + +# x_pigpiod_if +add_executable(x_pigpiod_if x_pigpiod_if.c) +target_link_libraries(x_pigpiod_if pigpiod_if RT::RT Threads::Threads) + +# x_pigpiod_if2 +add_executable(x_pigpiod_if2 x_pigpiod_if2.c) +target_link_libraries(x_pigpiod_if2 pigpiod_if2 RT::RT Threads::Threads) + +# pigpiod +add_executable(pigpiod pigpiod.c) +target_link_libraries(pigpiod pigpio RT::RT Threads::Threads) + +# pigs +add_executable(pigs pigs.c command.c) +target_link_libraries(pigs Threads::Threads) + +# pig2vcd +add_executable(pig2vcd pig2vcd.c command.c) +target_link_libraries(pig2vcd Threads::Threads) + +# Configure and install project + +include (GenerateExportHeader) +include (CMakePackageConfigHelpers) + +generate_export_header(${PROJECT_NAME}) + +install(TARGETS pigpio pigpiod_if pigpiod_if2 pig2vcd pigpiod pigs + EXPORT ${PROJECT_NAME}Targets + LIBRARY DESTINATION lib + ARCHIVE DESTINATION lib + RUNTIME DESTINATION bin + INCLUDES DESTINATION include +) + +write_basic_package_version_file( + "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}ConfigVersion.cmake" + VERSION ${${PROJECT_NAME}_VERSION} + COMPATIBILITY AnyNewerVersion +) + +export(EXPORT ${PROJECT_NAME}Targets + FILE "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Targets.cmake" + NAMESPACE pigpio:: +) + +set(ConfigPackageLocation lib/cmake/${PROJECT_NAME}) +install(EXPORT ${PROJECT_NAME}Targets + FILE + ${PROJECT_NAME}Targets.cmake + NAMESPACE + pigpio:: + DESTINATION + ${ConfigPackageLocation} +) + +install( + FILES + ${CMAKE_CURRENT_LIST_DIR}/cmake/${PROJECT_NAME}Config.cmake + "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}ConfigVersion.cmake" + DESTINATION + ${ConfigPackageLocation} +) + +install(FILES pigpio.h pigpiod_if.h pigpiod_if2.h + DESTINATION include + PERMISSIONS OWNER_READ OWNER_WRITE + GROUP_READ + WORLD_READ +) + +file(GLOB man_1_SRC "*.1") +install(FILES ${man_1_SRC} + DESTINATION man/man1 + PERMISSIONS OWNER_READ OWNER_WRITE + GROUP_READ + WORLD_READ +) + +file(GLOB man_3_SRC "*.3") +install(FILES ${man_3_SRC} + DESTINATION man/man3 + PERMISSIONS OWNER_READ OWNER_WRITE + GROUP_READ + WORLD_READ +) + +# Install python modules. +find_package(Python COMPONENTS Interpreter QUIET) + +if(Python_FOUND) + configure_file(${CMAKE_CURRENT_LIST_DIR}/cmake/setup.py.in + ${CMAKE_CURRENT_BINARY_DIR}/setup.py + ) + + install(CODE "execute_process(COMMAND ${Python_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/setup.py install)") +endif() + +# package project + +include (CPack) \ No newline at end of file diff --git a/pigpio-master/CONTRIBUTING.md b/pigpio-master/CONTRIBUTING.md new file mode 100644 index 0000000..a698a89 --- /dev/null +++ b/pigpio-master/CONTRIBUTING.md @@ -0,0 +1,58 @@ +## Submitting a New Issue +If you are reporting a **bug** or defect, please provide the steps to reproduce the problem you are describing. +Ideally, provide a simple script that will reproduce the issue. Also provide a description of the hardware and +software types and versions used in your application/test environment. + +Requests for a feature or **enhancement** to the library software will be treated at a lower priority due to the lack +of resources (contributors with skillset, knowledge of the library or time). Unless your request has wide support +from the community it will be treated at a low priority. If the repo's maintainer judges your request to be of value +then it will be labeled `enhancement`. If additional resources are required, it will be tagged with `help wanted`. + +If you simply have a **question**, consult the SUPPORT.md document. + +## Creating a Pull Request +Contributions are welcome. To save time it is best to have an open issue relating to what it is you want to contribute +and to discuss the prospects of getting your contribution accepted. + +Your changes *must* pass the set of test files `x_*`. Please indicate that you have run the test scripts successfuly or attach +a screen shot of the output from the test scripts. + +In addition, you *should* provide updated or additional scripts that at least test the 'happy' paths of your code changes. For +larger changes the additional test cases will be considered mandatory. + +Beginning 2020, this repo will follow a dual branch model: `master` is the stable branch that people use in production. A second branch, `develop`, is the first branch to receive merges from bug fixes and new features. Only after we consider `develop` stable we merge it into the `master` branch and release the changes with a tagged version. + +Adhering to the following process is the best way to get your work included in the project: + +- Fork the project, clone your fork, and configure the remotes: +``` +# Clone your fork of the repo into the current directory +git clone https://github.com//pigio.git + +# Navigate to the newly cloned directory +cd pigpio + +# Assign the original repo to a remote called "upstream" +git remote add upstream https://github.com/joan2937/pigpio.git +``` +- If you cloned a while ago, get the latest changes from upstream: +``` +git checkout develop +git pull upstream develop +``` +- Create a new topic branch (off the develop branch) to contain your feature, change, or fix: +``` +git checkout -b +``` +- Commit your changes. + +- Locally merge (or rebase) the upstream dev branch into your topic branch: +``` +git pull [--rebase] upstream develop +``` +- Push your topic branch up to your fork: +``` +git push origin +``` +- Open a Pull Request with a clear title and description. See [creating a pull request from a fork](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork). +Make sure the base branch drop down menu is selecting 'develop'. diff --git a/pigpio-master/DOC/HTML/images/LDR-fritz.png b/pigpio-master/DOC/HTML/images/LDR-fritz.png new file mode 100644 index 0000000000000000000000000000000000000000..62655853dc5e85e94e128fb89191f05265dbbf58 GIT binary patch literal 42505 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 Ty|O-`00000NkvXXu0mjfBij1Z literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/LDR-gnup-1.png b/pigpio-master/DOC/HTML/images/LDR-gnup-1.png new file mode 100644 index 0000000000000000000000000000000000000000..6ec61943d3f6a8ed1341fef77b34b035771c511a GIT binary patch literal 47487 zcmb5W1z1#V*fqL`p(O+*B~(HINhxVWy1PT^21&_5UO`D|rMo)>$x#HPTe?J~yZe7e z-}gKJf39<#>zwh@k#Y9kPu}-h>t2uVRFtIgaVc>j2*Q_@d8P(I7~rpHCD>@-?Kn$= z2E1Xuke7Z2U88=bH|52EPjH-MbX_3m#x2xu7?hYy4nD+kl~t6)n!&`m4dL3hUv@&! zT}bwsxQ6HC#*DR3?BT@Gu4(0i#}g97*!tM%mGs~5|7_P1e`KXktM4o!8Crcdy%ihM ztythzrdK0Ut@G`NR>?>Wb2&f!{zNr0+YxZG2;}TNP5(t{@Gpn5{K=lDauAi#@`3nR?wGwoWZ}F{IA0(9y>Ij{!UI#c5JzHA1&03SPUg& zH>$B2{ZXP{Yd2B(qAi3$KEB$Q3Uw)h;Q3mKG*Ok8~-n2`9X9+4$~*$NV2*eU^wAik0G+iAc3S%gF}@BVUobP$f<7 zftDX5JMsRHC4}gAdPQOo(`m-_@#5m*J{=u+*u~t%Z@$yhQ&tgMu8%)|{>)WQ^P5M) zx@7*YHf8hLsXLUE5wxOUF_lf(eIlZhq7w0`TeaMDKX3Lumx`czV*BG!7lV7ipVg_X zAeKktb1*1fRarUfv)@aa#>&pFEF)8{S7M|UKzkPvgM;cwBXYBLPQ-mC)bYmxE?8xvLK<>kAr?QyNb-bV&4e!lv~t2W^kQ*Lb=I zwo+MSH6J%Om5?U~1B3b0C;Pn4%#>?mZ4>-ITguZ2?d508lbwau?s!()-HDBjjSAC_ zt+^IaA))Cc<{dZ(8a}E;G(9#oTT`{$;e4~6$1@&dCHfv~)MrPV-kl5yjfX$T&-4@=Qv>=k`E9KR+BCoZ4A0TPLTTPxe!1$J^U`-P?7G5pAJl>QYkaf2La`3by)p z1N)%;-R%G8M*ja10scRPh5y&P{ck}A5wUl%e|BQp1wkvsuvjnvuBp_5x5;HFAjt4F z0T{ZKXFNQGrMV#3pf1~Suc;|4$oQY1cz95u3e_Lfoc#$#WjM%U80Md!5z6Q$0?5Bt zqW492;Bn3fBws_iO8#>RIw^gTH(K8zxsc4-Z#TcvHGyNY_xxC`8^gXLIonesMezP(Mmn!GueH2bhIE{j80lWIz7!#FNrUW5t0vy)HcuQ zv3T=_iCtM%_P-^X9?Jg%s^vtxOlWz?A}{QfZ!Btxe)gT{vgJB2OL}x*{^u2M(o>0W zDEa-}m`)0W_c7ytV?%wkHJak#zGKQ8Ay!L@NMIWcBrNoBJlp~Ulq2sptQZpR*7QJY zk$4jSs>;>6lfJQ_lxs>OKkyc|pPP7o#Y3Sj6=H{&}MBxcWVcmIeWb>r)39 zRY{Q<y;^)!4JZE9)uG6>3y}I&{^}2L3x8S{jj5xSM$|$?A5E5pF z`|qyHQ`clD8g1JpGa4v06y4#RY9`p}ic92@yg|mysu<1Iq|u$g!mb>MX^n&|p{o;9 zR-L=Dgu>aQMJcw3JAz1yDk4NyriMWe3(nuI#ar_O?B9!p8@5wM@J6p1MkNi`YKMB+ zXh!89q3kx_Z=RkO7>im?JrOpPjx0FLpC zSO4;(e?!*-WLIF>`Y&E|Ixl0{b9> zx^n7pDIq!xns!C6=Y;ehu}P)d+EhQ6=wANhkiu3cCJ}5i#Vb2mB^?bKw%ypO3;o#~ z^YFq#4dd+>TAwS`NJuO%tj>>Ci^^PoKIxIq>oe`{<)b#TL~dEr4x2@(xY(7> z2bzW@zUO`?*?bT(6kfjSo#$7Wo}TVF*Q_WCu)%U~5*al$^{rcv{jYo)W@b@9Wq^lj zb51=8X-SEg^V47d!Sq-?nu|-%9dW%+E4=rXeskK|Y=&{0<6yVrtc{(%K$&*w*Tefy zX?@a-nzqg6Wc?On9NHrggOvNd=;MmbUV_kO=^FC`hw^XId0>LUC*2TKWO8;{M+ zzB_1p)h`O;E~9~%GRi&tDPEh_d!ypB%QCNUrRVNX%_1%PnR+*n`B}7zbt=tdQ4maw z4;P7#Updidhko{X`QT_uz*Qz1_XY|1iUE9M{MYHQa*az~DD-IcVt+I%m>vV8pj4@> zx$usIie93cn(Ik9qk@V_`cnxK;`{#oi}#U=@STl`uI~eUbNqo0ZZ(ya8agW%qznv` zwaR2hR;~!`QVpZjc-G;i1Qt38H#e^(l0FQu{?cYsg}p_tFZR8+n`&3T0N7zVm?_!$ z=M_rIs#ou7{aO9YXt@(NAsB%UuN)UVtJgG%G|-3@YB zXurebQA&hhz^5s0_9Y?C%zwyg^hmbK!nz&LQi7jf=LXptUrSW>nb+c-@H=^B%{FI# zlFKQ1^Cl@S5h0;9KA#yC2BH}f`Bg2dNLh#U9i7=gHaR(<@thBMbAv31pV#8TNJ^^x z1E(oft#l+!N>tR~-x)6~q_1ftj?Oxs>Vq0>;*K^{&9dFMM!p0l3XEbSL3@YWShTFV zZqGOe6VU!RJ8bvUw)g%`Vd#-UguucZKn8#~tMcBVK{2{LTwO2m>sK?b&KFVHV9?ET z;@QVyl$jqXfNp&K$3lG|n6Sv-UzY2m>lX}Myb<5yg3PDZ)|4U!E!R!%n`#p9JUCbl zQvThU0YiB6&o3dwf+r9Q-d7Fe^*RdDB~aWwzib3=WsM`r*urb zfk?mXt4kiYLQF!3S83m64E>ufE*U!em6e5a(yk4*oASnt6FReZ7Z3Xc&xX@9w8tJn z@`)mbwbPmJZt+-zNresUESydB-@awq;|PZYLeGC1A(B#eFOTQ0*NVzg&z}81FqR<0 zN(gdFkfs@&{%j9Ytt*0%T1_jS##@0(GE`Nr%TRf}+V>lHNyF19ul&Z?FygZ1dWa1=o)mk44e-4X!tA z^E&t(r_hH}6&PQs9nY1e2=X}HUB-Z16V(@uq|Hq{+z`XV!|Y85L+$0WC$7N+)b-ZG zj2)Z3NqmHE7mj6ziy%u^#l_|~PQPsy^+Z3L7YA$e!Ux=NL?b8rA)C_RATDln_K1e? zbt9v4{37-1PP5_>x0v<=md-ij#}+I5{WYe+SBGU5)bpgJO+| z3W`a&7d|Qe%{>;TzK&Y)72JG0nq@7e4O=$x@`5pKnMsa6w2eX9(t?*SGUep(tUrK5 zK0*+my9YJjB#lz)W6Qn_iC{o}R_g#i*+8*XMBk5bSVYK6PBd!TxmkjpSIgE{K9Z8F zuWx{L8hvo-N83KK8|gO^C;D5GZ1r#~E~UipaY?#-c3EYZc zr%!OQK|4}}xxp|Xp#Iv=emp(q!Qp&h{iXZz42ab1jp?Qxu_?ZZSYY~&XN#X?7w{$t_OY^7us-H(6rPz5GGV|yFhz~Erzl&1RP&y3VpQZB#0J0#4M z)(e=nE^lpAbR5*Sq+B`d?iLnC&y;3J#HIFu!AfO85JS*>gN=<@O=0!O_^Ga%>^lWU zO$~nO^jb%4wP>#c4z%(KJ3I8v@3rm?7ne&q2_P~`1PiTp5E6(~okvm?uuB94XA|+H|*l#PF=D1xixBPLc%ql-}|2{om~;# zT^f3YNU^wtqU>j~vW10eR{3AQ#>O$oK2Tm;Q5_wzniBzFehv>wfP>Tb(djRf@WhnH zs>^<6ZoW1#Ec3OZ0vBIX=Iv7nw_k4`k!Haktj+0XgFbKJY1#qENeqj-hPu(9Jrkz*Lq5EjENq=Es?^s(ij@=!BgZxV`XmYck z`JOWi>PJQ45^BHtEGHj66+vVrD-m2+rz0J)5-m>;MoC$;c8FsRiKyv#T&>+ZXaPBHsF-b!$)9;d=B7;xV*xVe< zjc1)R1HJ6KcXBc+l5dEKt6x>U4vb5-6OwuM&)&XoE&L)_)N0>Ci9sxylwHfOna1yf z+}~cN33~$s1cr02Sqh4HI}n6V$t@EQP^m-D^ibyNN(!s4UXL+GD%|GiZu2y(ukS}u z88dIZI?ns-*J!1Y_>o9#ZU{=XK7Dz)ENba=?btkMTlPd$$V&r@aP0)N=^_0yA|hPE zv9m)t#W=GtG5NDi$I+sM(nhs0BYR8W-Xtv5uGUqM9T#9VQBm#w3k%F_T6%g_P@_}E*RR~pnWfE>ZKh|x zv0cRw_vvb0=Fs@*fSG3rjUiG|#D|fiCdrBPXk+kbv&4^=PU7Ro!qOkn44Yonm*?U6 zpX@$%b-Nwpv(?Km#zgr6PAV&f<+-A=C^hBdg083b^fkzdQBiWTsusDSf_CHS8+J<1 zPj2?F0kV0vLTAMNhmt87d5S9wFP*9L@O1TPSmc7ma=t0x{FH~MJx}DadK5}d$Xo1i z>t>y7)P102HOc)ZxO;968@aI12l>pnB?{Iy!N$h~kkM=n3N05o*;??O80EE4cK$aD z67?=vKzoXpuB>vKaci{t!)sGErdI_Fo($Q^g)pQHm@4%bfWk6 z!`G2t5(a=gl&%lP*dTdrEsW2G)y&N5`^}tet4%$_S2>>?Mki~S9}WPl-*vmhaBA=B z{K$I8gy8{z{)WCa?pqq$v$(iwX(G{P6`FGFwSe3&a*f^GSdJ^XRh8>_yS3XUbyfE_SB5!vTl`ht0d+lI~ z^=Ew!7@|4Z6jpty^K060U$%VA#qFA}rgobs!+KalJFlC4Y^1cMQ^=2WMMqj zP#Zx#T<-=tx;b6YFRJZS4){0-T=Chb`+~n^xzJdx$2poVKdr6BCfQO|=xG`&LqU$K zsSRTKC2Lb-Zjh2vE=VIQ0ACEeV`h#`7%TNAC1qw)VqyYB>JBeJsFG4^O~>H5(a}o# zHO|h=4^{k{hlT-6PxV$ho?eWn4Mv6VGM$V7cnYj8^Q-4F{)q;3luqEJ8ih$HQbhnn z+QKr?s%^ht*c3@%R1uEe$A*_{+MD&3;sHN@ayukPPz~Nvwp!CL^e*{PI=Z{KiI05s zDkN;Amybo%__1aEQU?yMn#|iW4@5AbwqZ)Hf-~m)-b*wNAEjfefYL%WpGL5-5ATMD zgz|XqP-G9U*@RP$+I^Jp7CKPr-lakbUpuT?MNtuxTH1MgFD0c}xHUpa0l46HD~yhb ziyNIKaC)Axx9>J(4;ba#^;SEh{j-0-|VOUsrQisc25 zHz8V4wuYHg$HtVGF8wF+D1{AKq@neR1tKG5W|s5wi*{WMrxZ0>YzM*!wLrFM$4Jqb zb+Zuf5AuLiF3Ib&gdlvEMdfGE(eYS&c>Pb@)AOQYg=l7GGu~SWacD~@n9z2jG9JsG z_f3%8+%>)x?Q^P1@C^BL-%nzd!Yp z%q;1C6MUygn)a=Mty?r(>vRLrLHO!2Z;6S+_!^d${WO9pnd`KaI^acOXmtyW+012E<%ZDD2FG<(8b73ec}515Isi zQU-{)ejm@INTEQ~I*eXlL^3mDBX^z{3ZkXNWbOBl{V0j9wg~@G%n9Ts9w2V)?W=p% zeR9xrb**Bj<$TJb-DSs1`StnpuCAAU5S!_->3gJ^`XJ%@#rygun={3aP z3Px>;TCDj*N=@yClUUPl4jlv-7}kqYV=zx71k}ASAzz4%Wj*YOT@QVJIc@Cfl9^e} zAlb%tbU;jVo~6DK?sGUQ1zpW-AAGwt#6&j`7gwoMZ58#qM^!iP_SbT_H`J{j!s>3IIq7`xI#7`cx_|#RrQ9v@W)j5uTK%KGrC%$B zMb&Oa%*@r+F}!vvZf-yx+k5#Yczvq@pzTnC^4{F@t;ZsbM|!4$n86tmnp!^|K?w;g zj}#Ub>^GeOEdK|6dDfG4+^(xLYNpg<&W)zH(B@Usi$6O#2-0ot9a`MAv{`Ll?PlS@eo>9|hi7BwU^@Hc0!`*Fn+ft!uLdZ6B-*^AJvXaEnR4J84h6vb7I}CC+!cVRQeFKC&FQ?Y-MyXX{eZ^x6)w&o0%l_c zA_y7WNk^xs8)59L>3>xP^jUxu0O~*MROU7hVQW;;ukEtokxDmxp<%Frm+~>~F$5qz z$_s#uCMMPsk$L&Ditx@h)9PL~&}x7tF;P5PL_(CIEIJxS0m96T2WYLPYQ}&HSU%&N zB{~^9QP|yE^4%qpQ)0^Nsp#h@T20()87abeOkW2oCf7nsz~Lir zUxEfFxjkY7l@@brt%;mjb@(5L;aOgP^7lVIrFh&A$RQUHs+pNi17LNkK8-ZK8ltD~ z_GR=E_x2AbZ4)^q_J6PLJU8_FEENtSx`6Xn@&Fn>C6BohEZUK@EBY8&T0bzZ+JB4M(Th_PRWyVIsCE`rsa|qm7aUkMofU4l1JU&Ca5$O)gxmhq$_caDqCz<)Ca)viEL&lR zWFkb%nOuUAjop3712-KVjB50m*XSq{o6^URKw7!O*JTFy_ugI@0Y{@)Bn>66f~qRI z$;tafN(_t?M(F&!sL{Z^p{rZjpL736zw+6w2b3{n;hC8lYWIsqKa)IF2m`hEsck{G z!q7l4%X1=!>knifTNV~}S@HOv74%pbdKIh(*B@#vwgZWx*^n^?4GvaJbc`d1WA+^jH93Be{s}YP+sYO*aq$bP$KY z>sFl-uQO}m9kK33P=mao?oi5!#>yn1H!)#31#`FFGgC}+n0CKVtg=)tF|xN)@YQ?% zy#4wHkY{*@VW{HNJSZpGX?fOFRwm2)lzo=kZZ3jjtw7#)01T}G)iENg4u%1FdBKhI z=Dm>ih|v$6Y$7DoC8ix=Kmp+7+`>hI3eV9-Jk}j{CZF8s7#t*uRW-gb6;Eu-EM#6b znGK^j`*q9Q5~#$?zuv&=OcMmrW`+ys25ykq3}(iI4+N1lHDH=97YIv5*Fm5jfQcm4 zc^6i5+t2pkNTTo)3%5IB^cQois%l}WmVL?V*ZJ?sFz1(3vxs;6^4t+FE^$dy8@0xg zZ-{)myZVl%fM(jG;CopE6yYb!bg+(!=XK?t=dfEDnhug-7udRS1&WYsYt;cEKCdi(8ANFlV{8c)FvHsv<;tk zoHVu9k6S=$TWuwL@>zfiRmkttlW1LS@OkotnJH?b_$~I~`m&ELwxipqCgl?~CZ?{Q zZ1SC#_K{)$rcM;cJcx^RwSd)q(mFo^bw2RGSNjK3bAS?oFr>g}=wYaDydu-6$R0>f zxC#jh?I4b}$IiFA9kit|^K`H>K@k|K+uc8g3@9v!GG6!BRgxcmOC+ag&iF(7*)y5@ zQ0s#_ssM)#Ol_^M7ph{2b;z!^+sx)L>Uc}D#m{R20~E0A;wOqhgo|a$^Os9)z#PBF zuLF|Y^`$Werp=jaTNK7g+YSKgTMBe5uhcVjghqCKGR)5J(Y*aG;*WL6ut>#NT_7Mj}KHlr(p%nz+>(a++vtIgig=j7R5`A`ex zU!VIQo-Ceqh;rM;i(G10Tla3wjgQzXLk^8DPhV>l?^LJ%&O6`M7DE8y*b(6z5AX`@ zC-YD_IoA#HFZ&zR(jkyhCMzY+k0@Z{Hue;V;|*2akECoG<~dr$D$o7_<%YDhS#M>Kv4K@X z-;s&uFj$B|x|@$<;DqC@*sTX%M$aAVWtBw=ntf4023f1ASx_j)n^ai%5OaVvHdaOr zaDqVIB=?PhzLc)MAGwN@{3?+mh0crl@s6BHBxD_PEDN__{2T*1#~{oQ5eYbnMIUX& zP1tQ9r(d9ZEy-Q}Bm=2{y*ZzR3o14@1iIg$ABVOVW0GBd>e*_dCcBkfdcDAxkZ1jM)S%K{lh%b z)ta$<^hT{vA}eW#_hT5ai?mNvNSlNb?1Yej%z%F*}~rZ-2%AOCP#(jvfs1S8+E=HaoiN{8dQvYVT8B_&~)Bq@@HayBmOAf=!q zT^yW0Wq{b*)Iu`C^S5Ai&gcTnavhO(8pM(mfF`@N)LwX^EHe0kv)w^6QaIPPG~;~< zript1$U)8BL|(u{G9xGZ4inFc6j7q}CWx7}_k^7u$l@cNWB3%AVR&5-`>&VilY=mt zCu-4yFy17R+u7-NbxWcT`uzp&H16)!?*gzug3ILlZCOvGQFvaJX?}U9I0P_O$ zZ-yLmEdECd-SJHPI?ta^HjL?9W6}~LH-a$AM(S=J1m0h$t_Eh_t}G43>2Hj(s)24W~~Lqa?Lo->#$E4=%DN-E6dCV zlq5AmG>&;w@&L?wONfTQ+#Djfk;P#}0g8G|@J1Do`$N0$%7WUexOh8ubr$?$r`2oa zo{hVO*YOW^<<-@^!=$Ve?V2af_HyIS8{pG@2NVLutElKQ^xIGmKqB zzv%r&_RaJ_7YgArVwo(Upl3*vllbFUSlKA>patO)O$Bc#zJyfG<0VJCL2pe~1 z0F~;}e3)y6W>K|Ylbrl$Z5cE3ZA#`C*{iE|Z0-RKlXOf%3tY-s3Ph5_YfUYSFtOl& zfKm!nSWJSESIZUs`-I0;X%u{Z*WQ4jP*OhZB$UD;-{B6oMNkVq)Y4?)cwYz^TI{}f z6AVfs6%`@x2F(*zXFNz~N?)VZ`#3%ShHXFR;QA6OQ&l&$dp%kWH_*)a_DuGy*D-ln zv`%n~25cxy0Frv|s)hVxv>IP$WHrV(%$ zkn@I_BX^#%@_u=FAs6;;;cVG~^Z9G7vRph6VUE$tv*31Bzz33JWw1e)EvoOR7@>qZ^=g8B>}BGEv*8h zy6t|F;?fdWZ?558a++Gqj8aiiy%Au=pqnH!^8kk#`!DhUhl(5A(`FZ*CC2@19N=Qh zal4SW9BhHNsY|{-9UXNRH$iT$t;aep!e<&j^4w(M7e_0UbX%yGA^?{ZBtO5l#648%7 zpZ`#|q_99$BNm9tfzUKHf`M9eb|XCto*bW>oo&%EfquhYM()KTre{)@Tozo&tJ?3< zc5T6ZIjzio>LDD&m5;!0RuWD8=AVb$BP-A?L_i-7lJ#ZxLM!MT-*meFb;E>n2R1jg zN!fxvXU9Q}I;daIB?kE^V)F=6h6_*ewLi7#FFk3WN}={HIUD z-k71Aq!*z%U0<2@()Qc`5}&AuzB!w%itB>(C=kwD3=8J73?_Z-OvP z7!#94C^FC)0~qD;9D9RdP7X*!%KprFfbd)`Actx6^%M^c^{n$P7hg*OB)>g0TPb;UWoHWS zzk$5E0&oYgQsYax?G|Nd>xH&af&EmNr~)V#dD=q}5xled!T$hoJn#xY({_~CWep6~ zub2{}yKnP~R8J&R&%eJ(LdL@Jo(Cyri9Qd!Z$JOp za4#_^`1VXOabzt8@FQ2m;N&V1Nlp}<+v$>C#cMExv9ZAN0?6~bTW+(jfX%4E!**T_ zcQ`IrVS!K966>%1-uLQsnHCsqfF*l#sul|!y(f{U+u3LLXIqh0$z;9TdOWK>a4%Ju zbw&f90SzeO*p5-QcIJV)7s#HQbK62gnfJJQN|Bvi!#@Wa(S zAV!QYB|MfNnt+Yxkg#YeB=PpXsQA{=A-do5*x3KFX7S{XV`GKYVCJtsFG=88GOVu# z11Sx5g0HXlm?;(iU0MCwwO+o%-42j!@cHtyvsXnQfSPYbD+PjD8&zRvXzKtQsJ5s8 zxPQD3hbl}bD;>)hVlay{8)vi@;`_*22lla8|k^)AGg!z<{|OGR^=;%iQg`~DrSG|~IOBh9Er1L^H+aVk&G67awFcaI4!7Sj`n1Hdd4Bt{Fuf0B127+85 z77!Id4HYOO7oM7$);;8lLuhySC?CI!9vadxD(z7KQ_gk+DK3u6c2|SEp^{&|xJnMN zsjBuK`9k$cZtJ(Hiaq9dW~V?-&pNN$;PO2rF}I3@_=LB>v6Abbq3or4HEWIgeYRc~ zzmpt|%1yp}UQT7P2B$q-miz3_`R74(A`GIU0roOrE=~2*19S528Q}X@=b(-jdz;m` z^p{yq9t*D)NO$tXqE{L7CZGus|2U$VfjEFOq*Yo00t zM@Sp4q?FCVQ&|u_g7AU-sPjQ8Qp>IwC}P`w4>~2WJo~6Xo6inZ{hC8jsC}gx5^|bf ztra@lSHHd*!Lz)H2yj?mFXQp8FDwKKS+kL!Uu?D@Fz$We)N4tVOV+}2MHmv8)$-=p zbA3$p1BZsv{OVIWV1$cxkeXLLCZQG}S<0-snHN63SD&wT34wPj!AQ*yI1fg*X4q&R zFi2ux;9?KVe`${r52QzxxcE(;83VjQ|12sBhf8BsiM&uHTabu4cihtfV9^$uys*DA1C$ zIXh$59gulH#k&-ECOpeSLJoi$UM?QZ>oD^EUj3Pk;zwYZdiPG?mD=fPNa%3C-|w@i zJjLOIRaU~>Y+#}B^8)3m34Sfz`kn<8X%qsJP2Yn^V#Z;P$8;PDTPW%qDLZMk&Ua%q$Yh!g~^+Ct(z3Gkkpv>5(#kf*XaOFtB!wjB8yruHc{@mkb+e{ zSe!2Xs_%G#|7YF~?)2(2GYeq#Kuc-+wsNr#jJEV`-yS}hIMjZEw)2*VdY|fbpr$56 zjO>>$%xvzQbodA;%mM7D`sA5X(F^gM98l5co6W!V;Gm7HQg5`Dy=GUa<*Eh~f2gXT z`Tpw{bpXBb3x57wsS_KOap3BEnvI*sM{ok399bNtSowNiC{`8lpQRV?}j3 zz$$#W&S2e3DJd-|>OHJje>4dkk|WPyb%X!l=v4(JVElX2evx5izf90_$3{>v$;q`j zcmJIxtfLSX5`u!@PJtIbp!UrqyFSKp|0x#1L&o;g31G^=AgjCjnkvk|#8w)Z)_=0A z*OZ95Wos)M#~4g10c*ZMoyRhwJtEHR*<3X@t^@?Q{CiNd55jNXY!m{1cz7CBz=^oXB$=Iqo{Rp35R?(KCrbIfRrGBv|pd7T7(1HFp(1MWB2XfZ_osE+<0K*4n$Os z{QY%HG|&u9x=C|#3hMPp<*OC}^10Y&ip=|C!ZSy$Z+c-vV6fVG4qPV@)IityxyZo8 zAlVvJQwv;lpQb=$(NA62S&&m+2Dc^$^h4Qs4*!B}*uj{vb`mr?DbSQ!WG`_1@%(S?MG`Wr?7=rB}JRHXQ^;Z0U<|CnpYb zggysGc;8qVO7*(KOTO;6ph%9=L#XG+IY~%>Aq@C`8n%DXUgzsOj(!OQ#H8bg z1=;kh#%v9Sa4a=K$6M5jkOQ3B#IvEsw#MHdOGwG9-l9)K=YyI$aOTIeYpc8mYMxw3 zW+sTwGb_?SS8#7oN}g}S0@ZOm(okmRhj0OjSD!!GfeP%|sxm;66{hA~sw9pQSaphk zNN<9aRON($s-6pVg2B4^yf# z4F;z!%(Ax{)lJ(~2+_(3U!YT>&%5WBj9y)CO;%4(mp1FEs_K3E_jv;_DND?G*%%Gg zg;HD2Ou@GiTEN$u>rgELY;h|>y!u$^z%c+szo$=yRx4IfVFNP}W4?oS zOp%X?JNAVqtG_=FH}KK6wAk1dV8O^mawPk*y+x~op;W;T9U&l{Ex_1Vr z4#Yq@u?QensEmCw2D6ypFhD_XA`CHr?e=hy*0ztzekwOoWUrA{h*t~v-=;nzg~cE# z4{0p&6q9}$-<^P?tsIcCKs%Z!DK!jdxS;K+yh7%joSMToPo4nKXi=4`q$!4wia7Xg z{K}$APVP2!?>i_t&i6bvP7(^bGYFG<;CbQPo7B;OhQ^`OhhC;-$XZ|y`5haw8f~0i z0p}pTG?va#FQ4t;edWttT}(XJw=LI(9<#FlUOiqdJDjHuXf#-GF8(>rO3HLbOiNd0VEA8Z@h0g0+gA>#nDabi0B5KYFmRx z8)}y~SKd{9Gk*^nf}>TmZ~qK03)|YH1x%-ZlJ8AXb6$1rQP})Il|q*3lglzsO)GfrQ-liC)LNN4s<2$f3Jm`OBBe3E-vRoG*oZ`ktWTAvlx^L{GqbBOE4R?oZGz7lIQxTc_l}PUuUW zDb2j!)~1S6M|N)Vr34l2!0?rsS3NndD=dwlcob7G@z`w==RYris9(|OtKeG?!sv|s zOPJJw9Y>Fu71);1;05T@q2^#K1VRc>P%sm-nwHj>XgDd|Kt={GzWpactzpCT?FMBm zLYvc<;S`H+5`rE;aLclE#1T6fS`!iy;MaBkgk}7LNR&K5{G~359D-nfQ2K1!|L|yP z<{_l5$wdDRRU`luvo3I^l)YKSFol46h%VA|f#s_hH7K*RR4goN6%POh%&%L_3!y0O zYQYGc(k)m$%NwlzGQ|z?H3jzO24QZ_vW7~|`LR^#Y8x)SDU*?r=|1cS#_W|;faDYb z!@A+|MEo2Mk}4zA8eUk`0CvDc*2l*H1QZsz%)lHdfd$2^#%5Cwh>8`an#Sy+js^rb ziGOM)=>e?k$ti$z3a%Fbtk~-(4)a0-3LAn%I8s9mP6<*A+Z_0@umHbc%mYKze=#sl zSzoDUI|kq;@UVj|*fp?LaWi&66ujM{a!3a>Mi$NSzOCo5sTl`R~ z35{bqD>s)#J6Yh$$!{iY%Q$@8*0GpHwuiqp4k#FBARp(O>|{d3f%xGF#r#QV_F5~$#|hkO7i#w0)exgUrkU=M%n^*`5>*sbOHTaL3A> zxI(2xSzw3PDGCZA6AXsFocjn})y=-j(*;F_;lV6Q4y30%5oIBRJb(y{id+IKs|Ah53)<*GqP_q_T0=F83{ zHRCi=);)~*c+wQlOm@isYF}Ux51hlu_)-kXSBrrb(;2D2fX5LP%OADpL+35)#k*6& zjV+4}^*t!JyaC%|C^F&1vCwNIq1EiTr>qpYK6w%fFQW^vqk#@ zJbWe=mPv5#dFW>w;9f@CBe*-&z-Jt-r(fgeTZwMMj6@osagdmB7`BG!=>zxC*QZji zp&kx}FZXn?$Jfhj&)xl%$;nmxt{yG$5|fw&OJHDhedmxUyN2u@vX177_J-ghH(=xZ zT#!k9P|e5>ki3HeKyDGCAu&NOE>pg|yh`QZrVpm$WgT#DP*Ve1Cg!}lQiko|HyRU@ z2-t^Cbk(F%>i{WoKtT&bp39u&cc2F1L+Gs0;bAYa!~VYM01$z@9mZDjE31IdE}05Y zU-pD|Q+Hu5gLBFlC-B z3r&QyRBSYHjzoF$5zpn>*zXRh8`aL`RrGnFG~1|!ZgN+MAN@wpc=^M;7-8f*uME0L zkD_v93nav!-=kn|Aw>uA@q&%MZ<>WMxuD`F!am474#(?}^cO|#5}lzhf#@bGATpRb zT+qJe;m;4l%gK{wg2qNcnVD5DJ3d~P#DuCP`KJcST{9ZOV3T`Z{8%>@xP%@h$misQ zp~F7lf}G`Y1L?<%l#l?25~QTQ!FN{jBdBAB3sMAuzlGP4R~g`i{@aLx2hhDN3`)@0 zl|)wdNcgDOje~;(401GdO2L_}oocbXY;0f2{ z=M;6Y8~ND==+YftP|as3$d|E9wQe^Bo;Ng(4;5c3!%@i!bYWPS7Iw@?Y;EYblge9(atm^j zASmE}arNHuShjEc_;ufAMySk$P%5*G5K)SZ$d)Z7D=Q?zO#@j`Mt0d-+50ZpWUp+p zvobS($L0Baf3Mf~>yPL4JdfLTU)On^=P};L`*_kL1;C zbIHh{udLW@=c4e6Ox{gWd~56cLf2RVAjQeaATgm8t}GeWbp}g@*ZA*oLNr|6j^W>l z5?Z+yNOOJR&S_Uy`RDdM_89~rqe@ZnxfKoDx#f3VJFC=;#@8GcJYUPA+Cl7N+1OcNk%%*;_%POau*7UwJ;y!w8J3h%}0t$A;3 zSs;6|urNL8R#+IcH#v36Lz}@AFMSFq>EJg`lZo zGY_VuYGjKrG2%SGZQUOxKQcQ-|DV@X0t2I@jKacPH#A|li*IOzMXWs_ek+NGJEDvF zQu@%(j>!1iy^s=J=#L?%5JFfw}HG@#-XG=5&@hRYcxsZfI}t zt*c`=#`Xh=iEb8PQ%FNN^hJr7Ci{t%5M{n{=k(J1*Pb;k^o$Ve!Lwl=-uCimnW)_g>Df6VCS35Du75MYB7SV`wX~@DICXQGYF*^c zzke8_u}Zf>>yP2Q?`v)lxhSV01ZPQ%cjCV}Qu-5vrx9q!-bIwzVQn%LI5@rz!W;cn z1eJYAU}`=EduZ@iCN(MW8f3g7mbbJ4yxLl1z`ChTTQ8a)$<<9BwC!tX2;habc|~AS zo8%zX`$eD(5o+jmcP6%efl*w647R9J-w||YdWXULRiRTRd;qqaIA zR}1Pdry?&l2cT*WSUgaDlD=MXpB5~eJU;pqh#;Mx$4x-?V1S-?u6(qI-!r{VR#U_L z8#e5N`G^FxfMjH*juO1s&Qlisw%2+_0~x6@INZtYl6vBzqgMp|qb`g!xKJ!L(i;3 z8FBn&cMkX3-ec{oGQnrmeCkwN`}UfAYSsK9ur{k6dn~(M;s+MS&S!s!xIT)xAwOF| zs3(M`^6y)g7x(xg#IL1ZU(7BB?zV!$|8B>igqr_s)a!!1c;@lH4RzXtM%_C^!BDx zi3rWUWEE+~;odS7)_(8roKg%~?Pyz*ilk9ZE|J zNXZF^{{;TG@y-+?6`(-&G~i@FQhwWYx3)ORPm)3R_Evm$dW(gGlCpS4U&4;30D0kOKjo&1OXSCe}>oB2pH$Q@evkDfkGV?SRce=RaMZ7cyn^{^XJba zBO|Z`Y^IXwm&%g!4@mQc_*QOPiy2 zH0gTod*PL&J%2w;q$IxM7<7d_A08gAt2Zz(_;=XvL;Yt`kfb<0bW3<|(RO1sIGUA; zat;`H@rR5*>Vi8v*|2#@z+r+`HTT}3CXj!cRSgT9`!}=kn%}(fgp(ui7bLf0t{*_h z$pVBt{0Czsx`hgJb6*EOd`x%Wg|6-VpPf#9b2|$g|JoKd`h>+ZKrvxE!DCxyBnIqV zKM9x#-}9Fs0p|F_Q%)l4V9&3HahYlgTdvy8SzYbT*3-_>XZ$rOxXQxy+%xOha_{D% zrPcc+5*Fw^wyC)6TWzSDu{A=@jyyJ-A8~^d3ynIzH^2@z_;w!HOJ&C}XX_>#?cD@- zo0;2tG1Yv_W`8v}wBV8dhh& z7BEtXRzh#t@^cw~tN+T|9^&s7Qbx6M_v&zgS!>jLWpVk=C}As`>itc4wbGc9EMOeW zy*Ul~EM-&SV+T8X|K{h8@!5^oy@UqtXT!q#hn17Z^WFX(?j8aR35;3E{Q|&+hq6Wt zX=&xvWZxKi8qCC59aKd?)iGZ^Hr7GZMZP8g!d9kYz1ms|g2)_`%Nn>4YK*A2%#|(A z2Nf(&UKl5>fo4okPfzUg>5p~wpzW5q8e_~_&r?@dU>ma@#@XB;z>O#N0ZpxoA5P)k z5eV?M`~G#ji_{INV(LC1EoXJ!CkqhvYN;o7DR+H+WNEAYtQc|{I}^LZ?|c7r^YF!f zS1XhyRH5jvpa|U_W!n#8J<6_JX+d5LJbHgUz2;NUaVN)iJJ1J&7*I`2jL`TM2Hfkz z0hv5@m%F&Lc}3vM9Fna?pk!M-s%8I0P5tFAJsp4Vz+<^TGu(IkjQHiD5I*rh_^Q>2 z1j<6B)mCy%8P3V!E7kux_*}ClfX87UBlr#`(_Vq2dGeFv+gxq`PUc@(L$b~)! zKg|<(=I*Y68;AeGh}tttq)jyoOJubu$wLSGSi);=d?@pAu~@<}U!GLd;m>V)Lc~gEEqVI(7L3DIWn9 zV7$&$cCROk4fNQorEvUn-abX+*AwZ(Lm#NBFa~JzDa@9mybc-beUei0Ul_}}mDMMY_7)d{f8($dlzvt7_or9N38ZMyW79>Z|* z3vlb10lDF#PF07rpTHY3S@?E!jO;p?nIQr@8@?Jiv=~vZ?jvvl&YUmLCc<$ZQvRpE zoloK}A44}|@AO8~T=&;U0feM@>4&NqS*3fJI%c@SDGl_uy}vTDcxX=voPg>np)sc! zVnzko7`mz^4&rkFv@!UWgwRk@aicr80DWu{$gr^Jl89Pb&3VfDa$iy)lO8JxIsf1s zmmC4XUsuLsuUH^qGF3pYh3WquqpYbdNOAOZ7lsIqeR+_tN(k2-{}87P8%qg+f5#ay zV*(kV|8o$IRLov z8_W$;DwKbs`Fr{Vjz%2y&?j*pyAj<4G{t;LXa36CQ3Fmv(*w@2_i;bZ>YxB1lpV~- z@yy;t@R9mOE$1R@5n1eYbWOtJ`;N#GA$4bU0PKF7_5p`liVLQuOw38yM4!f}dD!|9 zB_f6|-_Z{o6)SG(kx%1}vi2-*nLL4rLUs&;dLH`jP4s(Y8o*+a;`7LK6E4GVwxquw ztvy^WRYkU?QRl~?q z5ZHN2)gZlZ|68HRqu+Sbng0+$_f><{?J^>Ji6RVo(qKPCoC91!1PyQpsCD{5ciZ@t@xxm$UuMx>raZdh1T_yV%LQZfc zhM*;Z7-_33=viU#75Z;^It~LqqIqVK9b$GDst?q!(QSn8gAjqE6=+&K@;KD?`cH1P z0Af68!ayA}VmLJ;NP)hwleH^(6^1Ab4U0=d1@?(X@BV!z24nctk_|206^ck=-gZJ` z#Vf}}pcEyY1m_39FvsjWL=0V@QA3lo=^XY!04_$*L5kP6yJZb0ni>Vg;coAVi-T|@ zirK>bYy)OM2=?!!ZUUT$?%tH=YYfEjl)i~?y(1H`0n~P6LS{GN{94PSo)rBP&b0q_ z1x9qBu#g7!F7fA2nToe>QxH7xL!oQZ!~zh5!Ss6r#EA06WJAHtfP1|l87m1dhWs-T z6Cjpkb#>i+_3Tisf=h~`tMcDoG_=hH4X5w?az9S-wnGRWaI|1dI18^jW&(i?LSwCU zDGrt+e1Du0RtD~x0zX82>}kk*8A;4h;tjF!@uTH|7uF()ln+x72#_y%y>gL8Hv%aK z`l!8vS3bwFh%x{F=29X78({pra(+SG<2r}e90BT}@@gF&8*FCo(H$)aHo!%ih~b+< zIUv;C8jwjDW9@E^k($FVXW@^JehGhW$WnuwOHS^9_kUC%Jqp%O+_vT4Z;PZsFS=2p zZ;cv5Ut;Bu8xjfVYP_OJl|G5%6-)oZ29zFOEF>T#Xec1dU{B`gh_y2?81B(FdIEyu z&b#n02HM(>C6+c^wQ~*O|D8ErKm2TTal>_A>iBu#BSZdcxldD{DE)N!e6^0%CSoP(&@2%GV?@qjCA^SzwC5x6u zHU@hp7J1R5slC6RDz&(@v@}1jTkWy0scrB`q6$rme~Q&_Zv)GGB>!>nVZDj6CAtD= zWPIYkrBKDhIox2odALMCC9yJ2<+(lLwj5RfRBq6FtZ}Kx&COk59e#BC_U+2b$^%xP z%i>Cwq%{tfE;@;c&`2nNV}vu{^6q2$r?by1zYZ`^5SD2r>0q&T#_XCH&})yjEg2_{ zXr6K?wJ8~Y!|$=`UpM)GrKSx|f|A!y4%(mir#X?q^4&X5+*k`vCKbT656$h~g&gf0=Z{)pO&ywR2u<4L=JEF18sibC^;%3~u}3#(ZAbn9lJA z!NGG0R95Lchgbh(=s9l#ZZ%AuQr3M;kp7Ur26BCWy$d9?`yi9*>47ZxU;N`3`!}oG z|7Ckjla8~(R=q=@*>}K7@}3E-!H0VXxA%-s3wVEb7UR@Mf@1D0Vmv1NxT;nIZFvmJ zG&+5*uYZEK_TA+Lh|@bcIX#Yho&s`n#Ut~F_K}!Kc}fTwA$B7W;1EGLJm9FogYm8; zgVGocE`s0aU~jFB^{}MX46-Uv1YN+sU_PO}L0yH~xRsY=0uvArLUhJg+eJnHf4Bg1 zb3?=ypHIEP$y0)XMbEs+Vj=tB)EE~yr1OX%>RgO3=_b%fnS06RS>1knF7g<9g#8&A zJ67_(<})6HQ`P_>)%Fb{h8rg3%zHZKE&RINA`h7_8I1j@Hdf`?&l*pv=&KD z359eZJgOUvD-Xm3dx@w4%u1__Eo3+QCZP|41<(cXGZ$LE6yfk<#W7 zZi16?yrIHO@rG@rqZb%4|9u87Bt2LJEr{#0i2;OrpRf`b+Od*)G%g|NfZMmHg@evP z9es7-&1oHOZ#0g{`p@UEb;`>AUKJQ+H#|ju5=TQFEQe+TW;Y;{>Q``eHE)!0`8}Oc z9dCk|#aOScJ<7j)!k4^2nnT*A7?z#5#T%*;{R+Ce1;&^foWO+(_f)8A5T)RQ$3JL~ zf4hm3V43zCs%&dcb!fz8o?FTW169b_^ z=Me0bak%f5#6rzA@Or-VBBy7J&$8KE1;cd;SDF9U=I1U0kwYw08ZtcIA~K>c$p(&G0LjY7~$78d;=cnJJ49a8?E->{LkCbY+W z#Kjq4G3d+**#*^KzJvlnKRfvqh`>0YdZ`4smM8`M)n#tDXWsw{WiLn{*ksf`V<}o* zkq7x+g#|@#oWTpNcEXJj8gC|@4S;3ps~14j0|U}h<&KkZKo|?=uH}DE_(xvGh4xfh zd9(?VV);Z<-cM~i*4O2G3N7LH#S|i@d}$F=$)NF_jLv2Q(cxeu$NfqvmiWYG2;{fFHXaD^n7-u@J=BOCg_65 zV%6_y-WV%vB42a^Si#ZFgTu#cYktSwy`|V!&YIwj=O2vh7$y?Jy*wgEr!QV@dgNT415H-TnL6T(>5u5$(MquFO6F90ZX$bS^rkwLh7%-o}PC%tQ z6oAFBbHP3#$cug?z~wkpqTjH>P6J_3G|jqKsx(X9f>Ese zA{uDofC#@@OF_U6FNzD9)YSvB5DGKfGvPjd8HZAMMkW{$pfq6mu|Tkm(El#L#*T?} z#R}wnQJtECdw*63b?5UkGL{w{q2~e!%}^AAdAY7`y;HGlT@4Mh{s&}uFpERsA~_in z{0m23qrR}x?NM=NRzQgKEv$eW&ddJpU8N%51u)%;ElD{+2agG9puovUjJ0FV%SQD(Mz_p1N$Q<;`tkiuAu2twCx*da&mhA`*}>~W_tOOiAfEOQKcW5b;8>UGL4NrdcEvHCrM~#fGQlD z9mgVzRd;%pnfJ~_ni>tDC*AMLq8SJq+50E*$7*mTTKZW*$KPPoot)Csd;zgID&dQI zz)6J2PZ^oEF#54yzsY+Fj;J=To8=6D}2qeJP2{KxjI!Y+KR?%IL#stUk$5?Rp z-<@^n>^f)R5*dO(F_R9@0=XG%O`QS=ktfAb({T%c1qv`1+hA58-w7~Qg&3kfH|RKO zKczoR>tO}p?%|9=WPR?xt#T2~%pjP=dC{4-oPumZ_Ff6tPf-uXRB3{c_px^oVz9gQ zloK&EH;_7^vT}IeqDSATeK$~9)XPNrVT3v#eGTs6Rf((v53P5;&;DTQ3c&iJr%IIk ztF~dsxd?$1z6pOFghj4U+;NVL{W=)-efh?ZVrcXzScFYnI&sPzYZn7;d5YnAT$CY& z<{?2Wj~L$liHZ{Pyk3Kl+lh7$G@`(W7>X7JsRL@?smMrtOY1&>{?fqJD(GS$){*w8 za&==Q-lm|mFu(Ksc>tmJyI9^}9~0QQ@gO$+njW?}&m}xA$)MbEKAnPqhmBvw-JOEq zMOnERmgz=wQzss&kw$`~+_t{5$^3xa@m+zbkFr#(362Obqf_W>L19qzNP=zPK;tfo zJHINU$%FEU0nhqe8N2p?8dBY3_|@6=vtbe3yn!LoKM3re=A+eU&fJvqP`2PU@V{e(SV0J& z^yP7|^7W4<((V84?WJyjqGdnu=z!ca12KA+B1p{@zzsfoVW42$q#%p^*7y@8F9k_~ ztrK=G*XKjOwSgvR$mbC(%&pxmtAQ&&m2S72dj;J@MnD>$R$D(LB0^hBYjZX+n2E}@ zas(zZL6YWEV-L~3TczP)Fc(d(HYKHgo6Lt(bQ!5WCenXlHLZ?-K?a1@J|) zzQkh$B**pLH+rrPJ9dR|$e}9SP&PdsECoUVP(B@j2|+LzN5p1myMZHk+f%}?pztD> zTxsdvJ$9zIZ@YVH1=!>R1LyiLqga@F!ev!=$*Yt%F2KDyB50>#h3m$A8<6E-h!yn1 zdT!US2Gqy9O!yUA^=Tdb=h|%c5W^rKs?#>Pw zIeB0(j5TsSy!@$cU6lL^8~YLZpmX8B;|=LO)$vQmsC31Zla${zx3+>*mFIO^D27m7 z-yUlMt?v4@zkkch%M}$AI3d-Unwi=4d~seR`biTc^IM_9%5PcwCB zlOqWWdlZt}NB7B7OpSJ|OZnQ9iDPY(!MXaSe<9HpzCHp;kBdOu-0DY{;P<5DS2ht2 zOGsO;OnP%<0iF%H4_&x83HMRma9h!6rxW-UJ-^VOoork81<;}wVX2-=iSEt1uWp3? zKwno>H0Wj>PRb{J2_XXVt+bGkkli;LtL({Fl;j2zh{~!JD~d5$w0vw@#QkK)%NB-<}_x! zc#-M!`=l7=ql(4Zvk1VqL?ky9L#?%}S&9a%M}CxJK?J8)Yl$FW)?QRYubE$!Gxp52 z_0l$rLl0SOueyHLOOlVp?|*(V1@}Fdsu(($J@McQ#Z9Q$xlS`?>zMS6F{MyMepk7v zKl?|+?EDg9c8HfH3LV^SYAxbp`7te(i+Iw{N@stu+Cv9#d^Pc^vHhW6~cT~ zH1rhe{wcQQb{{zWbpbwqoJSP+kCwB4P>b(xT3=uXxM11@GY@C#lfm^*RF^68I4|KF zEsUjE_YzoKeNn4R%>w~|iMR~l>9Qy0=b(JB#tR7EiD0=1gOuU&bLojPP{cfT^A`Ov zjA&2^RL;OY(bA4R>>Wtg%nV&UJ#!pyyh_GRJoc6>FsNzjL9Oq92Abo{84XVACr6gz zto+8NWzCz1dv(Fg<8Pp1bqOzj8ke6BToh;)0Ulq8F9=L?fFXd}P&VV>nD+YI_~s<9>;V zByLF|Pf4{pnaut7C{Pm2O{HK?Zm`J z2Jp7T{@ObJs?b)fF8iixgSU?0X_U;-vjXz^;|EAszNY7#14Y_xfyoekjLTkiW6feO z9tUiWeG^S6jE+5g7=w+C%FxVo?7bgAa#Id11O`nDPja2`{R*_5+-g2~KKhgF7|~T> zVTVs6A7aK;7P-+7%|^}8Nj|j4{vfJTvfeV zt?_OCROE@+m;#I_mt5#ue@2QHU^~gHG09My4i=^7225;D&#WIoldt*1&1puixtt4Lj^Px`>k!|_#VHS^B)8+}4b0`9V5AhEv{;3R+Xo{{b zP$b-zRBvEjdi7u61I4ymM52wHi)VH8pS((*n*Qp^&qyG^WelkSqRiad3Waleqn0~t zW(o@H6aJTYlCp!4nC)M`(vX^8Z~c2lehP3Jz;+9;Yi#WqOOTcQ5Z=xBj&3&6(qcU2 zgReW1liTxQ1g=Va^FzD}z_j%Z?eE_BK*$$_h24HGEXmT###-b4#|p#1AW(Oq zX9aY<5syFu8zV~MFO&CRdhAB!Hq?GrPrx96l0sPr`3yRkO$6hfqB!ia0yD^~mE#vQ6fde_msY$fGV!~_KVig2pifC>i-SBr!42_vNoSf$8 z)!eS7N^{h8c0oe*np{|bEmvFQw9HLJS;*(O#hjYqQ-IKV(CqBHFP%9!(HhfWi{+7Y zs@}eZ=ur)i>sOO+{c%6s1mFNnkJ|iRvSKfauA1q@(!)K z=(Qd0S7)Su+)3z42NB$zjhF`Se!WWFwHYV~zJy2*!hw;n4|yb_Bl}Cw#2q->xeotE zSlVoE5u$-LTp)Nb``{p*ipl5ekn`!9mo6dD-33L>gfExRh$fsM_J-g}x|H~ZcDDdi+@Y&f-O=>qVrZ2ZqHY}9rx1JpA zR$DFV8rpFlH>Fy6No9HHLCoPnU^k|HK_ZTkz)m}Y)5+0}lnyn1d@w>6)tu7`zz7%*|oUrc}h zb0N_S!H=WX9_aG{K}10jt%LyfQM&-zl}E1NG8O**eLpRX$6tBS9bFFg+<6Zwtf{ee znSrlD<8t1TLD&Nn%q4>eHjIn0G)wT%k_Fn`0IiE8QVj_x9$0idSkBZ`T`wV48O_~* z)MBPQljLT*^edUl-8X{i*z7kF@Kwr^nzTv_K;9HLp@*@m8`@mcE z8Kg!<&BaUDQ?0CGO7hhK{(HN^eNh#dDGVVL__dkLT$M9t=Kpka=eF;`>78IlxO9m6 zMfE;qDc!vr3j8;%oZn8e?A#abITz{bGWfYr;A?8kvV_%^l;o_Hh6o_1R)zR%(-|wk z&WM|7RrjoZ{%NXoroi!HqW5n~JnKK-BHPD#ljjhw&a*m4MkOrlBX2vbU@e*9W6qL! z%d&(?A%u$ZkSIgm(pY+F?V>|H#T6pf+miNx!sTJuQQmo{rfw)hh!5~>2RxyzY?UHw`uKv zXiW?gH;S5=NPx-_Gz%JnLxPTsrZhWJfPfu-Gq4wpFTd$WQ-oL-6Pbw#L&XC+u&PPE3G`FLoemiGo z-}R?o69@Prl4uO!#+Q~>y^=_ld5Z*)j#KkwdW>t`m)Y9l=8}8OO&>p>oLyElig zR>?>}dy;`u*p(~49f;On6kq#LJU(We@J#O37)rFMvGxZspd)GEk#93JEXq!CZfS#?gayB#m^ zV-o9BfwkWIyxxU1(0F)Y#&hxGDO}*mynrG(wh9FWbFZTFhuq6c07li;_RTp*V@k?_ z_g67Vy$sz!R2^YLA}Mh!o*2>-y+ z8T$P@bQCJ4?S4F0$L|dy0P$p?(qBqaQqo^c;xc+YTer51CS=0Sj?9srcxJzxK3mP^0GS@p_O?9&-{+9*Yzqa{1u2^_Uch^u>+GMYv=VYKYQu0 zx=N@2b3|Ej(#$3g=f~UL+IlcuPpz8}So{P_GPbnT-y&i2>?`_SOii0w!;-jj?pa>q zZNEcDODpd1%EUL9$kHa~J~W1z3Y$^lU%tG=w@C!^I}BVeF38>@<89a4|GuC5NyeNs zVCcILn!TeKkwFB_Rsh{Bh&FVoWEN@?5LDgLR!>~WjbGnwvyL9>F)dnv#=0YHxsCd zY*v$Oe|&u2pp=0M@286)4t=YN@t8fkIMQlNxS#p0jJ3>mch>0p8~5$hpTZjC%UnV6*2^tZ0=d7`nOKjnRHp0@om>6tFIlLpSZ zP*8;CGGN7;CPqaI+m0lW<*lBsEb5I|5Ax*N+-h^-P5@5Xq+*~l668ZSyXsFrIePHJ zO_3>pEH9a0#fw1P(H96id4?}k-Q6Jt6!7jEm9nrA@+f?L4w;#WekO7S=Bv!}KxPAN zgmmVq?;))znV)Ce-5|xUTJ@6ItuF|mdd>qDS|g>UJAWQ;Y~-#PzNAfgbqZPpY|0ub zRJr0M(y=`0sd7gD-WtBJuOnOeaIW^l==$5*vpOAFNWBbl5PS#}aHXBi;KPxVW2a_W z4|NVVZP74o%6Xw%{e5ZV$v9-MFxR3hW#yag8D&v@K-t5t zP;gsFVMKSD+Y{xcR+TDq3sf=JS8v67h%XE4)X-NYG$}ln05jec_WlxH77=m%^!OJ6 zvk&c98qruB3+3^;v4`m(pWLJ8#jsad>&gi?DTEHi;f*L^dYJ|2q zrk}Lfz~JlP{uysgoeR-VI$0nSM&miC)J?-NnA+56+sZV z%&8v9LgcDz>&jBBsaDsTt@xld^2+l1wXQ!ffg*rnlx1w%3<%hKWxjnRA%)f;xa&QU zNA!ynFBiPS@^739W)UbTP8tv|T;$ibNLNreuL%;PJzX3T%~=R*b*_cA5&?mr;Vo8% zduC?d%NS*OzZ*!L8pgSttCFyO86#q|9}!~Gi2QN1bcDP)=i3eUy-Daqfy{rH@o~fW zJ+1JlXoyoMY0@ThX=QV;f4Gpxk1h&!6_adl4#G5*9XyGPJN13Q7;=N_&afZDkDv1K zF%}k1Pivq@XKlDw+LZYfGh{L0=y?PPR-o;ynU3N2Vfz2!0ysHme7?B|LYRUCE34Xt z!#2+=p-;>I?RkSrkbxBzku?oVG%u9C#@tc0V>a|pB8_e~geE!pB5!L3h;@4&7H4Fv zcLam5E};3Gnp!}yZ+%8M!G*NxVtzKMX@w79E1yJzD$CYTjsHvE=2lIU@uaddP=A`p z$G(6DuJ|OFdMn&_@8I=of|b30P*{<92~M(dH%FiEsPji~u5|e8U~1LLz}i>wbh8&9 zdr9oCCm9fgABXNnCPu(J3v#P~v!N2tgiFnuPkFICiRpj4g>e>#su?;Oqwx9~BPc5q zfOZNFZnj-Uor?X&J&dS6Z~MQ0(`R+O{$NDV9cyFNW$^4G$4h#Wj(Y~#zjU#A$%J1? zT$T-iL7h~EGbk@GdC3W~lD~cdW&EdD6;ffJ$X6b4l|E}8Mj=jx0pYvKorxv9>tckW zVtC}$xXYLD$LqVFeg5LQ(uI{ghit7Yl@;5OIxodcpD$Lwl}c1ruJ`(NQ=^|VBJ!3( zeG?&3!zim1TM}(YS-~`*j7&}atYr`F2&0?>4_+FL6kAU{5HuP$Db`L8TZ1y1RiDhS1Na9)HF2sp8H~pVMNY>z2VK{2gb& z$F5di4qh0o9*tNyJinx+tql)+wF)TyJw1(c8tU(fiJ`Y*+6}&^4H=%yCLUujY z6j}NcQ#sKA(xj3TiugDd7+84i8V~^o2Hsy^{t=qHYEWOpGR7e{{mXv;J2~L5VzJ^| z`ViDZ5T*{&M&O>a?l|`u<*F-p%%%|&JGMz$T6TI7>}+{PB-whXXJ-ezt497*yI(9o ztbgcQbS^ioI!#8~&OerVpHv`}kEH;>k;{sx|LZjk=uDilYnW8kj(DyeD&V?y7h;B7 zPXpytV2W5pSc|~qs+9AP;&!m-V=G{cki`3EbUbZl>MFr%YC;k`Am`%f(8> znHjmtZw;e@Yy-1C#5t>O0~>C<`*0pPG5v#X6heym!S&tWppXrd zG7i^OK&+b>o{cE_i6wHpkHwe+8MH>*?o@T70Q&!!UMBu@SX3Z^ghe3U_z#Bob5_P% zx>-Upyev`wq~9H)?WJ-U5E;b;t>OvNP@#)?s-bR53@!RSLp-_Kyu7-3xMy@HZfJ#H zxl-WreEN?^3Kl+kXIuqQ0~rGZ*2v^J2*Vomb(l4=0g=*)D?M5 zMz1dpF$RJxzFZMj!muw^^!8~<9%12MC90|M%7`pa2lk2NfnGx3wGcacTzgI$qu=sd#uA%W$Dfcy!i@)k4zfEGR^l zc8})%TO*Jpv#4kli(t$VF4^Ycxvm;`_;Cj4~2+yv&-&ugd@ zgj^65^&2oQjVHivoCFyJ_@>Uz`^UdAv52%i^1Dd{V`N~I-_EY4S|~77WnmgsXsemw zImdDU>I#GaUzkyT`a6*o7aiS7`#7&Rw=Y8znwjf^ppzX8+wu#aVh#b0ayTh4t)(Y- zUeQR+Fb*uF7&8;|hrY}~o35P=lWiVoBHaAr*Im3apP6rKeM}LFy9zP}AUAT&Ia1rU zW)LfR8O)v4j57Ec=&=8OO#I(NXpx$3>vP|dhw|mM#$QCSCA7w-RCb<+`oRX5d;KS2 zklW4F7@)m^{7FXBUWeGCkUMl%UJ8ZrsW4h>+DtbgOQA}^h?2O`3}8{p$Y3)FX+%EJoz|fT*O}NKCA$S&(0b z!Ly~cXB;wDRomqxgt>4R_8TERoaw3QCbO>UUbT5fqAcm#L=Iq30)2?(uTWpIOo=2hAthQBgOk@WE0!yn0wl zd~L0nmAp~BxOmGZU^&BX%K@HN%ZAx{^yUbQ6k+q7@5-rf-mHHo&&U9I@11$=b93+G zKP16m;^#A~HU12DdiiE=WdTok`eM86UC*G~V~^uwPvPkKwQO?2dDS(;N@=spKo#dx zuIKQJpA)sv>4xL0(g8v)?7vf>0Meo~nw+-jye9deIGP)0Fg+)w|Ci(gYNuXGQMy+AovJ(BI5T?roS4i+zr z`w&p#Ar!b4yOZkK+2EUz>9mjyw%~>56ih>MI44!%dl&F~>vLeL%F8wNnJ0wGOnqQ{ z$5=vXbM5wI2*)M<2sFQ+OI>(%5{z-wRTa4Xs@)<@4WI`=WPfq|$?IFD5J(GUt+qo$ zwD`525rE=yY}zb|N-8VYy>+YpE!mUN9FWOKTHzzyW6VW% zR~uC8KhfJbvbzMzSGt8Q-t5TH7Q-5gJXV{R2(sKdqPbM)%TXhCoc{@ z{?&x0Vj%xA60B?wxy-&(P!JN&sFN)$ZW9f>Dx98fq4t-R5r)u;%yEA#A`<6T1Yo!` zLPPb_^R;cU+ss5`?z`VNa|;Xa>LS#*8rxp(6buWued7N zXuk)>xhp?%`7K_H7T;_91&yNJj9 zXvf5e$9^h9|6_WpU~8=`x#Ou#Bv>1lIEs~gM3uLCLg_S0IzH-o4F!-yz*7!K%#hm3xWB_GFK$O~v5>FJ?L3I@#)3k@Oir|$(*iPU);zo4=s z1(+QF?8(SfXpPCp)?XJHnfYaHg||C9zy)U+)y#yJDw#~677(w~vK+=jT{SCfZVNg6 z+(m(?-`p$Qj2{aDE6OadvV96I)bgH{#Zc<}Roe9@^~%Alqh%i-%#S{&2)60&UEP8^ zBGJnse;uBT{;VKt`8nP`JIkXD8s8u!0u$1l=8~%rYo!}`ONnoL`pnfLLwPoI);v$ zz9{pHU#0SV*Oxh5p87B8BmoRmWyG!hZLytipz%x}@vUbGCMNFgWY5)ha&i!FJ-pV% zG8RB#S?zmmZ3b#b-NVm(W{j+CM6Uh-T>a6D9V?5D;%Z4JvB>Dm7A0ER^t1~f$X3P@ zK<-Z?>2QbNebEXc`a*|C2^g2v2OH~o_hi0XTB%#4^CNB&mR4Q6%bDeR&Ee^pR-2GZ z(T=SuYG5`i_Gjfle_+k@kald-nU)^r+B`D5#Lv%;+4ek;n~9gYi1-X)_x+7#{f%O# z#P};YeM~I_fGqO(vC1!knCOK;0tpY&-fd|j7F3iJ=KMq$K_|7+nkRpW^x^(!l~j(- zC#ijTVPS{T?tyd|oow+wMj7J3eJ9wxEI3e?gF0=U?9=?llDA|Vn^$tN`GU$OksGZJ zt-@t{4&X`;4xWJrD%Rc_N^EognYCZF_EX3cWN`)tpf7u^{r&y6pB9!dwIY{g!J%=X zXQI}1fp_$2)&7&hBFka%;TQRwAWjMxu!Tiaqw3TAsz4<$NzcSFqA}7`A6 zFy~v`T@f!Q1uTT)4*tFs+A9Pvnc;qeEikeB~V)Vm0!R2J&1X=H5sIl zE|pdpx@|_fd5DX5cPCXJXf9XhzE|$Nww#tOU+&yE*WDBb(7L8(S8xjmnRpIum3Pg> zTt^gJGVy-`UQPhw8h=m#g|UDCKxqS1Ltra`p2yY*?7@W(>d^k)wHF2{WBv8>!Sye= ze!6abNI4H2mFb!t*ZqSn$VZ+PZ!QVPw-08Lu(X5XP)gk&yb!>M{&gj-opF-Cifz?8 zZLDL~p9iAoiM5h#b@s%BJa4;lsZ***jB#&+6B=7Lwj~cfl;ze4?EILC|k% zlhh6jWMb(J=Y^n0YPjghG;`YACUUyZzqx69^;S&If|`2G)8)$?h+F0KDmUTS%4z2A zzN(b?y<3CDik)!(AS5s&rJ{SBj!roPky?KTBMMgXeqL)U_Kw-i`c>)X1YPp5Zyo%m zTf4+&X2Gt^r^Cb{ec_#uxSZGI=^AX`0=03cnKX3Lwnnw({YqD^boRZWEL$qG7%2h_ z_Hg-dPH$9AC3w2^ee3yPIf$~q)TfLF?<^QC$B}7L# z*3wqZxfx3Xi)P2w2oX794BS6+}Bb3*hBIQ|Q?!Z>~1Ie!`BcpklDfJs2lr zTV?q~cqSQWMBk_~(&ejnV_979$jAWbm=3)%1S>fPWn);QFqzK3Q&9fe-vZf=lw

5F6aiVvkc6=aqWC$okg#~GuRy)el*cE+B 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 ZdKsPD^s|<@^X2S1G7<_;K8xx5{vUv+4O;*J literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/LDR-gnup-2.png b/pigpio-master/DOC/HTML/images/LDR-gnup-2.png new file mode 100644 index 0000000000000000000000000000000000000000..44530965f27181a0d357ae1b7398e91dd1bda912 GIT binary patch literal 31410 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 Gum2CWU|Svl literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/LDR-photo.jpg b/pigpio-master/DOC/HTML/images/LDR-photo.jpg new file mode 100644 index 0000000000000000000000000000000000000000..95a63a3081090ae2d24be52b4fdbfed6b6cff3e0 GIT binary patch literal 109499 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�OWbEY1%xj*7m^L){y612ngfT6y*aX25#kN;7u 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 literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/LDR-wave-1.png b/pigpio-master/DOC/HTML/images/LDR-wave-1.png new file mode 100644 index 0000000000000000000000000000000000000000..69bb43b5f58cb31127013818f2698fe8f4656bba GIT binary patch literal 4557 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 Q6BrPnrGZp0g;M1& literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/LDR-wave-3.png b/pigpio-master/DOC/HTML/images/LDR-wave-3.png new file mode 100644 index 0000000000000000000000000000000000000000..a2ca42a329555650350804a30c190c722dc3d944 GIT binary patch literal 4872 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 literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/HTML/images/breadboard.jpg b/pigpio-master/DOC/HTML/images/breadboard.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5d916f70e9b5815035b85516b8552a104d3cb6bf GIT binary patch literal 46953 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

") + t = snafu(t, "\n
", "\n") + t = snafu(t, "
", "") + t = snafu(t, "\n
", "\n") + t = snafu(t, "


", "

") + + f = open(n, "w"); + f.write(t) + f.close() + diff --git a/pigpio-master/DOC/bin/updatesql.py b/pigpio-master/DOC/bin/updatesql.py new file mode 100644 index 0000000..56a916c --- /dev/null +++ b/pigpio-master/DOC/bin/updatesql.py @@ -0,0 +1,21 @@ +#!/usr/bin/env python3 + +import sqlite3 +import glob + +db=sqlite3.connect("dbase/pigpio.sqlite") + +c=db.cursor() + +for fn in glob.glob("tmp/body/*.body"): + f = open(fn, encoding='utf-8') + body = f.read() + f.close() + c.execute("UPDATE pigpio SET body=? WHERE file_name=?", (body, fn[9:-5])) + +c.close() + +db.commit() + +db.close() + diff --git a/pigpio-master/DOC/dbase/pigpio.sqlite b/pigpio-master/DOC/dbase/pigpio.sqlite new file mode 100644 index 0000000000000000000000000000000000000000..908859846f5f73104875b3c88d4e38988d674ec0 GIT binary patch literal 1433600 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

^2-ZLR20PSuvRLoxEPo7?+@ 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

VOF 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 z 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

w580Olf1e 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 literal 0 HcmV?d00001 diff --git a/pigpio-master/DOC/makedoc b/pigpio-master/DOC/makedoc new file mode 100644 index 0000000..4494252 --- /dev/null +++ b/pigpio-master/DOC/makedoc @@ -0,0 +1,47 @@ +#!/bin/bash + +mkdir -p tmp/pydoc +mkdir -p tmp/body + +echo "*** making man pages ***" + +echo "pigs" +bin/smakdoc.py src/defs/pigs.def man >MAN/pigs.1 + +echo "pigpiod" +bin/cmakdoc.py pigpiod src/defs/pigpiod.def man >MAN/pigpiod.1 + +echo "pig2vcd" +bin/cmakdoc.py pig2vcd src/defs/pig2vcd.def man >MAN/pig2vcd.1 + +echo "pigpio.h" +bin/cmakdoc.py pigpio ../pigpio.h man >MAN/pigpio.3 + +echo "pigpiod_if.h" +bin/cmakdoc.py pigpiod_if ../pigpiod_if.h man >MAN/pigpiod_if.3 + +echo "pigpiod_if2.h" +bin/cmakdoc.py pigpiod_if2 ../pigpiod_if2.h man >MAN/pigpiod_if2.3 + +# *** preparing HTML bodies *** + +bin/smakdoc.py src/defs/pigs.def >tmp/body/pigs.body +bin/cmakdoc.py pigpiod src/defs/pigpiod.def >tmp/body/pigpiod.body +bin/cmakdoc.py pig2vcd src/defs/pig2vcd.def >tmp/body/pig2vcd.body +bin/cmakdoc.py pigpio ../pigpio.h >tmp/body/cif.body +bin/cmakdoc.py pigpiod_if ../pigpiod_if.h >tmp/body/pdif.body +bin/cmakdoc.py pigpiod_if2 ../pigpiod_if2.h >tmp/body/pdif2.body +pydoc ../pigpio.py >tmp/pydoc/pigpio.pydoc +bin/pymakdoc.py tmp/pydoc/pigpio.pydoc >tmp/body/python.body +bin/examples.py src/defs/examples.def >tmp/body/examples.body + +bin/body.py # get bodies of manually generated pages +bin/tidy.py # tidy the bodies +bin/backup.sh # backup database +bin/updatesql.py # update the database with the new bodies +bin/purge.sh # remove redundant datatbase copies + +echo "*** making web pages ***" + +bin/build_site.py # construct the web site + diff --git a/pigpio-master/DOC/src/defs/examples.def b/pigpio-master/DOC/src/defs/examples.def new file mode 100644 index 0000000..1ead75f --- /dev/null +++ b/pigpio-master/DOC/src/defs/examples.def @@ -0,0 +1,528 @@ +The following examples show various ways pigpio may be used to communicate with sensors via the GPIO. + +Although many are complete programs they are intended to be a starting point in producing your own code, not an end point. + +?0|Index + +?0|Hardware + +?0|Shell code + +?0|C code + +?0|C++ code + +?0|pigpiod_if2 code + +?0|Python code + +?0|Miscellaneous related code + +?0|External links + +?1|Hardware|Hardware + +A few practical examples of using pigpio with hardware. + +?2|ex_ir_remote|2013-06-09|IR Receiver +Reading an infrared remote receiver. + +?2|ex_LDR|2013-06-09|Light Dependent Resistor +Measuring brightness with a light dependent resistor (LDR). Improved methods of timing the start of the capacitor recharge are given for C and Python. + +?2|ex_motor_shield|2013-12-15|Motor Shield +Using an Arduino motor shield. + +?2|ex_rotary_encoder|2013-06-09|Rotary Encoder +Reading a rotary encoder. + +?2|ex_sonar_ranger|2013-06-10|Sonar Ranger +Measuring range with a sonar ranger. + +?1|Shell|Shell code + +Examples of using pigpio with shell code. + +?3|gpiotest|2014-08-11|GPIO test +This bash script tests the user GPIO. Video + +?1|C|C code + +Examples of C pigpio programs. + +If your program is called foobar.c then build with + +gcc -Wall -o foobar foobar.c -lpigpio + +?3|freq_count_1|2014-08-20|Frequency Counter 1 +A program showing how to use the gpioSetAlertFunc function to set a callback for GPIO state changes. A frequency count is generated for each monitored GPIO (frequencies up to 500kHz with a sample rate of 1μs). + +?3|freq_count_2|2014-08-20|Frequency Counter 2 +A program showing how to use the gpioSetGetSamplesFunc function to set a callback for accumulated GPIO state changes over the last millisecond. A frequency count is generated for each monitored GPIO (frequencies up to 500kHz with a sample rate of 1μs). Generally the method used is more complicated but more efficient than frequency counter 1. + +?3|hall|2014-06-13|Hall Effect Sensor +Program to show status changes for a Hall effect sensor. + +?3|I2C_sniffer|2014-06-15|I2C Sniffer +A program to passively sniff I2C transactions (100kHz bus maximum) and display the results. This C program uses pigpio notifications. + +?3|ir_hasher_c|2015-02-25|IR Receiver +Function to hash a code from an IR receiver (reading an IR remote control). + +?3|PCF8591|2014-08-26|PCF8591 YL-40 +A program to display readings from the (I2C) PCF8591. + +?3|pot_cap_charge_c|2014-03-14|Pot + Capacitor Recharge Timing +Function to time capacitor charging (through a resistance). The time can be used to estimate the resistance. + +?3|pps_c|2020-07-28|Pulse Per Second generator +A program to generate a pulse on a GPIO every x seconds (1<=x<=60). The pulse is synced with the wall time second boundary. + +?3|rotary_encoder_c|2015-10-03|Rotary Encoder +Function to decode a mechanical rotary encoder. + +?3|rawMCP3008_c|2016-03-20|SPI bit bang MCP3008 +This program shows how to read multiple MCP3008 ADC simultaneously with accurately timed intervals. One 10-bit channel of each ADC may be sampled at up to 25k samples per second. + +?3|rawMCP3202_c|2016-03-20|SPI bit bang MCP3202 +This program shows how to read multiple MCP3202 ADC simultaneously with accurately timed intervals. One 12-bit channel of each ADC may be sampled at up to 25k samples per second. + +?3|rawMCP3XXX_c|2016-03-20|SPI bit bang MCP3008 and MCP3202 +This program shows how to read multiple MCP3008 and MCP3202 ADC simultaneously with accurately timed intervals. One channel of each ADC may be sampled at up to 25k samples per second. The 10-bit MCP3008 readings are multiplied by 4 so they have the same range (0-4095) as the 12-bit MCP3202. + +?3|servo_demo|2016-10-08|Servo Pulse Generator +This program generates servo pulses on one or more GPIO. Each connected servo is swept between 1000µs and 2000µs at a different speed. + +sudo ./servo_demo # Generate pulses on GPIO 4. + +sudo ./servo_demo 5 9 20 # Generate pulses on GPIO 5, 9, and 20. + +?4|code/spi-pigpio-speed.c|2016-11-06|SPI pigpio driver speed test +This C code is used to benchmark the pigpio SPI driver on the Pi. The code executes a given number of loops at a given baud rate and bytes per transfer. + +?3|wiegand_c|2013-12-30|Wiegand Reader +Function to read a Wiegand Reader. + +?1|C++|C++ code + +Examples of C++ pigpio programs. + +If your program is called foobar.cpp then build with + +g++ -Wall -pthread -o foobar foobar.cpp -lpigpio -lrt + +?3|ir_hasher_cpp|2015-02-22|IR Receiver +Class to hash a code from an IR receiver (reading an IR remote control). + +?3|rotary_encoder_cpp|2013-12-30|Rotary Encoder +Class to decode a mechanical rotary encoder. + +?3|wiegand_cpp|2013-12-30|Wiegand Reader +Class to read a Wiegand Reader. + +?1|pdif2|pigpiod_if2 code +The pigpiod_if2 code examples are linked with libpigpiod_if2 and are written in C. + +The pigpiod_if2 library may be compiled and run on any Linux machine and allows control of the GPIO on one or more networked Pis. + +It should be possible to adapt the library to run on Macs and PCs. + +Each Pi needs the pigpio daemon to be running. The pigpio daemon may be started with the command sudo pigpiod. + +?3|_433D|2015-11-17|433MHz Keyfob RX/TX +Code to read and transmit 313 and 434 MHz key fob codes. The codes to be read must use Manchester encoding. The transmitted codes use Manchester encoding. + +./_433D -r10 # Print fob keycodes received on GPIO 10. + +./_433D -t5 8246184 # Transmit code on GPIO 5. + +./_433D -r10 -t5 8246184 # Transmit code on GPIO 5 then listen for codes + +./_433D -? for options. + +?3|DHTXXD|2016-02-16|DHT11/21/22/33/44 Sensor +Code to read the DHT temperature and humidity sensors. The sensor may be auto detected. A DHT11 sensor may be read once per second. The other sensors should not be read more often than once every three seconds. + +The code auto detects the DHT model and generally only the GPIO needs to be specified. + +./DHTXXD -g17 # Read a DHT connected to GPIO 17. + +./DHTXXD -g5 -i3 # Read a DHT connected to GPIO 5 every three seconds. + +./DHTXXD -? # for options. + +?3|RED|2015-11-18|Rotary Encoder +Code to monitor a rotary encoder and show the position changes. By default the detent changes are shown. There is an option to show the four steps per detent instead. + +./RED -a7 -b8 -s30 # Show encoder on 7/8 detent changes for 30 seconds. + +./RED -a5 -b6 -m1 # Show encoder on 5/6 step changes forever. + +./RED -? # for options. + +?3|servo_demo_D|2016-10-08|Servo Pulse Generator +This program generates servo pulses on one or more GPIO. Each connected servo is swept between 1000µs and 2000µs at a different speed. + +./servo_demo_D # Generate pulses on GPIO 4. + +./servo_demo_D 5 9 20 # Generate pulses on GPIO 5, 9, and 20. + +?3|SRTED|2015-11-16|Sonar Ranger +Code to read the SRF-04 and SRF-05 type of sonar rangers which use the trigger echo method of operation. A 10 μs trigger pulse initiates a series of high frequency sonar chirps. The echo line then goes high and stays high until an echo from an object is received. The echo high time is used to calculate the distance of the object. + +For a one-off reading only the trigger and echo GPIO need to be specified. + +./SRTED -t5 -e6 # Read a sonar ranger connected to GPIO 5/6. + +./SRTED -t11 -e5 -i0.1 # Read a sonar ranger connected to GPIO 11/5 every 0.1 seconds. + +./SRTED -? # for options. + +?3|tx_RED|2015-11-25|Transmit Rotary Encoder Test Signals +Code to transmit quadrature signals to test rotary encoder software. + +tx_RED -aGPIO -bGPIO [options] + +tx_RED -? for options + +E.g. + +tx_RED -a5 -b6 -s20 -r-100 + +?3|tx_WD|2015-11-25|Transmit Wiegand Test Signals +Code to transmit Wiegand codes to test Wiegand decoder software. + +tx_WD -gGPIO -wGPIO [options] {code}+ + +tx_WD -? for options + +E.g. + +tx_WD -g5 -w6 -s37 12345 67890 123 899999 + +?3|WD|2015-11-25|Wiegand Reader +Code to read a Wiegand Reader. + +./WD -g7 -w8 -s30 # Read Wiegand codes from GPIO 7/8 for 30 seconds. + +./WD -g5 -w6 # Read Wiegand codes from GPIO 5/6 forever. + +./WD -? # for options. + +?1|Python|Python code +The Python code may be run on any Python machine and allows control of the GPIO on one or more networked Pis. + +The Python machine need not be a Pi, it may run Windows, Mac, Linux, anything as long as it supports Python. + +Each Pi needs the pigpio daemon to be running. The pigpio daemon may be started with the command sudo pigpiod. + +?3|_433_py|2015-10-30|433MHz Keyfob RX/TX +Classes to send and receive 433MHz wireless keyfob codes. These keyfobs are widely used for remote control of devices. + +?3|_7_segment|2016-12-12|7-Segment LED Display Multiplexing +Script to multiplex several 7-segment LED displays. Each display has the segments a-g and the decimal point connected in parallel but has an individual enable GPIO (connected to the common anode or cathode). + +?3|test-APA102_py|2017-03-28|APA102 LED strip driver +Script to drive an APA102 LED strip. Three different methods are demonstrated - using spidev SPI (only works on the local Pi), pigpio SPI, and pigpio waves. The SPI solutions only work with the dedicated SPI GPIO. Waves may use any spare GPIO. Four different examples are given including a LED strip clock. + +?3|BME280_py|2016-08-05|BME280 Sensor +Class to read the relative humidity, temperature, and pressure from a BME280 sensor. The sensor has both an I2C and a SPI interface which are both +supported by the class. + +?4|code/DHT.py|2019-11-07|DHT11/21/22/33/44 Sensor +Class to read the relative humidity and temperature from a DHT sensor. It can automatically recognize the sensor type. + +The default script prints the reading from the specified DHT every 2 seconds. E.g. ./DHT.py 22 27 displays the data for DHT connected to GPIO 22 and 27. + +The following data is printed for each DHT: timestamp, GPIO, status, temperature, and humidity. + +The timestamp is the number of seconds since the epoch (start of 1970). + +The status will be one of: 0 - a good reading, 1 - checksum failure, 2 - data had one or more invalid values, 3 - no response from sensor. + +?3|DHT22_py|2014-07-11|DHT22 AM2302 Sensor +Class to read the relative humidity and temperature from a DHT22/AM2302 sensor. + +?3|DS18B20-1_py|2016-06-29|DS18B20 Temperature Sensor +Script to read the temperature from any DS18B20 sensors connected to the 1-wire bus. + +To enable the 1-wire bus add the following line to /boot/config.txt and reboot. + +dtoverlay=w1-gpio + +By default you should connect the DS18B20 data line to GPIO 4 (pin 7). + +Connect 3V3 or 5V for power, ground to ground, 4k7 pull-up on data line to 3V3, and data line to GPIO 4. + +This script uses the file features of pigpio to access the remote file system. + +The following entry must be in /opt/pigpio/access. + +/sys/bus/w1/devices/28*/w1_slave r + +?3|PPD42NS_py|2015-11-22|Dust Sensor +Class to read a Shinyei PPD42NS Dust Sensor, e.g. as used in the Grove dust sensor. + +?3|gpio_status_py|2014-06-12|GPIO Status +Script to display the status of GPIO 0-31. + +?3|hall|2014-06-13|Hall Effect Sensor +Program to show status changes for a Hall effect sensor. + +?3|HX711_py|2018-03-05|HX711 24-bit ADC +Class to read the channels of a HX711 24-bit ADC. + +?3|i2c_ADXL345_py|2015-04-01|I2C ADXL345 Accelerometer +Script to display the X, Y, and Z values read from an ADXL345 accelerometer. + +?3|i2c_HMC5883L_py|2015-04-01|I2C HMC5883L Magnetometer +Script to display the X, Y, and Z values read from a HMC5883L Magnetometer (compass). + +?3|i2c_ITG3205_py|2015-04-01|I2C ITG3205 Gyroscope +Script to display the X, Y, Z, and temperature values read from an ITG3205 gyroscope. + +?3|i2c_lcd_py|2016-04-20|I2C LCD Display +Class to display text on a LCD character display. The class supports the PCF8574T 8-bit I2C port expander connected to a HD44780 based LCD display. These displays are commonly available in 16x2 and 20x4 character formats. + +?3|bsc_arduino_py|2016-10-31|I2C slave device +This script demonstrates how to transfer messages from an Arduino acting as the I2C bus master to the Pi acting as an I2C slave device. + +?3|I2C_sniffer|2015-06-15|I2C Sniffer +A program to passively sniff I2C transactions (100kHz bus maximum) and display the results. + +?3|i2c_sonar_py|2016-03-24|I2C Sonar +A class to read up to 8 HC-SR04 sonar rangers connected to an MCP23017 port expander. + +?3|ir_hasher_py|2014-06-12|IR Receiver +Class to hash a code from an IR receiver (reading an IR remote control). + +?3|irrp_py|2015-12-21|IR Record and Playback +This script may be used to record and play back arbitrary IR codes. + +To record the GPIO connected to the IR receiver, a file for the recorded codes, and the codes to be recorded are given. + +E.g. ./irrp.py -r -g4 -fir-codes vol+ vol- 1 2 3 4 5 6 7 8 9 0 + +To playback the GPIO connected to the IR transmitter, the file containing the recorded codes, and the codes to be played back are given. + +E.g. ./irrp.py -p -g18 -fir-codes 2 3 4 + +./irrp.py -h # for options + +?3|kivy_GPIO_py|2016-12-11|Kivy GPIO control +This example shows how to use Kivy to control a Pi's GPIO. The GPIO may be configured as inputs, outputs, or to generate Servo or PWM pulses. Kivy is an Open source Python library for rapid development of applications. + +?3|MAX6675_py|2016-05-02|MAX6675 SPI Temperature Sensor +A script to read the temperature from a MAX6675 connected to a K-type thermocouple. The MAX6675 supports readings in the range 0 - 1023.75 C. Up to 4 readings may be made per second. + +?3|monitor_py|2016-09-17|Monitor GPIO +Script to monitor GPIO for level changes. By default all GPIO are monitored. At a level change the GPIO, new level, and microseconds since the last change is printed. + +?3|morse_code_py|2015-06-17|Morse Code +Script to transmit the morse code corresponding to a text string. + +?4|code/NRF24.py|2018-01-06|NRF24 radio transceiver +Script to transmit and receive messages using the nRF24L01 radio transceiver. + +?3|PCA9685_py|2016-01-31|PCA9685 16 Channel PWM +Class to control the 16 PWM channels of the I2C PCA9685. All channels use the same frequency. The duty cycle or pulse width may be set independently for each channel. + +?3|PCF8591|2014-08-26|PCF8591 YL-40 +Script to display readings from the (I2C) PCF8591. + +?4|code/PPM.py|2016-02-19|PPM (Pulse Position Modulation) generation +Script to generate PPM signals on a chosen GPIO. + +?4|code/PPM_to_servo.py|2019-10-09|PPM (Pulse Position Modulation) to servo pulses +Script to read a PPM signal on a GPIO and generate the corresponding servo signals on chosen GPIO. + +?3|bench_1_py|2014-06-12|pigpio Benchmark +Script to benchmark the pigpio Python module's performance. + +?3|pigpio_cgi_py|2015-05-04|pigpio CGI +Script demonstrating how to access the pigpio daemon using CGI from a browser. Instructions on how to use with Apache2 on the Pi are given in the comments. + +?3|playback_py|2016-12-23|Playback piscope recordings +Script to playback GPIO data recorded in piscope format. + +To playback GPIO 4 to GPIO 4 from file data.piscope +./playback.py data.piscope 4 + +To playback GPIO 4 to GPIO 7 from file rec.txt +./playback.py rec.txt 7=4 + +?3|pot_cap_py|2016-09-26|Pot + Capacitor Recharge Timing +Class to time capacitor charging (through a resistance). The time can be used to estimate the resistance. + +?3|read_PWM_py|2015-12-08|PWM Monitor +Class to monitor a PWM signal and calculate the frequency, pulse width, and duty cycle. + +?3|rotary_encoder_py|2014-06-12|Rotary Encoder +Class to decode a mechanical rotary encoder. + +?3|read_RPM_py|2016-01-20|RPM Monitor +Class to monitor speedometer pulses and calculate the RPM (Revolutions Per Minute). + +?3|Si7021_py|2016-05-07|Si7021 I2C Temperature and Humidity Sensor +Class to read the temperature and relative humidity from a Si7021. + +?3|SPI_mon_py|2016-09-21|SPI Monitor +A program to passively sniff SPI transactions and display the results. The SPI rate should be limited to about 70kbps if using the default pigpio 5µs sampling rate. + +?3|servo_demo_py|2016-10-07|Servo Pulse Generator +This script generates servo pulses on one or more GPIO. Each connected servo is swept between 1000µs and 2000µs at a different speed. + +./servo_demo.py # Generate pulses on GPIO 4. + +./servo_demo.py 5 9 20 # Generate pulses on GPIO 5, 9, and 20. + +?3|sonar_trigger_echo_py|2014-06-12|Sonar Ranger +Class to read sonar rangers with separate trigger and echo pins. + +?3|TCS3200_py|2015-07-03|TCS3200 Colour Sensor +Class to read the TCS3200 colour sensor + +?3|vw|2015-10-31|Virtual Wire +Class to send and receive radio messages compatible with the Virtual Wire library for Arduinos. This library is commonly used with 313MHz and 434MHz radio tranceivers. + +?4|code/create_wave.py|2019-11-18|Wave create +Script to generate waves from a template defined in a text file. + +You can also specify one of py, c, or pdif - the script output will then be a complete program to generate the wave (py for Python script, c for a C program, pdif for a C program using the pigpio daemon I/F). + +If none of py, c, or pdif are chosen the waveform will be generated for 30 seconds. + +Example text file + +# GPIO levels +23 11000001 +11 01110000 +12 00011100 +4 00000111 + +To generate a pdif program with a bit time of 100 microseconds +./create_wave.py wave_file 100 pdif >wave_pdif.c + +To just transmit the wave with a bit time of 50 microseconds +./create_wave.py wave_file 50 + +?3|wave_PWM_py|2016-03-19|Wave PWM 1 +Script to show how waves may be used to generate PWM at (one) arbitrary frequency on multiple GPIO. For instance PWM at 10kHz may be generated with 100 steps between off and fully on. + +?3|wavePWM_py|2016-10-06|Wave PWM 2 +Class to generate PWM on multiple GPIO. It is more flexible than the Wave PWM 1 example in that the start of the pulse within each cycle may be specified as well as the duty cycle. The start and length of each pulse may be specified on a GPIO by GPIO basis in microseconds or as a fraction of the cycle time. The class includes a __main__ to demostrate its ability to send servo pulses. + +?3|wiegand_py|2014-06-12|Wiegand Reader +Class to read a Wiegand reader. + +?1|Misc|Miscellaneous related code + +The following code examples do not use pigpio. + +?3|adxl345_c|2014-03-12|ADXL345 +This C program reads x, y, and z accelerations from the ADXL345 via I2C address 0x53. + +?3|DS18B20_py|2016-04-25|DS18B20 Temperature Sensor +This Python script reads the temperature from any DS18B20 sensors connected to the 1-wire bus. + +To enable the 1-wire bus add the following line to /boot/config.txt and reboot. + +dtoverlay=w1-gpio + +By default you should connect the DS18B20 data line to GPIO 4 (pin 7). + +Connect 3V3 or 5V for power, ground to ground, 4k7 pull-up on data line to 3V3, and data line to GPIO 4. + +?3|EasyAsPiServer|2014-09-15|Easy as Pi Server +This Python class implements a simple server which allows broswer commands to be executed on the Pi. + +?3|minimal_clk|2015-05-20|Minimal Clock Access +This C code sets GPIO 4 to a specified clock frequency. The frequency can be set between 4.6875 kHz and 500 MHz (untested). The clock can be preferentially set from one of the sources OSC (19.2MHz), HDMI (216MHz), PLLD (500MHz), or PLLC (1000MHz). MASH can be set between 0 and 3. MASH may not work properly for clock dividers less than 5. + +?3|minimal_gpio|2019-07-03|Minimal GPIO Access +This C code has a minimal set of functions needed to control the GPIO and other Broadcom peripherals. The program requires root privileges to run. See Tiny GPIO access for an alternative which controls the GPIO (but not the other peripherals) and does not require root access. + +The code has been updated for the BCM2711 (Pi4B). + +The following functions are provided. + +gpioInitialise +gpioSetMode +gpioGetMode +gpioSetPullUpDown +gpioRead +gpioWrite +gpioTrigger +gpioReadBank1 +gpioReadBank2 +gpioClearBank1 +gpioClearBank2 +gpioSetBank1 +gpioSetBank2 +gpioHardwareRevision +gpioTick + +?3|nanopulse_c|2014-01-29|Nanosecond Pulse Generation +This C program uses the PWM peripheral to generate precisely timed pulses of very short duration. Pulses as short as 4 nano seconds can be generated. + +?3|PCF8591-x|2014-08-26|PCF8591 YL-40 +C and Python code to read the (I2C) PCF8591. + +?4|code/spi-driver-speed.c|2016-11-06|SPI Linux driver speed test +This C code is used to benchmark the Linux SPI driver on the Pi. The code executes a given number of loops at a given baud rate and bytes per transfer. + +?3|tiny_gpio|2016-04-30|Tiny GPIO Access +This C code has a minimal set of functions needed to control the GPIO without needing root privileges (it uses /dev/gpiomem to access the GPIO). + +You may need to change the permissions and ownership of /dev/gpiomem if they have not been correctly set up. + +sudo chown root:gpio /dev/gpiomem +sudo chmod g+rw /dev/gpiomem + +The user (default pi) needs to be in the gpio group. + +sudo adduser pi gpio + +The following functions are provided. + +gpioInitialise +gpioSetMode +gpioGetMode +gpioSetPullUpDown +gpioRead +gpioWrite +gpioTrigger +gpioReadBank1 +gpioReadBank2 +gpioClearBank1 +gpioClearBank2 +gpioSetBank1 +gpioSetBank2 +gpioHardwareRevision + +?1|External|External links + +Related code. + +?4|https://pypi.org/project/nrf24/|2020-04-20|NRF24 +Python Package Index (Pypi) NRF24 module. +pip install nrf24 + +?4|https://github.com/bjarne-hansen/py-nrf24|2020-04-20|NRF24 +Code and example usage of the Pypi NRF24 module. Cleaned up and added support for reading from multiple pipes using open_reading_pipe(pipe, address) and open_writing_pipe(address) in order to be more "compatible" with the way NRF24 is used on Arduinos. + +?4|https://github.com/paulvee/pigpio-serial-bb-examples|2020-11-16|bit bang serial RX +Example code showing how to use the bit banged serial links. + +One example shows how to read the serial data from an Arduino based counter, that sends results every 1,000 or 10,000 seconds. + +Another example shows how to parse into sentences the NMEA stream coming from a U-Blox GPS module. + +?4|https://github.com/stripcode/pigpio-stepper-motor|2016-08-12|Stepper Motor +Stepper motor code. + +?4|https://github.com/choeffer/360pibot|2018-11-03|Parallax ActivityBot 360 +Python 3 implementation for programming a Parallax ActivityBot 360 Robot Kit with a Raspberry Pi. + +?1|Index|Index + diff --git a/pigpio-master/DOC/src/defs/pig2vcd.def b/pigpio-master/DOC/src/defs/pig2vcd.def new file mode 100644 index 0000000..48e1013 --- /dev/null +++ b/pigpio-master/DOC/src/defs/pig2vcd.def @@ -0,0 +1,110 @@ + +/*TEXT +pig2vcd is a utility which reads notifications on stdin and writes the +output as a Value Change Dump (VCD) file on stdout. + +The VCD file can be viewed using GTKWave. + +*Notifications* + +Notifications consist of 12 bytes with the following binary format. + +. . +typedef struct +{ + uint16_t seqno; + uint16_t flags; + uint32_t tick; + uint32_t level; +} gpioReport_t; +. . + +seqno: starts at 0 each time the handle is opened and then increments by one for each report. + +flags: two flags are defined, PI_NTFY_FLAGS_WDOG and PI_NTFY_FLAGS_ALIVE. If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags indicate a gpio which has had a watchdog timeout; if bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive signal on the pipe/socket and is sent once a minute in the absence of other notification activity. + +tick: the number of microseconds since system boot. It wraps around after 1h12m. + +level: indicates the level of each gpio. If bit 1</dev/pigpio + +pigs will show the result of the command on screen. + +The pigs process returns an exit status (which can be displayed with +the command echo $?). + +... +PIGS_OK 0 +PIGS_CONNECT_ERR 255 +PIGS_OPTION_ERR 254 +PIGS_SCRIPT_ERR 253 +... + +The results of /dev/pigpio commands need to be read from /dev/pigout, +e.g. cat /dev/pigout (try cat /dev/pigout& so that all subsequent +results are shown on screen). + +In both cases if an error was detected a message will have been written +to /dev/pigerr (try cat /dev/pigerr&). This is likely to be more +informative than the message returned by pigs or the error code +returned by the pipe interface. + +Several commands may be entered on a line. If present PROC and PARSE must +be the last command on a line. + +E.g. + +... +pigs w 22 1 mils 1000 w 22 0 +... + +is equivalent to + +... +pigs w 22 1 +pigs mils 1000 +pigs w 22 0 +... + +and + +... +echo "m 4 w w 4 0 mils 250 m 4 r r 4" >/dev/pigpio +... + +is equivalent to + +... +echo "m 4 w" >/dev/pigpio +echo "w 4 0" >/dev/pigpio +echo "mils 250" >/dev/pigpio +echo "m 4 r" >/dev/pigpio +echo "r 4" >/dev/pigpio +... + +*Notes* + +The examples from now on will show the pigs interface but the same +commands will also work on the pipe interface. + +pigs does not show the status of successful commands unless the +command itself returns data. The status (0) will be returned to +pigs but will be discarded. + +The status/data of each command sent to the pipe interface should +be read from /dev/pigout. + +When a command takes a number as a parameter it may be entered as hex +(precede by 0x), octal (precede by 0), or decimal. + +E.g. 23 is 23 decimal, 0x100 is 256 decimal, 070 is 56 decimal. + +Some commands can return a variable number of data bytes. By +default this data is displayed as decimal. The pigs -a option +can be used to force the display as ASCII and the pigs -x +option can be used to force the display as hex. + +E.g. assuming the transmitted serial data is the letters ABCDEONM + +... +$ pigs slr 4 100 +8 65 66 67 68 69 79 78 77 + +$ pigs -a slr 4 100 +8 ABCDEONM + +$ pigs -x slr 4 100 +8 41 42 43 44 45 4f 4e 4d +... + +OVERVIEW + +BASIC + +M/MODES g m :: Set GPIO mode :: gpioSetMode +MG/MODEG g :: Get GPIO mode :: gpioGetMode + +PUD g p :: Set GPIO pull up/down :: gpioSetPullUpDown + +R/READ g :: Read GPIO level :: gpioRead +W/WRITE g L :: Write GPIO level :: gpioWrite + +PWM (overrides servo commands on same GPIO) + +P/PWM u v :: Set GPIO PWM value :: gpioPWM +PFS u v :: Set GPIO PWM frequency :: gpioSetPWMfrequency +PRS u v :: Set GPIO PWM range :: gpioSetPWMrange + +GDC u :: Get GPIO PWM dutycycle :: gpioGetPWMdutycycle +PFG u :: Get GPIO PWM frequency :: gpioGetPWMfrequency +PRG u :: Get GPIO PWM range :: gpioGetPWMrange + +PRRG u :: Get GPIO PWM real range :: gpioGetPWMrealRange + +Servo (overrides PWM commands on same GPIO) + +S/SERVO u v :: Set GPIO servo pulsewidth :: gpioServo + +GPW u :: Get GPIO servo pulsewidth :: gpioGetServoPulsewidth + +INTERMEDIATE + +TRIG u pl L :: Send a trigger pulse :: gpioTrigger + +WDOG u v :: Set GPIO watchdog :: gpioSetWatchdog + +BR1 :: Read bank 1 GPIO :: gpioRead_Bits_0_31 +BR2 :: Read bank 2 GPIO :: gpioRead_Bits_32_53 + +BC1 bits :: Clear specified GPIO in bank 1 :: gpioWrite_Bits_0_31_Clear +BC2 bits :: Clear specified GPIO in bank 2 :: gpioWrite_Bits_32_53_Clear + +BS1 bits :: Set specified GPIO in bank 1 :: gpioWrite_Bits_0_31_Set +BS2 bits :: Set specified GPIO in bank 2 :: gpioWrite_Bits_32_53_Set + +ADVANCED + +NO :: Request a notification :: gpioNotifyOpen +NC h :: Close notification :: gpioNotifyClose +NB h bits :: Start notification :: gpioNotifyBegin +NP h :: Pause notification :: gpioNotifyPause + +HC g cf :: Set hardware clock frequency :: gpioHardwareClock + +HP g pf pdc :: Set hardware PWM frequency and dutycycle :: gpioHardwarePWM + +FG u stdy :: Set a glitch filter on a GPIO :: gpioGlitchFilter +FN u stdy actv :: Set a noise filter on a GPIO :: gpioNoiseFilter + +PADS pad padma :: Set pad drive strength :: gpioSetPad +PADG pad :: Get pad drive strength :: gpioGetPad + +SHELL name str :: Execute a shell command :: shell + +Custom + +CF1 uvs :: Custom function 1 :: gpioCustom1 +CF2 uvs :: Custom function 2 :: gpioCustom1 + +Events + +EVM h bits :: Set events to monitor :: eventMonitor +EVT event :: Trigger event :: eventTrigger + +Scripts + +PROC t :: Store script :: gpioStoreScript +PROCR sid pars :: Run script :: gpioRunScript +PROCU sid pars :: Set script parameters :: gpioUpdateScript +PROCP sid :: Get script status and parameters :: gpioScriptStatus +PROCS sid :: Stop script :: gpioStopScript +PROCD sid :: Delete script :: gpioDeleteScript + +PARSE t :: Validate script :: gpioParseScript + +I2C + +I2CO ib id if :: Open I2C bus and device with flags :: i2cOpen +I2CC h :: Close I2C handle :: i2cClose + +I2CWQ h bit :: smb Write Quick: write bit :: i2cWriteQuick + +I2CRS h :: smb Read Byte: read byte :: i2cReadByte +I2CWS h bv :: smb Write Byte: write byte :: i2cWriteByte + +I2CRB h r :: smb Read Byte Data: read byte from register :: i2cReadByteData +I2CWB h r bv :: smb Write Byte Data: write byte to register :: i2cWriteByteData + +I2CRW h r :: smb Read Word Data: read word from register :: i2cReadWordData +I2CWW h r wv :: smb Write Word Data: write word to register :: i2cWriteWordData + +I2CRK h r :: smb Read Block Data: read data from register :: i2cReadBlockData +I2CWK h r bvs :: smb Write Block Data: write data to register :: i2cWriteBlockData + +I2CWI h r bvs :: smb Write I2C Block Data :: i2cWriteI2CBlockData +I2CRI h r num :: smb Read I2C Block Data: read bytes from register :: i2cReadI2CBlockData + +I2CRD h num :: i2c Read device :: i2cReadDevice +I2CWD h bvs :: i2c Write device :: i2cWriteDevice + +I2CPC h r wv :: smb Process Call: exchange register with word :: i2cProcessCall +I2CPK h r bvs :: smb Block Process Call: exchange data bytes with register :: i2cBlockProcessCall + +I2CZ h bvs :: Performs multiple I2C transactions :: i2cZip + +I2C BIT BANG + +BI2CO sda scl b :: Open bit bang I2C :: bbI2COpen +BI2CC sda :: Close bit bang I2C :: bbI2CClose + +BI2CZ sda bvs :: I2C bit bang multiple transactions :: bbI2CZip + +I2C/SPI SLAVE + +BSCX bctl bvs :: BSC I2C/SPI transfer :: bscXfer + +SERIAL + +SERO dev b sef :: Open serial device dev at baud b with flags :: serOpen +SERC h :: Close serial handle :: serClose + +SERRB :: Read byte from serial handle :: serReadByte +SERWB h bv :: Write byte to serial handle :: serWriteByte + +SERR h num :: Read bytes from serial handle :: serRead +SERW h bvs :: Write bytes to serial handle :: serWrite + +SERDA h :: Check for serial data ready to read :: serDataAvailable + +SERIAL BIT BANG (read only) + +SLRO u b db :: Open GPIO for bit bang serial data :: gpioSerialReadOpen +SLRC u :: Close GPIO for bit bang serial data :: gpioSerialReadClose + +SLRI u v :: Sets bit bang serial data logic levels :: gpioSerialReadInvert + +SLR u num :: Read bit bang serial data from GPIO :: gpioSerialRead + +SPI + +SPIO c b spf :: SPI open channel at baud b with flags :: spiOpen +SPIC h :: SPI close handle :: spiClose + +SPIR h num :: SPI read bytes from handle :: spiRead +SPIW h bvs :: SPI write bytes to handle :: spiWrite +SPIX h bvs :: SPI transfer bytes to handle :: spiXfer + +SPI BIT BANG + +BSPIO cs miso mosi sclk b spf :: Open bit bang SPI :: bbSPIOpen +BSPIC cs :: Close bit bang SPI :: bbSPIClose + +BSPIX cs bvs :: SPI bit bang transfer :: bbSPIXfer + +FILES + +FO file mode :: Open a file in mode :: fileOpen +FC h :: Close file handle :: fileClose + +FR h num :: Read bytes from file handle :: fileRead +FW h bvs :: Write bytes to file handle :: fileWrite + +FS h num from :: Seek to file handle position :: fileSeek + +FL pat num :: List files which match pattern :: fileList + +WAVES + +WVCLR :: Clear all waveforms :: gpioWaveClear + +WVNEW :: Initialise a new waveform :: gpioWaveAddNew +WVAG trips :: Add generic pulses to waveform :: gpioWaveAddGeneric +WVAS u b db sb o bvs :: Add serial data to waveform :: gpioWaveAddSerial + +WVCRE :: Create a waveform :: gpioWaveCreate +WVCAP percent :: Create a waveform of fixed size :: gpioWaveCreatePad +WVDEL wid :: Delete selected waveform :: gpioWaveDelete + +WVTX wid :: Transmits waveform once :: gpioWaveTxSend +WVTXM wid wmde :: Transmits waveform using mode :: gpioWaveTxSend +WVTXR wid :: Transmits waveform repeatedly :: gpioWaveTxSend + +WVCHA bvs :: Transmits a chain of waveforms :: gpioWaveChain + +WVTAT :: Returns the current transmitting waveform :: gpioWaveTxAt + +WVBSY :: Check if waveform is being transmitted :: gpioWaveTxBusy + +WVHLT :: Stop waveform :: gpioWaveTxStop + +WVSC ws :: Get waveform DMA CB stats :: gpioWaveGetCbs +WVSM ws :: Get waveform time stats :: gpioWaveGetMicros +WVSP ws :: Get waveform pulse stats :: gpioWaveGetPulses + +UTILITIES + +H/HELP :: Display command help :: +HWVER :: Get hardware version :: gpioHardwareRevision +MICS v :: Microseconds delay :: gpioDelay +MILS v :: Milliseconds delay :: gpioDelay +PIGPV :: Get pigpio library version :: gpioVersion +T/TICK :: Get current tick :: gpioTick + +CONFIGURATION + +CGI :: Configuration get internals :: gpioCfgGetInternals +CSI v :: Configuration set internals :: gpioCfgSetInternals + +COMMANDS + +BC1 :: +This command clears (sets low) the GPIO specified by [*bits*] in bank 1. +Bank 1 consists of GPIO 0-31. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs bc1 0x400010 # clear GPIO 4 (1<<4) and 22 (1<<22) + +$ pigs bc1 32 # clear GPIO 5 (1<<5) +-42 +ERROR: no permission to update one or more GPIO +... + +BC2 :: +This command clears (sets low) the GPIO specified by [*bits*] in bank 2. +Bank 2 consists of GPIO 32-53. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs bc2 0x8000 # clear GPIO 47 (activity LED on A+/B+/Pi2/Pi3) + +$ pigs bc2 1 # clear GPIO 32 (first in bank 2) +-42 +ERROR: no permission to update one or more GPIO +... + +BI2CC :: +This command signals that bit banging I2C on [*sda*] (and [*scl*]) is no +longer required. + +... +$ pigs bi2cc 5 +... + +BI2CO :: +This command signals that GPIO [*sda*] and [*scl*] are to be used +for bit banging I2C at [*b*] baud. + +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +o baud rates as low as 50 +o repeated starts +o clock stretching +o I2C on any pair of spare GPIO + +The baud rate may be between 50 and 500000 bits per second. + +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + +BI2CZ :: +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of [*bvs*] +which contains the concatenated command codes and associated data. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +Start @ 2 @ Start condition +Stop @ 3 @ Stop condition +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +No flags are currently defined. + +... +Set address 0x53 +start, write 0x32, (re)start, read 6 bytes, stop +Set address 0x1E +start, write 0x03, (re)start, read 6 bytes, stop +Set address 0x68 +start, write 0x1B, (re)start, read 8 bytes, stop +End + +0x04 0x53 +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 + +0x04 0x1E +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 + +0x04 0x68 +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 + +0x00 +... + +BR1 :: +This command read GPIO 0-31 (bank 1) and returns the levels as a +32-bit hexadecimal value. + +... +$ pigs br1 +1001C1CF +... + +BR2 :: +This command read GPIO 32-53 (bank 2) and returns the levels as a +32-bit hexadecimal value. + +... +$ pigs br2 +003F0000 +... + +BS1 :: +This command sets (sets high) the GPIO specified by [*bits*] in bank 1. +Bank 1 consists of GPIO 0-31. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs bs1 16 # set GPIO 4 (1<<4) + +$ pigs bs1 1 # set GPIO 1 (1<<0) +-42 +ERROR: no permission to update one or more GPIO +... + +BS2 :: +This command sets (sets high) the GPIO specified by [*bits*] in bank 2. +Bank 2 consists of GPIO 32-53. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs bs2 0x40 # set GPIO 38 (enable high current mode A+/B+/Pi2/Pi3) + +$ pigs bs2 1 # set GPIO 32 (first in bank 2) +-42 +ERROR: no permission to update one or more GPIO +... + +BSCX :: + +This command performs a BSC I2C/SPI slave transfer as defined by +[*bctl*] with data [*bvs*]. + +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +The command sets the BSC mode and writes any data [*bvs*] +to the BSC transmit FIFO. It returns the data count (at least 1 +for the status word), the status word, followed by any data bytes +read from the BSC receive FIFO. + +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +For I2C use a control word of (I2C address << 16) + 0x305. + +E.g. to talk as I2C slave with address 0x13 use 0x130305. + +GPIO used for models other than those based on the BCM2711. + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 18 @ 19 @ - @ - @ - @ - +SPI @ - @ - @ 20 @ 19 @ 18 @ 21 + +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 10 @ 11 @ - @ - @ - @ - +SPI @ - @ - @ 9 @ 11 @ 10 @ 8 + +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +The control word consists of the following bits. + +. . +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +. . + +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +aaaaaaa @ defines the I2C slave address (only relevant in I2C mode) +IT @ invert transmit status flags +HC @ enable host control +TF @ enable test FIFO +IR @ invert receive status flags +RE @ enable receive +TE @ enable transmit +BK @ abort operation and clear FIFOs +EC @ send control register as first I2C byte +ES @ send status register as first I2C byte +PL @ set SPI polarity high +PH @ set SPI phase high +I2 @ enable I2C mode +SP @ enable SPI mode +EN @ enable BSC peripheral + +The returned status has the following format + +. . +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + S S S S S R R R R R T T T T T RB TE RF TF RE TB +. . + +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +SSSSS @ number of bytes successfully copied to transmit FIFO +RRRRR @ number of bytes in receieve FIFO +TTTTT @ number of bytes in transmit FIFO +RB @ receive busy +TE @ transmit FIFO empty +RF @ receive FIFO full +TF @ transmit FIFO full +RE @ receive FIFO empty +TB @ transmit busy + +This example assumes that GPIO 2/3 are connected to GPIO 18/19 +(GPIO 10/11 on the BCM2711). + +... +$ pigs bscx 0x130305 # start BSC as I2C slave 0x13 +1 18 + +$ i2cdetect -y 1 + 0 1 2 3 4 5 6 7 8 9 a b c d e f +00: -- -- -- -- -- -- -- -- -- -- -- -- -- +10: -- -- -- 13 -- -- -- -- -- -- -- -- -- -- -- -- +20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +70: -- -- -- -- -- -- -- -- + +$ pigs i2co 1 0x13 0 # get handle for device 0x13 on bus 1 +0 + +$ pigs i2cwd 0 90 87 51 9 23 # write 5 bytes + +$ pigs bscx 0x130305 # check for data +6 18 90 87 51 9 23 + +$ pigs bscx 0x130305 11 13 15 17 # check for data and send 4 bytes +1 262338 + +$ pigs i2crd 0 4 # read 4 bytes +4 11 13 15 17 + +$ pigs i2cwd 0 90 87 51 9 23 # write 5 bytes +$ pigs bscx 0x130305 11 13 15 17 # check for data and send 4 bytes +6 262338 90 87 51 9 23 + +$ pigs i2crd 0 4 +4 11 13 15 17 + +$ pigs bscx 0x130305 22 33 44 55 66 +1 327938 +$ pigs i2crd 0 5 +5 22 33 44 55 66 +... + +The BSC slave in SPI mode deserializes data from the MOSI pin into its receiver/ +FIFO when the LSB of the first byte is a 0. No data is output on the MISO pin. +When the LSB of the first byte on MOSI is a 1, the transmitter/FIFO data is +serialized onto the MISO pin while all other data on the MOSI pin is ignored. + +The BK bit of the BSC control register is non-functional when in the SPI mode. +The transmitter along with its FIFO can be dequeued by successively disabling +and re-enabling the TE bit on the BSC control register while in SPI mode. + +This example demonstrates a SPI master talking to the BSC as SPI slave: +Requires SPI master SCLK / MOSI / MISO / CE GPIO are connected to +BSC peripheral GPIO 11 / 9 / 10 / 8 respectively, on a Pi4B (BCM2711). + +... +$ pigs bspio 15 26 13 14 10000 0 # open bit-bang spi master on random gpio + +$ pigs bscx 0x303 # start BSC as SPI slave, both rx and tx enabled +1 18 + +$ pigs bspix 15 0 0xd 0xe 0xa 0xd # write 0xdead to BSC +5 0 0 0 0 0 + +$ pigs bscx 0x303 0xb 0xe 0xe 0xf # place 0xbeef in BSC tx FIFO, read rx FIFO +5 262338 13 14 10 13 + +$ pigs bspix 15 1 0 0 0 0 # read four bytes from BSC +5 0 11 14 14 15 +... + +BSPIC :: + +This command stops bit banging SPI on a set of GPIO +opened with [*BSPIO*]. + +The set of GPIO is specifed by [*cs*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs bspic 10 + +$ pigs bspic 10 +-142 +ERROR: no bit bang SPI in progress on GPIO +... + +BSPIO :: + +This command starts bit banging SPI on a group of GPIO with slave +select [*cs*], MISO [*miso*], MOSI [*mosi*], and clock [*sclk*]. + +Data will be transferred at baud [*b*] bits per second (which may +be set in the range 50-250000). + +The flags [*spf*] may be used to modify the default behaviour of +mode 0, active low chip select. + +The flags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +. . + +mm defines the SPI mode. + +. . +Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +p is 0 if CS is active low (default) and 1 for active high. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +The other bits in flags should be set to zero. + +Upon success 0 is returned. On error a negative status code +will be returned. + +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +... +$ pigs bspio 9 11 12 13 50000 0 + +$ pigs bspio 10 11 12 13 50000 0 + +$ pigs bspio 29 19 20 21 50000 0 # GPIO 29 not avaialble on this Pi +-41 +ERROR: no permission to update GPIO +... + +BSPIX:: + +This command writes bytes [*bvs*] to the bit bang SPI device +associated with slave select [*cs*]. It returns the same +number of bytes read from the device. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs bspio 5 13 19 12 10000 0 # MCP4251 DAC +$ pigs bspio 6 13 19 12 20000 3 # MCP3008 ADC + +$ pigs bspix 5 0 16 # set DAC to 16 +2 255 255 + +$ pigs bspix 5 12 0 # read back DAC +2 254 16 + +$ pigs bspix 6 1 128 0 # read ADC input 0 +3 0 3 184 # 952 + +$ pigs bspix 5 0 240 # set DAC to 240 +2 255 255 + +$ pigs bspix 5 12 0 # read back DAC +2 254 240 + +$ pigs bspix 6 1 128 0 # read ADC input 0 +3 0 0 63 # 63 + +$ pigs bspix 5 0 128 # set DAC to 128 +2 255 255 + +$ pigs bspix 5 12 0 # read back DAC +2 254 128 + +$ pigs bspix 6 1 128 0 # read ADC input 0 +3 0 1 255 # 511 + +$ pigs bspic 5 # close SPI CS 5 +$ pigs bspic 6 # close SPI CS 6 + +$ pigs bspic 5 # try to close SPI CS 5 again +-142 +ERROR: no bit bang SPI in progress on GPIO +... + + +CF1:: + +This command calls a user customised function. The meaning of +any paramaters and the returned value is defined by the +customiser. + +CF2:: + +This command calls a user customised function. The meaning of +any paramaters and the returned value is defined by the +customiser. + +CGI:: +This command returns the value of the internal library +configuration settings. + +CSI:: +This command sets the value of the internal library +configuration settings to [*v*]. + +EVM :: +This command starts event reporting on handle [*h*] (returned by +a prior call to [*NO*]). + +Upon success nothing is returned. On error a negative status code +will be returned. + +The notification gets reports for each event specified by [*bits*]. + +... +$ pigs evm 0 -1 # Shorthand for events 0-31. +$ pigs evm 0 0xf0 # Get notifications for events 4-7. + +$ pigs evm 1 0xf +-25 +ERROR: unknown handle +... + +EVT :: +This command triggers event [*event*]. + +One event, number 31, is predefined. This event is +auto generated on BSC slave activity. + +... +$ pigs evt 12 +$ pigs evt 5 + +$ pigs evt 32 +-143 +ERROR: bad event id +... + +FC:: +This command closes a file handle [*h*] previously opened with [*FO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs fc 0 # First close okay. + +$ pigs fc 0 # Second fails. +-25 +ERROR: unknown handle +... + +FG :: + +Level changes on the GPIO [*u*] are not reported unless the level +has been stable for at least [*stdy*] microseconds. The +level is then reported. Level changes of less than [*stdy*] +microseconds are ignored. + +The filter only affects callbacks (including pipe notifications). + +The [*R/READ*], [*BR1*], and [*BR2*] commands are not affected. + +Note, each (stable) edge will be timestamped [*stdy*] microseconds +after it was first detected. + +... +$ pigs fg 4 250 + +$ pigs fg 4 1000000 +-125 +ERROR: bad filter parameter +... + +FL :: +This command returns a list of the files matching [*pat*]. Up +to [*num*] bytes may be returned. + +Upon success the count of returned bytes followed by the matching +files is returned. On error a negative status code will be returned. + +A newline (0x0a) character separates each file name. + +Only files which have a matching entry in /opt/pigpio/access may +be listed. + +Suppose /opt/pigpio/access contains + +/sys/bus/w1/devices/28*/w1_slave r + +... +$ pigs -a fl "/sys/bus/w1/devices/28*/w1_slave" 5000 +90 /sys/bus/w1/devices/28-000005d34cd2/w1_slave +/sys/bus/w1/devices/28-001414abbeff/w1_slave + +$ pigs -a fl "/sys/bus/*" 5000 +ERROR: no permission to access file +-137 +... + +FN :: + +Level changes on the GPIO [*u*] are ignored until a level which has +been stable for [*stdy*] microseconds is detected. Level +changes on the GPIO are then reported for [*actv*] microseconds +after which the process repeats. + +The filter only affects callbacks (including pipe notifications). + +The [*R/READ*], [*BR1*], and [*BR2*] commands are not affected. + +Note, level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. + +... +$ pigs fn 7 250 1000 + +$ pigs fn 7 2500000 1000 +-125 +ERROR: bad filter parameter +... + +FO :: +This function returns a handle to a file [*file*] opened +in a specified mode [*mode*]. + +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +File + +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +Suppose /opt/pigpio/access contains the following entries + +. . +/home/* n +/home/pi/shared/dir_1/* w +/home/pi/shared/dir_2/* r +/home/pi/shared/dir_3/* u +/home/pi/shared/dir_1/file.txt n +. . + +Files may be written in directory dir_1 with the exception +of file.txt. + +Files may be read in directory dir_2. + +Files may be read and written in directory dir_3. + +If a directory allows read, write, or read/write access then files may +be created in that directory. + +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +. . +a path containing .. +a path containing only wildcards (*?) +a path containing less than two non-wildcard parts +. . + +Mode + +The mode may have the following values. + + @ Value @ Meaning +READ @ 1 @ open file for reading +WRITE @ 2 @ open file for writing +RW @ 3 @ open file for reading and writing + +The following values may be or'd into the mode. + + @ Value @ Meaning +APPEND @ 4 @ All writes append data to the end of the file +CREATE @ 8 @ The file is created if it doesn't exist +TRUNC @ 16 @ The file is truncated + +Newly created files are owned by root with permissions owner read and write. + +... +$ ls /ram/*.c +/ram/command.c /ram/pigpiod.c /ram/pigs.c +/ram/x_pigpiod_if.c /ram/pig2vcd.c /ram/pigpiod_if2.c +/ram/x_pigpio.c /ram/x_repeat.c /ram/pigpio.c +/ram/pigpiod_if.c /ram/x_pigpiod_if2.c + +# assumes /opt/pigpio/access contains the following line +# /ram/*.c r + +$ pigs fo /ram/pigpio.c 1 +0 + +$ pigs fo /ram/new.c 1 +-128 +ERROR: file open failed + +$ pigs fo /ram/new.c 9 +1 + +$ ls /ram/*.c -l +-rw-r--r-- 1 joan joan 42923 Jul 10 11:22 /ram/command.c +-rw------- 1 root root 0 Jul 10 16:54 /ram/new.c +-rw-r--r-- 1 joan joan 2971 Jul 10 11:22 /ram/pig2vcd.c +-rw------- 1 joan joan 296235 Jul 10 11:22 /ram/pigpio.c +-rw-r--r-- 1 joan joan 9266 Jul 10 11:22 /ram/pigpiod.c +-rw-r--r-- 1 joan joan 37331 Jul 10 11:22 /ram/pigpiod_if2.c +-rw-r--r-- 1 joan joan 33088 Jul 10 11:22 /ram/pigpiod_if.c +-rw-r--r-- 1 joan joan 7990 Jul 10 11:22 /ram/pigs.c +-rw-r--r-- 1 joan joan 19970 Jul 10 11:22 /ram/x_pigpio.c +-rw-r--r-- 1 joan joan 20804 Jul 10 11:22 /ram/x_pigpiod_if2.c +-rw-r--r-- 1 joan joan 19844 Jul 10 11:22 /ram/x_pigpiod_if.c +-rw-r--r-- 1 joan joan 19907 Jul 10 11:22 /ram/x_repeat.c +... + +FR:: +This command returns up to [*num*] bytes of data read from the +file associated with handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs fr 0 10 +5 48 49 128 144 255 + +$ pigs fr 0 10 +0 +... + +FS :: +This command seeks to a position within the file associated +with handle [*h*]. + +The number of bytes to move is [*num*]. Positive offsets +move forward, negative offsets backwards. The move start +position is determined by [*from*] as follows. + + @ From +0 @ start +1 @ current position +2 @ end + +Upon success the new byte position within the file (>=0) is +returned. On error a negative status code will be returned. + +... +$ pigs fs 0 200 0 # Seek to start of file plus 200 +200 + +$ pigs fs 0 0 1 # Return current position +200 + +$ pigs fs 0 0 2 # Seek to end of file, return size +296235 +... + +FW:: +This command writes bytes [*bvs*] to the file +associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs fw 0 23 45 67 89 +... + +GDC :: + +This command returns the PWM dutycycle in use on GPIO [*u*]. + +Upon success the dutycycle is returned. On error a negative +status code will be returned. + +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see [*PRG*]). + +If a hardware clock is active on the GPIO the reported +dutycycle will be 500000 (500k) out of 1000000 (1M). + +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +... +$ pigs p 4 129 +$ pigs gdc 4 +129 + +pigs gdc 5 +-92 +ERROR: GPIO is not in use for PWM +... + +GPW :: + +This command returns the servo pulsewidth in use on GPIO [*u*]. + +Upon success the servo pulsewidth is returned. On error a negative +status code will be returned. + +... +$ pigs s 4 1235 +$ pigs gpw 4 +1235 + +$ pigs gpw 9 +-93 +ERROR: GPIO is not in use for servo pulses +... + +H/HELP :: +This command displays a brief list of the commands and their parameters. + +... +$ pigs h + +$ pigs help +... + +HC :: +This command sets the hardware clock associated with GPIO [*g*] to +frequency [*cf*]. Frequencies above 30MHz are unlikely to work. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs hc 4 5000 # start a 5 KHz clock on GPIO 4 (clock 0) + +$ pigs hc 5 5000000 # start a 5 MHz clcok on GPIO 5 (clock 1) +-99 +ERROR: need password to use hardware clock 1 +... + +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +The GPIO must be one of the following. + +4 @clock 0 @All models +5 @clock 1 @All models but A and B (reserved for system use) +6 @clock 2 @All models but A and B +20 @clock 0 @All models but A and B +21 @clock 1 @All models but A and B Rev.2 (reserved for system use) + +32 @clock 0 @Compute module only +34 @clock 0 @Compute module only +42 @clock 1 @Compute module only (reserved for system use) +43 @clock 2 @Compute module only +44 @clock 1 @Compute module only (reserved for system use) + +Access to clock 1 is protected by a password as its use will +likely crash the Pi. The password is given by or'ing 0x5A000000 +with the GPIO number. + +HP :: +This command sets the hardware PWM associated with GPIO [*g*] to +frequency [*pf*] with dutycycle [*pdc*]. Frequencies above 30MHz +are unlikely to work. + +NOTE: Any waveform started by [*WVTX*], [*WVTXR*], or [*WVCHA*] +will be cancelled. + +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden when the pigpio +daemon is started (option -t). + +Upon success nothing is returned. On error a negative status code +will be returned. + +. . +$ pigs hp 18 100 800000 # 80% dutycycle + +$ pigs hp 19 100 200000 # 20% dutycycle + +$ pigs hp 19 400000000 100000 +-96 +ERROR: invalid hardware PWM frequency +. . + +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +The GPIO must be one of the following. + +12 @PWM channel 0 @All models but A and B +13 @PWM channel 1 @All models but A and B +18 @PWM channel 0 @All models +19 @PWM channel 1 @All models but A and B + +40 @PWM channel 0 @Compute module only +41 @PWM channel 1 @Compute module only +45 @PWM channel 1 @Compute module only +52 @PWM channel 0 @Compute module only +53 @PWM channel 1 @Compute module only + +The actual number of steps beween off and fully on is the +integral part of 250M/[*pf*] (375M/[*pf*] for the BCM2711). + +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +There will only be a million steps for a [*pf*] of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. [*pdc*] is +automatically scaled to take this into account. + +HWVER :: +This command returns the hardware revision of the Pi. + +The hardware revision is found in the last 4 characters on the revision +line of /proc/cpuinfo. + +If the hardware revision can not be found or is not a valid hexadecimal +number the command returns 0. + +The revision number can be used to determine the assignment of GPIO +to pins (see [*g*]). + +There are currently three types of board. + +Type 1 boards have hardware revision numbers of 2 and 3. + +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +Type 3 boards have hardware revision numbers of 16 or greater. + +for "Revision : 0002" the command returns 2. + +for "Revision : 000f" the command returns 15. + +for "Revision : 000g" the command returns 0. + +... +$ pigs hwver # On a B+ +16 +... + +I2CC :: +This command closes an I2C handle [*h*] previously opened with [*I2CO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cc 0 # First close okay. + +$ pigs i2cc 0 # Second fails. +-25 +ERROR: unknown handle +... + +I2CO :: +This command returns a handle to access device [*id*] on I2C bus [*ib*]. +The device is opened with flags [*if*]. + +Physically buses 0 and 1 are available on the Pi. Higher +numbered buses will be available if a kernel supported bus +multiplexor is being used. + +The GPIO used are given in the following table. + + @ SDA @ SCL +I2C 0 @ 0 @ 1 +I2C 1 @ 2 @ 3 + +No flags are currently defined. The parameter [*if*] should be 0. + +Upon success the next free handle (>=0) is returned. On error a +negative status code will be returned. + +... +$ pigs i2co 1 0x70 0 # Bus 1, device 0x70, flags 0. +0 + +$ pigs i2co 1 0x53 0 # Bus 1, device 0x53, flags 0. +1 +... + +I2CPC :: +This command writes [*wv*] to register [*r*] of the I2C device +associated with handle [*h*] and returns a 16-bit word read from the +device. + +Upon success a value between 0 and 65535 will be returned. On error +a negative status code will be returned. + +... +$ pigs i2cpc 0 37 43210 +39933 + +$ pigs i2cpc 0 256 43210 +ERROR: bad i2c/spi/ser parameter +-81 +... + +I2CPK :: + +This command writes the data bytes [*bvs*] to register [*r*] of the I2C device +associated with handle [*h*] and returns a device specific number of bytes. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs i2cpk 0 0 0x11 0x12 +6 0 0 0 0 0 0 +... + +I2CRB :: + +This command returns a single byte read from register [*r*] of the I2C device +associated with handle [*h*]. + +Upon success a value between 0 and 255 will be returned. On error +a negative status code will be returned. + +... +$ pigs i2crb 0 0 +6 +... + +I2CRD :: + +This command returns [*num*] bytes read from the I2C device associated with +handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +This command operates on the raw I2C device. The maximum value of the +parameter [*num*] is dependent on the I2C drivers and the device +itself. pigs imposes a limit of about 8000 bytes. + +... +$ pigs i2crd 0 16 +16 6 24 0 0 0 0 0 0 0 0 0 0 0 0 32 78 +... + +I2CRI :: + +This command returns [*num*] bytes from register [*r*] of the I2C device +associated with handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +The parameter [*num*] may be 1-32. + +... +$ pigs i2cri 0 0 16 +16 237 155 155 155 155 155 155 155 155 155 155 155 155 155 155 155 +... + +I2CRK :: + +This command returns between 1 and 32 bytes read from register [*r*] of +the I2C device associated with handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +The number of bytes of returned data is specific to the device and +register. + +... +$ pigs i2crk 0 0 +6 0 0 0 0 0 0 + +$ pigs i2crk 0 1 +24 0 0 0 0 0 0 0 0 0 0 0 0 120 222 105 215 128 87 195 217 0 0 0 0 +... + +I2CRS :: + +This command returns a single byte read from the I2C device +associated with handle [*h*]. + +Upon success a value between 0 and 255 will be returned. On error +a negative status code will be returned. + +... +$ pigs i2crs 0 +0 +... + +I2CRW :: + +This command returns a single 16 bit word read from register [*r*] of +the I2C device associated with handle [*h*]. + +Upon success a value between 0 and 65535 will be returned. On error +a negative status code will be returned. + +... +$ pigs i2crw 0 0 +6150 +... + +I2CWB :: + +This command writes a single byte [*bv*] to register [*r*] of the +I2C device associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cwb 0 10 0x54 +... + +I2CWD :: + +This command writes a block of bytes [*bvs*] to the I2C device +associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The number of bytes which may be written in one transaction is +dependent on the I2C drivers and the device itself. pigs imposes +a limit of about 500 bytes. + +This command operates on the raw I2C device. + +... +$ pigs i2cwd 0 0x01 0x02 0x03 0x04 +... + +I2CWI :: + +This command writes between 1 and 32 bytes [*bvs*] to register [*r*] of +the I2C device associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cwi 0 4 0x01 0x04 0xc0 +... + +I2CWK :: + +This command writes between 1 and 32 bytes [*bvs*] to register [*r*] of +the I2C device associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +pigs i2cwk 0 4 0x01 0x04 0xc0 +... + +I2CWQ :: + +This command writes a single [*bit*] to the I2C device associated +with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cwq 0 1 +... + +I2CWS :: + +This command writes a single byte [*bv*] to the I2C device associated +with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cws 0 0x12 + +$ pigs i2cws 0 0xff +-82 +ERROR: I2C write failed +... + +I2CWW :: + +This command writes a single 16 bit word [*wv*] to register [*r*] of +the I2C device associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs i2cww 0 0 0xffff +... + +I2CZ :: +This command executes a sequence of I2C operations. The +operations to be performed are specified by the contents of [*bvs*] +which contains the concatenated command codes and associated data. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +On @ 2 @ Switch combined flag on +Off @ 3 @ Switch combined flag off +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address defaults to that associated with the handle [*h*]. +The flags default to 0. The address and flags maintain their +previous value until updated. + +... +Set address 0x53, write 0x32, read 6 bytes +Set address 0x1E, write 0x03, read 6 bytes +Set address 0x68, write 0x1B, read 8 bytes +End + +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +0x00 +... + + +M/MODES :: + +This command sets GPIO [*g*] to mode [*m*], typically input (read) +or output (write). + +Upon success nothing is returned. On error a negative status code +will be returned. + +Each GPIO can be configured to be in one of 8 different modes. The modes +are named Input, Output, ALT0, ALT1, ALT2, ALT3, ALT4, and ALT5. + +To set the mode use the code for the mode. + +Mode @Input@Output@ALT0@ALT1@ALT2@ALT3@ALT4@ALT5 +Code @ R@ W@ 0@ 1@ 2@ 3@ 4@ 5 + +... +$ pigs m 4 r # Input (read) +$ pigs m 4 w # Output (write) +$ pigs m 4 0 # ALT 0 +$ pigs m 4 5 # ALT 5 +... + +MG/MODEG :: + +This command returns the current mode of GPIO [*g*]. + +Upon success the value of the GPIO mode is returned. +On error a negative status code will be returned. + +Value @ 0@ 1@ 2@ 3@ 4@ 5@ 6@ 7 +Mode @Input@Output@ALT5@ALT4@ALT0@ALT1@ALT2@ALT3 + +... +$ pigs mg 4 +1 +... + +MICS :: +This command delays execution for [*v*] microseconds. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The main use of this command is expected to be within [*Scripts*]. + +... +$ pigs mics 20 # Delay 20 microseconds. +$ pigs mics 1000000 # Delay 1 second. + +$ pigs mics 2000000 +-64 +ERROR: bad MICS delay (too large) +... + +MILS :: + +This command delays execution for [*v*] milliseconds. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs mils 2000 # Delay 2 seconds. + +$ pigs mils 61000 +-65 +ERROR: bad MILS delay (too large) +... + +NB :: + +This command starts notifications on handle [*h*] returned by +a prior call to [*NO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The notification gets state changes for each GPIO specified by [*bits*]. + +... +$ pigs nb 0 -1 # Shorthand for GPIO 0-31. +$ pigs nb 0 0xf0 # Get notifications for GPIO 4-7. + +$ pigs nb 1 0xf +-25 +ERROR: unknown handle +... + +NC :: + +This command stops notifications on handle [*h*] returned by +a prior call to [*NO*] and releases the handle for reuse. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs nc 0 # First call succeeds. + +$ pigs nc 1 # Second call fails. +-25 +ERROR: unknown handle +... + +NO :: + +This command requests a free notification handle. + +A notification is a method for being notified of GPIO state changes via a pipe. + +Upon success the command returns a handle greater than or equal to zero. +On error a negative status code will be returned. + +Notifications for handle x will be available at the pipe named /dev/pigpiox +(where x is the handle number). + +E.g. if the command returns 15 then the notifications must be read +from /dev/pigpio15. + +... +$ pigs no +0 +... + +NP :: + +This command pauses notifications on handle [*h*] returned by +a prior call to [*NO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +Notifications for the handle are suspended until a new [*NB*] command +is given for the handle. + +... +$ pigs np 0 +... + +P/PWM :: + +This command starts PWM on GPIO [*u*] with dutycycle [*v*]. The dutycycle +varies from 0 (off) to range (fully on). The range defaults to 255. + +Upon success nothing is returned. On error a negative status code +will be returned. + +This and the servo functionality use the DMA and PWM or PCM peripherals +to control and schedule the pulsewidths and dutycycles. + +The [*PRS*] command may be used to change the default range of 255. + +... +$ pigs p 4 64 # Start PWM on GPIO 4 with 25% dutycycle +$ pigs p 4 128 # 50% +$ pigs p 4 192 # 75% +$ pigs p 4 255 # 100% +... + +PADG :: + +This command gets the [*pad*] drive strength [*padma*] in mA. + +Returns the pad drive strength if OK. On error a negative status code +will be returned. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +$ pigs padg 0 +8 +$ pigs pads 0 16 +$ pigs padg 0 +16 +pigs padg 3 +-126 +ERROR: bad pad number +... + +PADS:: + +This command sets the [*pad*] drive strength [*padma*] in mA. + +Upon success nothing is returned. On error a negative status code +will be returned. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +$ pigs pads 0 16 +$ pigs padg 0 +16 +$ pigs pads 0 17 +-127 +ERROR: bad pad drive strength +... + +PARSE :: + +Validates the text [*t*] of a script without storing the script. + +Upon success nothing is returned. On error a list of detected +script errors will be given. + +See [*Scripts*]. + +This command may be used to find script syntax faults. + +... +$ pigs parse tag 100 w 22 1 mils 200 w 22 0 mils 800 jmp 100 + +$ pigs parse tag 0 w 22 1 mills 50 w 22 0 dcr p10 jp 99 +Unknown command: mills +Unknown command: 50 +Bad parameter to dcr +Can't resolve tag 99 +... + +PFG :: + +This command returns the PWM frequency in Hz used for GPIO [*u*]. + +Upon success the PWM frequency is returned. On error a negative +status code will be returned. + +For normal PWM the frequency will be that defined for the GPIO +by [*PFS*]. + +If a hardware clock is active on the GPIO the reported frequency +will be that set by [*HC*]. + +If hardware PWM is active on the GPIO the reported frequency +will be that set by [*HP*]. + +... +$ pigs pfg 4 +800 + +$ pigs pfg 34 +ERROR: GPIO not 0-31 +-2 +... + +PFS :: +This command sets the PWM frequency [*v*] to be used for GPIO [*u*]. + +The numerically closest frequency to [*v*] will be selected. + +Upon success the new frequency is returned. On error a negative status code +will be returned. + +If PWM is currently active on the GPIO it will be +switched off and then back on at the new frequency. + +Each GPIO can be independently set to one of 18 different PWM +frequencies. + +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +The frequencies for each sample rate are: + +. . + Hertz + + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 + 1250 1000 800 500 400 250 200 100 50 + + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 + 625 500 400 250 200 125 100 50 25 + + 4: 10000 5000 2500 2000 1250 1000 625 500 400 + 313 250 200 125 100 63 50 25 13 +sample + rate + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 + 250 200 160 100 80 50 40 20 10 + + 8: 5000 2500 1250 1000 625 500 313 250 200 + 156 125 100 63 50 31 25 13 6 + + 10: 4000 2000 1000 800 500 400 250 200 160 + 125 100 80 50 40 25 20 10 5 +. . + +... +pigs pfs 4 0 # 0 selects the lowest frequency. +10 + +$ pigs pfs 4 1000 # Set 1000Hz PWM. +1000 + +$ pigs pfs 4 100000 # Very big number selects the highest frequency. +8000 +... + +PIGPV :: + +This command returns the pigpio library version. + +... +$ pigs pigpv +17 +... + +PRG :: + +This command returns the dutycycle range for GPIO [*u*]. + +Upon success the range is returned. On error a negative status code +will be returned. + +If a hardware clock or hardware PWM is active on the GPIO the reported +range will be 1000000 (1M). + +... +$ pigs prg 4 +255 +... + +PROC :: + +This command stores a script [*t*] for later execution. + +If the script is valid a script id (>=0) is returned which is passed +to the other script commands. On error a negative status code +will be returned. + +See [*Scripts*]. + +... +$ pigs proc tag 123 w 4 0 mils 200 w 4 1 mils 300 dcr p0 jp 123 +0 + +$ pigs proc tag 123 w 4 0 mils 5 w 4 1 mils 5 jmp 12 +ERROR: script has unresolved tag +-63 +... + +PROCD :: + +This command deletes script [*sid*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +See [*Scripts*]. + +... +$ pigs procd 1 + +$ pigs procd 1 +ERROR: unknown script id +-48 +... + +PROCP :: + +This command returns the status of script [*sid*] as well as the +current value of its 10 parameters. + +Upon success the script status and parameters are returned. +On error a negative status code will be returned. + +The script status may be one of + +0 @ being initialised +1 @ halted +2 @ running +3 @ waiting +4 @ failed + +See [*Scripts*]. + +... +$ pigs procp 0 +1 0 0 0 0 0 0 0 0 0 0 +... + +PROCR :: + +This command runs stored script [*sid*] passing it up to 10 optional +parameters. + +Upon success nothing is returned. On error a negative status code +will be returned. + +See [*Scripts*]. + +... +$ pigs proc tag 123 w 4 0 mils 200 w 4 1 mils 300 dcr p0 jp 123 +0 + +$ pigs procr 0 50 # Run script 0 with parameter 0 of 50. + +$ pigs procp 0 +2 44 0 0 0 0 0 0 0 0 0 +$ pigs procp 0 +2 37 0 0 0 0 0 0 0 0 0 +$ pigs procp 0 +2 10 0 0 0 0 0 0 0 0 0 +$ pigs procp 0 +2 5 0 0 0 0 0 0 0 0 0 +$ pigs procp 0 +2 2 0 0 0 0 0 0 0 0 0 +$ pigs procp 0 +1 -1 0 0 0 0 0 0 0 0 0 +... + +PROCS :: + +This command stops a running script [*sid*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +See [*Scripts*]. + +... +$ pigs procs 0 + +$ pigs procs 1 +-48 +ERROR: unknown script id +... + +PROCU :: + +This command sets the parameters of a stored script [*sid*] passing +it up to 10 parameters. + +Upon success nothing is returned. On error a negative status code +will be returned. + +See [*Scripts*]. + +... +$ pigs proc tag 0 hp 18 p0 p1 mils 1000 jmp 0 +0 +$ pigs procu 0 50 500000 +$ pigs procr 0 +$ pigs procu 0 100 +$ pigs procu 0 200 +$ pigs procu 0 200 100000 +... + +PRRG :: + +This command returns the real underlying range used by GPIO [*u*]. + +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +On error a negative status code will be returned. + +See [*PRS*]. + +... +$ pigs prrg 17 +250 + +$ pigs pfs 17 0 +10 +$ pigs prrg 17 +20000 + +$ pigs pfs 17 100000 +8000 +$ pigs prrg 17 +25 +... + +PRS :: + +This command sets the dutycycle range [*v*] to be used for GPIO [*u*]. +Subsequent uses of command [*P/PWM*] will use a dutycycle between 0 (off) +and [*v*] (fully on). + +Upon success the real underlying range used by the GPIO is returned. +On error a negative status code will be returned. + +If PWM is currently active on the GPIO its dutycycle will be scaled to +reflect the new range. + +The real range, the number of steps between fully off and fully on +for each frequency, is given in the following table. + + #1@ #2@ #3@ #4@ #5@ #6@ #7@ #8@ #9 + 25@ 50@ 100@ 125@ 200@ 250@ 400@ 500@ 625 + @ @ @ @ @ @ @ @ +#10@ #11@ #12@ #13@ #14@ #15@ #16@ #17@ #18 +800@1000@1250@2000@2500@4000@5000@10000@20000 + +The real value set by [*PRS*] is (dutycycle * real range) / range. + +See [*PRRG*] + +... +$ pigs prs 18 1000 +250 +... + +PUD :: + +This command sets the internal pull/up down for GPIO [*g*] to mode [*p*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The mode may be pull-down (D), pull-up (U), or off (O). + +... +$ pigs pud 4 d # Set pull-down on GPIO 4. +$ pigs pud 4 u # Set pull-up on GPIO 4. +$ pigs pud 4 o # No pull-up/down on GPIO 4. +... + +R/READ :: + +This reads the current level of GPIO [*g*]. + +Upon success the current level is returned. On error a negative status code +will be returned. + +... +$ pigs r 17 # Get level of GPIO 17. +0 + +$ pigs r 4 # Get level of GPIO 4. +1 +... + +S/SERVO :: + +This command starts servo pulses of [*v*] microseconds on GPIO [*u*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The servo pulsewidth may be 0 (off), 500 (most anti-clockwise) +to 2500 (most clockwise). + +The range supported by servos varies and should probably be determined +by experiment. Generally values between 1000-2000 should be safe. +A value of 1500 should always be safe and represents +the mid-point of rotation. + +You can DAMAGE a servo if you command it to move beyond its limits. + +... +$ pigs SERVO 17 1500 +... + +This example causes an on pulse of 1500 microseconds duration to be +transmitted on GPIO 17 at a rate of 50 times per second. + +This will command a servo connected to GPIO 17 to rotate to its mid-point. + +... +pigs s 17 0 # Switch servo pulses off. +... + +SERC :: + +This command closes a serial handle [*h*] previously opened with [*SERO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs serc 0 # First close okay. + +$ pigs serc 0 # Second close gives error. +-25 +ERROR: unknown handle +... + +SERDA :: + +This command returns the number of bytes of data available +to be read from the serial device associated with handle [*h*]. + +Upon success the count of bytes available to be read is +returned (which may be 0). On error a negative status code +will be returned. + +... +$ pigs serda 0 +0 +... + +SERO:: + +This command opens the serial [*dev*] at [*b*] bits per second. + +No flags are currently defined. [*sef*] should be set to zero. + +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +The device name must start with /dev/tty or /dev/serial. + + +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +... +$ pigs sero /dev/ttyAMA0 9600 0 +0 + +$ pigs sero /dev/tty1 38400 0 +1 +... + +SERR:: + +This command returns up to [*num*] bytes of data read from the +serial device associated with handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs serr 0 10 +5 48 49 128 144 255 + +$ pigs serr 0 10 +0 +... + +SERRB:: + +This command returns a byte of data read from the serial +device associated with handle [*h*]. + +Upon success a number between 0 and 255 is returned. +On error a negative status code will be returned. + +... +$ pigs serrb 0 +23 +$ pigs serrb 0 +45 +... + +SERW:: + +This command writes bytes [*bvs*] to the serial device +associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs serw 0 23 45 67 89 +... + +SERWB:: + +This command writes a single byte [*bv*] to the serial device +associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs serwb 0 23 +$ pigs serwb 0 0xf0 +... + +SHELL :: + +This command uses the system call to execute a shell script [*name*] +with the given string [*str*] as its parameter. + +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +[*name*] must exist in /opt/pigpio/cgi and must be executable. + +The returned exit status is normally 256 times that set +by the shell script exit function. If the script can't +be found 32512 will be returned. + +The following table gives some example returned statuses. + +Script exit status @ Returned system call status +1 @ 256 +5 @ 1280 +10 @ 2560 +200 @ 51200 +script not found @ 32512 + +... +# pass two parameters, hello and world +$ pigs shell scr1 hello world +256 + +# pass three parameters, hello, string with spaces, and world +$ pigs shell scr1 "hello 'string with spaces' world" +256 + +# pass one parameter, hello string with spaces world +$ pigs shell scr1 "\"hello string with spaces world\"" +256 + +# non-existent script +$ pigs shell scr78 par1 +32512 +... + +SLR :: + +This command returns up to [*num*] bytes of bit bang serial data +read from GPIO [*u*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +The GPIO [*u*] should have been initialised with the [*SLRO*] command. + +The bytes returned for each character depend upon the number of +data bits [*db*] specified in the [*SLRO*] command. + +For [*db*] 1-8 there will be one byte per character. +For [*db*] 9-16 there will be two bytes per character. +For [*db*] 17-32 there will be four bytes per character. + +... +$ pigs slr 15 20 +6 1 0 23 45 89 0 +... + +SLRC :: + +This command closes GPIO [*u*] for reading bit bang serial data. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs slrc 23 + +$ pigs slrc 23 +-38 +ERROR: no serial read in progress on GPIO +... + +SLRI :: + +This command sets the logic level for reading bit bang serial data +on GPIO [*u*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The invert parameter [*v*] is 1 for inverted signal, 0 for normal. + +... +$ pigs slri 17 1 # invert logic on GPIO 17 + +$ pigs slri 23 0 # use normal logic on GPIO 23 +... + +SLRO :: + +This command opens GPIO [*u*] for reading bit bang serial data +at [*b*] baud and [*db*] data bits. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The baud rate may be between 50 and 250000 bits per second. + +The received data is held in a cyclic buffer. + +It is the user's responsibility to read the data (with [*SLR*]) +in a timely fashion. + +... +$ pigs slro 23 19200 8 + +$ pigs slro 23 19200 8 +-50 +ERROR: GPIO already in use +... + +SPIC :: + +This command closes the SPI handle [*h*] returned by a prior +call to [*SPIO*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs spic 1 + +$ pigs spic 1 +-25 +ERROR: unknown handle +... + +SPIO :: + +This command returns a handle to a SPI device on channel [*c*]. + +Data will be transferred at [*b*] bits per second. The flags [*spf*] +may be used to modify the default behaviour of 4-wire operation, +mode 0, active low chip select. + +Speeds between 32kbps and 125Mbps are allowed. Speeds above 30Mbps +are unlikely to work. + +The Pi has two SPI peripherals: main and auxiliary. + +The main SPI has two chip selects (channels), the auxiliary has +three. + +The auxiliary SPI is available on all models but the A and B. + +The GPIO used are given in the following table. + + @ MISO @ MOSI @ SCLK @ CE0 @ CE1 @ CE2 +Main SPI @ 9 @ 10 @ 11 @ 8 @ 7 @ - +Aux SPI @ 19 @ 20 @ 21 @ 18 @ 17 @ 16 + +The flags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +. . + +mm defines the SPI mode. + +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +. . +Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +px is 0 if CEx is active low (default) and 1 for active high. + +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +A is 0 for the main SPI, 1 for the auxiliary SPI. + +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +The [*SPIR*], [*SPIW*], and [*SPIX*] commands transfer data +packed into 1, 2, or 4 bytes according to the word size in bits. + +For bits 1-8 there will be one byte per character. +For bits 9-16 there will be two bytes per character. +For bits 17-32 there will be four bytes per character. + +Multi-byte transfers are made in least significant byte first order. + +E.g. to transfer 32 11-bit words 64 bytes need to be sent. + +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +The other bits in flags should be set to zero. + +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +... +$ pigs spio 0 100000 3 # Open channel 0 at 100kbps in mode 3. +0 + +$ pigs spio 0 32000 256 # Open channel 0 of auxiliary spi at 32kbps. +1 +... + +SPIR :: + +This command returns [*num*] bytes read from the SPI device +associated with handle [*h*]. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs spir 0 10 # Read 10 bytes from the SPI device. +10 0 0 0 0 0 0 0 0 0 0 +... + +SPIW :: + +This command writes bytes [*bvs*] to the SPI device +associated with handle [*h*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs spiw 0 0x22 0x33 0xcc 0xff +... + +SPIX:: + +This command writes bytes [*bvs*] to the SPI device +associated with handle [*h*]. It returns the same +number of bytes read from the device. + +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +... +$ pigs spix 0 0x22 0x33 0xcc 0xff +4 0 0 0 0 +... + +T/TICK :: + +This command returns the current system tick. + +Tick is the number of microseconds since system boot. + +As tick is an unsigned 32 bit quantity it wraps around after 2^32 microseconds, +which is approximately 1 hour 12 minutes. + +... +$ pigs t mils 1000 t +3691823946 +3692833987 +... + +TRIG :: + +This command sends a trigger pulse of [*pl*] microseconds at level [*L*] +to GPIO [*u*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The GPIO is set to not level at the end of the pulse. + +... +$ pigs trig 4 10 1 + +$ pigs trig 4 51 1 +-46 +ERROR: trigger pulse > 50 microseconds +... + +W/WRITE :: + +This command sets GPIO [*g*] to level [*L*]. The level may be 0 +(low, off, clear) or 1 (high, on, set). + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs w 23 0 +$ pigs w 23 1 + +$ pigs w 23 2 +-5 +ERROR: level not 0-1 +... + +WDOG :: + +This command sets a watchdog of [*v*] milliseconds on GPIO [*u*]. + +Upon success nothing is returned. On error a negative status code +will be returned. + +The watchdog is nominally in milliseconds. + +One watchdog may be registered per GPIO. + +The watchdog may be cancelled by setting timeout to 0. + +Once a watchdog has been started monitors of the GPIO +will be triggered every timeout interval after the last +GPIO activity. The watchdog expiry will be indicated by +a special TIMEOUT value. + +... +$ pigs wdog 23 90000 +-15 +ERROR: timeout not 0-60000 + +$ pigs wdog 23 9000 +... + +This example causes a report to be written to any notification pipes +listening on GPIO 23 whenever GPIO 23 changes state or approximately +every 9000 ms. + +WVAG :: + +This command adds 1 one or more triplets [*trips*] of GPIO on, GPIO off, +delay to the existing waveform (if any). + +Upon success the total number of pulses in the waveform so far is +returned. On error a negative status code will be returned. + +The triplets will be added at the start of the existing waveform. If +they are to start offset from the start then the first triplet should +consist solely of a delay i.e. 0 0 offset. + +... +$ pigs wvag 0x10 0x80 1000 0x80 0x10 9000 +2 + +$ pigs wvag 0 0 10000 0x10 0x80 1000 0x80 0x10 9000 +4 +... + +WVAS :: + +This command adds a waveform representing serial data [*bvs*] to +GPIO [*u*] at [*b*] baud to the existing waveform (if any). +The serial data starts [*o*] microseconds from the start of the +waveform. + +Upon success the total number of pulses in the waveform so far is +returned. On error a negative status code will be returned. + +The serial data is formatted as one start bit, [*db*] data bits, and +[*sb*]/2 stop bits. + +The baud rate may be between 50 and 1000000 bits per second. + +It is legal to add serial data streams with different baud rates to +the same waveform. + +The bytes required for each character depend upon [*db*]. + +For [*db*] 1-8 there will be one byte per character. +For [*db*] 9-16 there will be two bytes per character. +For [*db*] 17-32 there will be four bytes per character. + +... +$ pigs wvas 4 9600 8 2 0 0x30 0x31 0x32 0x33 +23 + +$ pigs wvas 7 38400 8 2 0 0x41 0x42 +35 +... + +WVTAT :: + +This command returns the id of the waveform currently +being transmitted. Chained waves are not supported. + +Returns the waveform id or one of the following special +values: + +9998 - transmitted wave not found +9999 - no wave being transmitted + +... +$ pigs wvtat +9999 +... + +WVBSY :: + +This command checks to see if a waveform is currently being transmitted. + +Returns 1 if a waveform is currently being transmitted, otherwise 0. + +... +$ pigs wvbsy +0 +... + +WVCHA :: + +This command transmits a chain of waveforms. + +NOTE: Any hardware PWM started by [*HP*] will +be cancelled. + +The waves to be transmitted are specified by the contents of +[*bvs*] which contains an ordered list of wave_ids and optional +command codes and related data. + +Upon success 0 is returned. On error a negative status code +will be returned. + +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +Delays between waves may be added with the delay command. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +Loop Start @ 255 0 @ Identify start of a wave block +Loop Repeat @ 255 1 x y @ loop x + y*256 times +Delay @ 255 2 x y @ delay x + y*256 microseconds +Loop Forever @ 255 3 @ loop forever + +If present Loop Forever must be the last entry in the chain. + +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +... +#!/bin/bash + +GPIO=4 +WAVES=5 + +pigs m $GPIO w + +for ((i=0; i<$WAVES; i++)) +do + pigs wvag $((1<=0) is returned. On error a negative status +code will be returned. + +The data provided by the [*WVAG*] and [*WVAS*] commands is +consumed by this command. + +As many waveforms may be created as there is space available. +The wave id is passed to [*WVTX*] or [*WVTXR*] to specify the +waveform to transmit. + +Normal usage would be + +Step 1. [*WVCLR*] to clear all waveforms and added data. + +Step 2. [*WVAG*]/[*WVAS*] calls to supply the waveform data. + +Step 3. [*WVCRE*] to create the waveform and get a unique id. + +Repeat steps 2 and 3 as needed. + +Step 4. [*WVTX*] or [*WVTXR*] with the id of the waveform to transmit. + +A waveform comprises of one or more pulses. + +A pulse specifies + +1) the GPIO to be switched on at the start of the pulse. +2) the GPIO to be switched off at the start of the pulse. +3) the delay in microseconds before the next pulse. + +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +When a waveform is started each pulse is executed in order with +the specified delay between the pulse and the next. + +... +$ pigs wvas 4 9600 0 23 45 67 89 90 +37 +$ pigs wvcre +0 + +$ pigs wvcre +-69 +ERROR: attempt to create an empty waveform +... + +WVCAP :: + +Create a waveform of fixed size. Similar to [*WVCRE*], this command creates a waveform but pads the consumed resources to a fixed size, specified as a [*percent*] of the total resources. Padded waves of equal size can be re-cycled efficiently allowing newly created waves to re-use the resources of deleted waves of the same dimension. + +Upon success a wave id (>=0) is returned. On error a negative status code will be returned. + +The data provided by the [*WVAG*] and [*WVAS*] commands are consumed by this command. + +As many waveforms may be created as there is space available. The wave id is passed to [*WVTX*] or [*WVTXR*] to specify the waveform to transmit. + +Normal usage would be + +Step 1. [*WVCLR*] to clear all waveforms and added data. + +Step 2. [*WVAG*]/[*WVAS*] calls to supply the waveform data. + +Step 3. [*WVCAP*] to create a waveform of a uniform size. + +Step 4. [*WVTX*] or [*WVTXR*] with the id of the waveform to transmit. + +Repeat steps 2 - 4 as needed. + +Step 5. Any wave id can now be deleted and another wave of the same size can be created in its place. + +Example + +... +# Create a wave that consumes 50% of the total resource: + +$ pigs wvag 16 0 5000000 0 16 5000000 +2 +$ pigs wvcap 50 +0 +$ pigs wvtx 0 +11918 +... + +WVDEL :: + +This command deletes the waveform with id [*wid*]. + +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +Upon success nothing is returned. On error a negative status code +will be returned. + +... +$ pigs wvdel 0 + +$ pigs wvdel 0 +-66 +ERROR: non existent wave id +... + +WVHLT :: + +This command aborts the transmission of the current waveform. + +Nothing is returned. + +This command is intended to stop a waveform started in the repeat mode. + +... +$ pigs wvhlt +... + +WVNEW :: + +This clears any existing waveform data ready for the creation of a new +waveform. + +Nothing is returned. + +... +$ pigs wvnew +... + +WVSC :: + +The statistic requested by [*ws*] is returned. + +[*ws*] identifies the subcommand as follows. + +0 Get Cbs +1 Get High Cbs +2 Get Max Cbs + +... +$ pigs wvas 4 9600 0 23 45 67 89 90 +37 + +$ pigs wvsc 0 +74 +$ pigs wvsc 1 +74 +$ pigs wvsc 2 +25016 +... + +WVSM :: + +The statistic requested by [*ws*] is returned. + +[*ws*] identifies the subcommand as follows. + +0 Get Micros +1 Get High Micros +2 Get Max Micros + +... +$ pigs wvsm 0 +5314 +$ pigs wvsm 1 +5314 +$ pigs wvsm 2 +1800000000 +... + +WVSP :: + +The statistic requested by [*ws*] is returned. + +[*ws*] identifies the subcommand as follows. + +0 Get Pulses +1 Get High Pulses +2 Get Max Pulses + +... +$ pigs wvsp 0 +37 +$ pigs wvsp 1 +37 +$ pigs wvsp 2 +12000 +... + +WVTX :: + +This command transmits the waveform with id [*wid*] once. + +NOTE: Any hardware PWM started by [*HP*] will be cancelled. + +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +... +$ pigs wvtx 1 +75 + +$ pigs wvtx 2 +-66 +ERROR: non existent wave id +... + +WVTXM :: + +This command transmits the waveform with id [*wid*] using mode [*wmde*]. + +The mode may be send once (0), send repeatedly (1), send once but +first sync with previous wave (2), or send repeatedly but first +sync with previous wave (3). + +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +NOTE: Any hardware PWM started by [*HP*] will be cancelled. + +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +... +$ pigs wvtxm 1 3 +75 + +$ pigs wvtxm 2 0 +-66 +ERROR: non existent wave id +... + +WVTXR :: + +This command transmits the waveform with id [*wid*] repeatedly. + +NOTE: Any hardware PWM started by [*HP*] will be cancelled. + +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +... +$ pigs wvtxr 1 +75 + +$ pigs wvtxr 2 +-66 +ERROR: non existent wave id +... + +PARAMETERS + +actv :: 0-1000000 + +The number of microseconds level changes are reported for once +a noise filter has been triggered (by [*stdy*] microseconds of +a stable level). + +b :: baud +The command expects the baud rate in bits per second for +the transmission of serial data (I2C/SPI/serial link, waves). + +bctl :: BSC control word +The command expects a BSC control word, see [*BSCX*]. + +bit :: bit value (0-1) +The command expects 0 or 1. + +bits :: a bit mask +A mask is used to select one or more GPIO. A GPIO is selected +if bit (1<=0) +The command expects a handle. + +A handle is a number referencing an object opened by one of [*FO*], +[*I2CO*], [*NO*], [*SERO*], [*SPIO*]. + +ib :: I2C bus (>=0) +The command expects an I2C bus number. + +id :: I2C device (0-0x7F) +The command expects the address of an I2C device. + +if :: I2C flags (0) +The command expects an I2C flags value. No flags are currently defined. + +L :: level (0-1) +The command expects a GPIO level. + +m :: mode (RW540123) +The command expects a mode character. + +Each GPIO can be configured to be in one of 8 different modes. The modes +are named Input, Output, ALT0, ALT1, ALT2, ALT3, ALT4, and ALT5. + +To set the mode use the code for the mode. + +The value is returned by the mode get command. + +Mode @ Input @ Output @ ALT0 @ ALT1 @ ALT2 @ ALT3 @ ALT4 @ ALT5 +Code @ R @ W @ 0 @ 1 @ 2 @ 3 @ 4 @ 5 +Value @ 0 @ 1 @ 4 @ 5 @ 6 @ 7 @ 3 @ 2 + +miso :: GPIO (0-31) +The GPIO used for the MISO signal when bit banging SPI. + +mode :: file open mode +One of the following values. + + @ Value @ Meaning +READ @ 1 @ open file for reading +WRITE @ 2 @ open file for writing +RW @ 3 @ open file for reading and writing + +The following values can be or'd into the mode. + + @ Value @ Meaning +APPEND @ 4 @ All writes append data to the end of the file +CREATE @ 8 @ The file is created if it doesn't exist +TRUNC @ 16 @ The file is truncated + +mosi :: GPIO (0-31) +The GPIO used for the MOSI signal when bit banging SPI. + +name :: the name of a script +Only alphanumeric characters, '-' and '_' are allowed in the name. + +num :: maximum number of bytes to return (1-) +The command expects the maximum number of bytes to return. + +For the I2C and SPI commands the requested number of bytes will always +be returned. + +For the serial and file commands the smaller of the number of +bytes available to be read (which may be zero) and [*num*] bytes +will be returned. + +o :: offset (>=0) +Serial data is stored offset microseconds from the start of the waveform. + +p :: PUD (ODU) +The command expects a PUD character. + +Each GPIO can be configured to use or not use an internal pull up or +pull down resistor. This is useful to provide a default state for inputs. + +A pull up will default the input to 1 (high). + +A pull down will default the input to 0 (low). + +To set the pull up down state use the command character for the state. + +Pull Up Down @Off@Pull Down@Pull Up +Command Character@ O@ D@ U + +There is no mechanism to read the pull up down state. + +pad :: 0-2 +A set of GPIO which share common drivers. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +padma:: 1-16 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +pars :: script parameters +The command expects 0 to 10 numbers as parameters to be passed to the script. + +pat :: a file name pattern +A file path which may contain wildcards. To be accessible the path +must match an entry in /opt/pigpio/access. + +pdc :: hardware PWM dutycycle (0-1000000) +The command expects a dutycycle. + +percent :: percent (1-100) +The percent of wave resources to allocate to a wave. It can be useful +to create waves of fixed sizes to prevent wave fragmentation (where +there are plenty of resources but not a large enough contiguous space). + +pf :: hardware PWM frequency (1-125M, 1-187.5M for the BCM2711) +The command expects a frequency. + +pl :: pulse length (1-100) +The command expects a pulse length in microseconds. + +r :: register (0-255) +The command expects an I2C register number. + +sb :: serial stop (half) bits (2-8) +The command expects the number of stop (half) bits per serial character. + +scl :: user GPIO (0-31) +The command expects the number of the GPIO to be used for SCL +when bit banging I2C. + +sclk :: user GPIO (0-31) +The GPIO used for the SCLK signal when bit banging SPI. + +sda :: user GPIO (0-31) +The command expects the number of the GPIO to be used for SDA +when bit banging I2C. + +sef :: serial flags (32 bits) +The command expects a flag value. No serial flags are currently defined. + +sid :: script id (>= 0) +The command expects a script id as returned by a call to [*PROC*]. + +spf :: SPI flags (32 bits) +See [*SPIO*] and [*BSPIO*]. + +stdy :: 0-300000 + +The number of microseconds level changes must be stable for +before reporting the level changed ([*FG*]) or triggering +the active part of a noise filter ([*FN*]). + +str :: a string +The command expects a string. + +t :: a string +The command expects a string. + +trips :: triplets +The command expects 1 or more triplets of GPIO on, GPIO off, delay. + +E.g. 0x400000 0 100000 0 0x400000 900000 defines two pulses as follows + + GPIO on @ GPIO off @ delay +0x400000 (GPIO 22)@ 0 (None)@100000 (1/10th s) + 0 (None)@0x400000 (GPIO 22)@900000 (9/10th s) + +u :: user GPIO (0-31) +The command expects the number of a user GPIO. + +A number of commands are restricted to GPIO in bank 1, +in particular the PWM commands, the servo command, +the watchdog command, and the notification command. + +It is your responsibility to ensure that the PWM and servo commands +are only used on safe GPIO. + +See [*g*] + +uvs :: values +The command expects an arbitrary number of >=0 values (possibly none). +Any after the first two must be <= 255. + +v :: value +The command expects a number. + +wid :: wave id (>=0) +The command expects a wave id. + +When a waveform is created it is given an id (0, 1, 2, ...). + +wmde :: mode (0-3) +The command expects a wave transmission mode. + +0 = send once +1 = send repeatedly +2 = send once but first sync with previous wave +3 = send repeatedly but first sync with previous wave + +ws :: wave stats sucommand (0-2) +The command expects a subcommand. + +0 = current value. +1 = highest value so far. +2 = maximum possible value. + +wv :: word value (0-65535) +The command expects a word value. + +SCRIPTS + +Scripts are programs to be stored and executed by the pigpio daemon. +They are intended to mitigate any performance problems associated with +the pigpio daemon server/client model. + +*Example* + +A trivial example might be useful. Suppose you want to toggle a GPIO +on and off as fast as possible. + +From the command line you could write + +... +for ((i=0; i<1000;i++)); do pigs w 22 1 w 22 0; done +... + +Timing that you will see it takes about 14 seconds, or roughly +70 toggles per second. + +Using the pigpio Python module you could use code such as + +... +#!/usr/bin/env python + +import time + +import pigpio + +PIN=4 + +TOGGLE=10000 + +pi = pigpio.pi() # Connect to local Pi. + +s = time.time() + +for i in range(TOGGLE): + pi.write(PIN, 1) + pi.write(PIN, 0) + +e = time.time() + +print("pigpio did {} toggles per second".format(int(TOGGLE/(e-s)))) + +pi.stop() +... + +Timing that shows a speed improvement to roughly 800 toggles per second. + +Now let's use a script. + +... +pigs proc tag 999 w 22 1 w 22 0 dcr p0 jp 999 +... + +Ignore the details for now. + +Let's time the script running. + +Again, ignore the details for now. + +... +time (pigs procr 0 10000000; while a=$(pigs procp 0); [[ ${a::1} -eq 2 ]];\ + do sleep 0.2; done) +... + +The script takes roughly 12 seconds to complete, or 800,000 toggles per second. + +That is the advantage of a stored script. + +Some details. + +... +pigs proc tag 999 w 22 1 w 22 0 dcr p0 jp 999 +... + +proc introduces a script. Everything after proc is part of the script. +tag 999 names the current position in the script. +w 22 1 writes 1 to GPIO 22. +w 22 0 writes 0 to GPIO 22. +dcr p0 decrements parameter 0. +jp 999 jumps to tag 999 if the result is positive. + +... +time (pigs procr 0 10000000; while a=$(pigs procp 0); [[ ${a::1} -eq 2 ]];\ + do sleep 0.2; done) +... + +pigs procr 0 10000000 starts script 0 with parameter 0 of 10 million. + +The rest is bash apart from + +pigs procp 0 asks for the status and parameters of script 0. +The status will be 2 while the script is running and 1 when it is complete. + +*Virtual machine* + +A script runs within a virtual machine with + +a 32 bit accumulator A. +a flags register F. +a program counter PC. + +Each script has + +10 parameters named 0 through 9. +150 variables named 0 through 149. +50 labels which are named by any unique number. + +*Commands* + +Many pigpio commands may be used within a script. However +some commands do not work within the script model as designed and +are not permitted. + +The following commands are not permitted within a script: + +File - FL FO FR FW + +I2C - BI2CZ I2CPK I2CRD I2CRI I2CRK I2CWD I2CWI I2CWK I2CZ + +Misc - BSCX CF1 CF2 SHELL + +Script control - PARSE PROC PROCD PROCP PROCR PROCS PROCU + +Serial - SERO SERR SERW SLR + +SPI - BSPIO BSPIX SPIR SPIW SPIX + +Waves - WVAG WVAS WVCHA WVGO WVGOR + +The following commands are only permitted within a script: + +Command@Description @Definition +ADD x @Add x to accumulator @A+=x; F=A +AND x @And x with accumulator @A&=x; F=A +CALL L @Call subroutine at tag L @push(PC+1); PC=L +CMP x @Compare x with accumulator @F=A-x +DCR y @Decrement register @--*y; F=*y +DCRA @Decrement accumulator @--A; F=A +DIV x @Divide x into accumulator @A/=x; F=A +EVTWT @Wait for an event to occur @A=wait(x); F=A +HALT @Halt @Halt +INR y @Increment register @++*y; F=*y +INRA @Increment accumulator @++A; F=A +JM L @Jump if minus to tag L @if (F<0) PC=L +JMP L @Jump to tag L @PC=L +JNZ L @Jump if non-zero to tag L @if (F) PC=L +JP L @Jump if positive to tag L @if (F>=0) PC=L +JZ L @Jump if zero to tag L @if (!F) PC=L +LD y x @Load register with x @*y=x +LDA x @Load accumulator with x @A=x +MLT x @Multiply x with accumulator @A*=x; F=A +MOD x @Modulus x with accumulator @A%=x; F=A +OR x @Or x with accumulator @A|=x; F=A +POP y @Pop register @y=pop() +POPA @Pop accumulator @A=pop() +PUSH y @Push register @push(y) +PUSHA @Push accumulator @push(A) +RET @Return from subroutine @PC=pop() +RL y x @Rotate left register x bits @*y<<=x; F=*y +RLA x @Rotate left accumulator x bits @A<<=x; F=A +RR y x @Rotate right register x bits @*y>>=x; F=*y +RRA x @Rotate right accumulator x bits @A>>=x; F=A +STA y @Store accumulator in register @y=A +SUB x @Subtract x from accumulator @A-=x; F=A +SYS str@Run external script (/opt/pigpio/cgi/str) @system(str); F=A +TAG L @Label the current script position @N/A +WAIT x @Wait for a GPIO in x to change state @A=wait(x); F=A +X y1 y2@Exchange contents of registers y1 and y2 @t=*y1;*y1=*y2;*y2=t +XA y @Exchange contents of accumulator and register@t=A;A=*y;*y=t +XOR x @Xor x with accumulator @A^=x; F=A + +x may be a constant, a parameter (p0-p9), or a variable (v0-v149). + +y may be a parameter (p0-p9), or a variable (v0-v149). If p or v isn't +specified y is assumed to be a variable. + +The EVTWT command parameter is a bit-mask with 1 set for events of interest. + +The WAIT command parameter is a bit-mask with 1 set for GPIO of interest. + +The SYS script receives two unsigned parameters: the accumulator A and +the current GPIO levels. + diff --git a/pigpio-master/DOC/src/html/download.html b/pigpio-master/DOC/src/html/download.html new file mode 100644 index 0000000..740a3c8 --- /dev/null +++ b/pigpio-master/DOC/src/html/download.html @@ -0,0 +1,68 @@ + + + + + +download + + +If the pigpio daemon is running it should be killed (sudo killall +pigpiod) before make install and restarted afterwards (sudo +pigpiod).
+
+The initial part of the make, the +compilation of pigpio.c, takes 100 seconds on early model +Pis.  Be patient.  The overall install takes just over 3 +minutes.
+

Download and install latest version

+ +wget https://github.com/joan2937/pigpio/archive/master.zip
+unzip master.zip
+cd pigpio-master
+make
+sudo make install
+ +
+If the Python part of the install fails it may be because you need +the setup tools.
+
+sudo apt install python-setuptools +python3-setuptools

+
+

To check the library

+These tests make extensive use of GPIO 25 (pin 22).  Make sure +nothing, or only a LED, is connected to the GPIO before running the +tests.  Most tests are statistical in nature and so may on +occasion fail.  Repeated failures on the same test or many +failures in a group of tests indicate a problem.
+
+sudo ./x_pigpio # check C I/F
+
+sudo pigpiod    # start daemon
+
+./x_pigpiod_if2 # check C      I/F to +daemon
+./x_pigpio.py   # check Python I/F to daemon
+./x_pigs        # check +pigs   I/F to daemon
+./x_pipe        # check +pipe   I/F to daemon
+
+
 +

To compile, link, and run a C program

+gcc -Wall -pthread -o foobar foobar.c -lpigpio -lrt
+sudo ./foobar

+

To start the pigpio daemon

+sudo pigpiod
 +

To stop the pigpio daemon

+sudo killall pigpiod

+

github

+git clone https://github.com/joan2937/pigpio
+

Raspbian (raspberrypi.org image)

+

This may not be the most recent version.  You can check the +version with the command pigpiod -v.

+sudo apt-get update
+sudo apt-get install pigpio python-pigpio python3-pigpio
+
+ + diff --git a/pigpio-master/DOC/src/html/ex_LDR.html b/pigpio-master/DOC/src/html/ex_LDR.html new file mode 100644 index 0000000..3c54c68 --- /dev/null +++ b/pigpio-master/DOC/src/html/ex_LDR.html @@ -0,0 +1,150 @@ + + + + + +LDR example + + +

The following code shows a method of reading analogue sensors on +the digital input only Pi.  A Light Dependent Resistor (LDR) +varies its resistance according to the incident light +intensisty.

+

SETUP

+fritzing diagramThe LDR +used is a Cadmium Sulphide device with a 1MOhm dark resistance and +2-4KOhm at 100 lux.  The capacitor is a 104 +ceramic.
+
+One end of the capacitor is connected to Pi ground.
+
+One end of the LDR is connected to Pi 3V3.
+
+The other ends of the capacitor and LDR are connected to a spare +gpio.
+

Here P1-1 is used for 3V3, P1-20 is used for ground, and gpio 18 +(P1-12) is used for the gpio.

+

photo of set-up

+

CODE

+#include <stdio.h>
+
+#include <pigpio.h>
+
+/* +-----------------------------------------------------------------------
+ +
+   3V3 ----- Light Dependent Resistor --+-- Capacitor +----- Ground
+                                        +|
+                                        ++-- gpio
+
+
+  cc -o LDR LDR.c -lpigpio -lpthread -lrt
+  sudo ./LDR
+
+*/
+
+#define LDR 18
+
+/* forward declaration */
+
+void alert(int pin, int level, uint32_t tick);
+
+int main (int argc, char *argv[])
+{
+   if (gpioInitialise()<0) return 1;
+
+   gpioSetAlertFunc(LDR, alert); /* call alert when LDR +changes state */
+    
+   while (1)
+   {
+      gpioSetMode(LDR, PI_OUTPUT); /* +drain capacitor */
+
+      gpioWrite(LDR, PI_OFF);
+
+      gpioDelay(200); /* 50 micros is +enough, 200 is overkill */
+
+      gpioSetMode(LDR, PI_INPUT); /* start +capacitor recharge */
+
+      gpioDelay(10000); /* nominal 100 +readings per second */
+   }
+
+   gpioTerminate();
+}
+
+void alert(int pin, int level, uint32_t tick)
+{
+   static uint32_t inited = 0;
+   static uint32_t lastTick, firstTick;
+
+   uint32_t diffTick;
+
+   if (inited)
+   {
+      diffTick = tick - lastTick;
+      lastTick = tick;
+
+      if (level == 1) printf("%u %d\ ", +tick-firstTick, diffTick);
+   }
+   else
+   {
+      inited = 1;
+      firstTick = tick;
+      lastTick = firstTick;
+   }
+}
 +

BUILD

+cc -o LDR LDR.c -lpigpio -lrt -lpthread
 +

RUN

+sudo ./LDR >LDR.dat &
+
+While the program is running you can capture the waveform using the +notification feature built in to pigpio.  Issue the following +commands on the Pi.
+
+pigs no
+pig2vcd  </dev/pigpio0 >LDR.vcd &
+pigs nb 0 0x40000 # set bit for gpio 18
 +

Change the light falling on the LDR for a few seconds (e.g. +shine a torch on it or shade it with your hands).

+pigs nc 0
+

The file LDR.vcd will contain the captured waveform, which can +be viewed using GTKWave.

+

Overview

+LDR waveform 1
+

Reading circa every 10ms

+LDR waveform 2
+

One reading, circa 400us

+LDR waveform 3
+

The file LDR.dat will contain pairs of timestamps and recharge +time (in us).  The following  script will convert the +timestamps into seconds.

+

awk '{print $1/1000000, $2}' LDR.dat +>LDR-secs.dat

+

Gnuplot is a useful tool to graph data.

+plot [14:24] 'LDR-secs.dat' with lines title 'LDR' +

Gnuplot readings 14-24 seconds

+

gnuplot 1

+plot [18:21] 'LDR-secs.dat' with lines title 'LDR'
+
+Gnuplot readings 18-21 seconds +

Gnuplot 2

+ + diff --git a/pigpio-master/DOC/src/html/ex_ir_remote.html b/pigpio-master/DOC/src/html/ex_ir_remote.html new file mode 100644 index 0000000..2400a11 --- /dev/null +++ b/pigpio-master/DOC/src/html/ex_ir_remote.html @@ -0,0 +1,253 @@ + + + + + +IR remote example + + +

The following code shows one way to read an infrared remote +control device (the sort used in TVs and stereo systems).

+

SETUP

+fritzing diagramThe device used +is a SFH5110 (IR Receiver for remote control, +carrier 38 kHz).
+
 Pin 1 (left from front) may be connected to any spare +gpio.  Here it's connected via a 4K7 current limiting +resistor.  This isn't really needed as the device has an +internal 23K resistor in-line.  It does no harm though.
+
+Pin 2 should be connected to a Pi ground pin.
+
+Pin 3 should be connected to a Pi 5V pin.
+

Here pin 1 to gpio7 (P1-26) via a 4K7 resistor, pin 2 to ground +(P1-14), and pin 3 to 5V (P1-2).

+

photo of set-up

+

CODE

+#include <stdio.h>
+
+#include <pigpio.h>
+
+#define IR_PIN 7
+
+#define OUTSIDE_CODE 0
+#define INSIDE_CODE  1
+
+#define MIN_MESSAGE_GAP 3000
+#define MAX_MESSAGE_END 3000
+
+#define MAX_TRANSITIONS 500
+
+/*
+   using the FNV-1a +hash                
+ +   from +http://isthe.com/chongo/tech/comp/fnv/#FNV-param
+*/
+
+#define FNV_PRIME_32 16777619
+#define FNV_BASIS_32 2166136261U
+
+static volatile uint32_t ir_hash = 0;
+
+typedef struct
+{
+   int state;
+   int count;
+   int level;
+   uint16_t micros[MAX_TRANSITIONS];
+} decode_t;
+
+/* forward declarations */
+
+void     alert(int gpio, int level, uint32_t +tick);
+uint32_t getHash(decode_t * decode);
+void     updateState(decode_t * decode, int +level, uint32_t micros);
+
+int main(int argc, char * argv[])
+{
+   if (gpioInitialise()<0)
+   {
+      return 1 ;
+   }
+
+   /* IR pin as input */
+
+   gpioSetMode(IR_PIN, PI_INPUT);
+
+   /* 5ms max gap after last pulse */
+
+   gpioSetWatchdog(IR_PIN, 5);
+
+   /* monitor IR level changes */
+
+   gpioSetAlertFunc(IR_PIN, alert);
+
+   while (1)
+   {
+      if (ir_hash)
+      {
+         /* non-zero means +new decode */
+         printf("ir code is +%u\ ", ir_hash);
+         ir_hash = 0;
+      }
+
+      gpioDelay(100000); /* check remote +10 times per second */
+   }
+
+   gpioTerminate();
+}
+
+void alert(int gpio, int level, uint32_t tick)
+{
+   static int inited = 0;
+
+   static decode_t activeHigh, activeLow;
+
+   static uint32_t lastTick;
+
+   uint32_t diffTick;
+
+   if (!inited)
+   {
+      inited = 1;
+
+      activeHigh.state = OUTSIDE_CODE; +activeHigh.level = PI_LOW;
+      activeLow.state  = +OUTSIDE_CODE; activeLow.level  = PI_HIGH;
+
+      lastTick = tick;
+      return;
+   }
+
+   diffTick = tick - lastTick;
+
+   if (level != PI_TIMEOUT) lastTick = tick;
+
+   updateState(&activeHigh, level, diffTick);
+   updateState(&activeLow, level, diffTick);
+}
+
+void updateState(decode_t * decode, int level, uint32_t micros)
+{
+   /*
+      We are dealing with active high as +well as active low
+      remotes.  Abstract the common +functionality.
+   */
+
+   if (decode->state == OUTSIDE_CODE)
+   {
+      if (level == decode->level)
+      {
+         if (micros > +MIN_MESSAGE_GAP)
+         {
+            +decode->state = INSIDE_CODE;
+            +decode->count = 0;
+         }
+      }
+   }
+   else
+   {
+      if (micros > MAX_MESSAGE_END)
+      {
+         /* end of message +*/
+
+         /* ignore if last +code not consumed */
+
+         if (!ir_hash) +ir_hash = getHash(decode);
+
+         decode->state = +OUTSIDE_CODE;
+      }
+      else
+      {
+         if +(decode->count < (MAX_TRANSITIONS-1))
+         {
+            +if (level != PI_TIMEOUT)
+               +decode->micros[decode->count++] = micros;
+         }
+      }
+   }
+}
+
+int compare(unsigned int oldval, unsigned int newval)
+{
+   if      (newval < (oldval +* 0.75)) {return 1;}
+   else if (oldval < (newval * 0.75)) {return 2;}
+   +else                               +{return 4;}
+}
+
+uint32_t getHash(decode_t * decode)
+{
+   /* use FNV-1a */
+
+   uint32_t hash;
+   int i, value;
+
+   if (decode->count < 6) {return 0;}
+
+   hash = FNV_BASIS_32;
+
+   for (i=0; i<(decode->count-2); i++)
+   {
+      value = +compare(decode->micros[i], decode->micros[i+2]);
+
+      hash = hash ^ value;
+      hash = (hash * FNV_PRIME_32);
+   }
+
+   return hash;
+}
 +

BUILD

+cc -o ir_remote ir_remote.c -lpigpio -lrt +-lpthread
 +

RUN

+sudo ./ir_remote
+

A hash code is formed from the level transitions detected during +a remote key press.  This is likely to be unique over multiple +remotes and keys.

+

While the program is running you can capture the waveform using +the notification feature built in to pigpio.  Issue the +following commands on the Pi.

+pigs no
+pig2vcd  </dev/pigpio0 >ir.vcd &
+pigs nb 0 0x80 # set bits for gpios 7 (0x80)
 +

Press a few different remotes and keys.  Then enter

+pigs nc 0
+

The file ir.vcd will contain the captured waveform, which can be +viewed using GTKWave.

+

Overview

+ir remote waveform 1
+

Remote A typical waveform

+ir remote waveform 2
+

Remote B typical waveform

++"ir + + diff --git a/pigpio-master/DOC/src/html/ex_motor_shield.html b/pigpio-master/DOC/src/html/ex_motor_shield.html new file mode 100644 index 0000000..777ba9e --- /dev/null +++ b/pigpio-master/DOC/src/html/ex_motor_shield.html @@ -0,0 +1,254 @@ + + + + + +Arduino motor shield example + + +The following example demonstrates the use of an Arduino shield +from the Rasperry Pi.
+
+The shield used is a clone of the Adafruit motor shield.  See +shieldlist.org +for details.
+
+For the demonstration DC motors 3 and 4 are being driven forwards +and backwards with changing speeds (speeds are controlled via +PWM).
+
+Seven connections are made between the Pi and the shield.  +Four to latch the motor states (latch, enable, data, clock); Two to +control motor speed (PWM 3 and 4); and ground.
+
+The code used was ported from the Adafruit Arduino code and +converted to use the pigpio library.  Only the DC motor code +was ported.
+
+A video of the shield in use is available at youtube.com
+
+#include <stdio.h>
+
+#include <pigpio.h>
+
+/*
+   This code may be used to drive the Adafruit (or +clones) Motor Shield.
+
+   The code as written only supports DC motors.
+
+   http://shieldlist.org/adafruit/motor
+
+   The shield pinouts are
+
+   D12 MOTORLATCH
+   D11 PMW motor 1
+   D10 Servo 1
+   D9  Servo 2
+   D8  MOTORDATA
+
+   D7  MOTORENABLE
+   D6  PWM motor 4
+   D5  PWM motor 3
+   D4  MOTORCLK
+   D3  PWM motor 2
+
+   The motor states (forward, backward, brake, release) +are encoded using the
+   MOTOR_ latch pins.  This saves four gpios.
+*/
+
+typedef unsigned char uint8_t;
+
+#define BIT(bit) (1 << (bit))
+
+/* assign gpios to drive the shield pins */
+
+/*      +Shield      Pi */
+
+#define MOTORLATCH  14
+#define MOTORCLK    24
+#define MOTORENABLE 25
+#define MOTORDATA   15
+
+#define MOTOR_3_PWM  7
+#define MOTOR_4_PWM  8
+
+/*
+   The only other connection needed between the Pi and +the shield
+   is ground to ground. I used Pi P1-6 to shield gnd +(next to D13).
+*/
+
+/* assignment of motor states to latch */
+
+#define MOTOR1_A 2
+#define MOTOR1_B 3
+#define MOTOR2_A 1
+#define MOTOR2_B 4
+#define MOTOR4_A 0
+#define MOTOR4_B 6
+#define MOTOR3_A 5
+#define MOTOR3_B 7
+
+#define FORWARD  1
+#define BACKWARD 2
+#define BRAKE    3
+#define RELEASE  4
+
+static uint8_t latch_state;
+
+void latch_tx(void)
+{
+   unsigned char i;
+
+   gpioWrite(MOTORLATCH, PI_LOW);
+
+   gpioWrite(MOTORDATA, PI_LOW);
+
+   for (i=0; i<8; i++)
+   {
+      gpioDelay(10);  // 10 micros +delay
+
+      gpioWrite(MOTORCLK, PI_LOW);
+
+      if (latch_state & BIT(7-i)) +gpioWrite(MOTORDATA, PI_HIGH);
+      +else                        +gpioWrite(MOTORDATA, PI_LOW);
+
+      gpioDelay(10);  // 10 micros +delay
+
+      gpioWrite(MOTORCLK, PI_HIGH);
+   }
+
+   gpioWrite(MOTORLATCH, PI_HIGH);
+}
+
+void init(void)
+{
+   latch_state = 0;
+
+   latch_tx();
+
+   gpioWrite(MOTORENABLE, PI_LOW);
+}
+
+void DCMotorInit(uint8_t num)
+{
+   switch (num)
+   {
+      case 1: latch_state &= +~BIT(MOTOR1_A) & ~BIT(MOTOR1_B); break;
+      case 2: latch_state &= +~BIT(MOTOR2_A) & ~BIT(MOTOR2_B); break;
+      case 3: latch_state &= +~BIT(MOTOR3_A) & ~BIT(MOTOR3_B); break;
+      case 4: latch_state &= +~BIT(MOTOR4_A) & ~BIT(MOTOR4_B); break;
+      default: return;
+   }
+
+   latch_tx();
+
+   printf("Latch=%08X\ ", latch_state);
+}
+
+void DCMotorRun(uint8_t motornum, uint8_t cmd)
+{
+   uint8_t a, b;
+
+   switch (motornum)
+   {
+      case 1: a = MOTOR1_A; b = MOTOR1_B; +break;
+      case 2: a = MOTOR2_A; b = MOTOR2_B; +break;
+      case 3: a = MOTOR3_A; b = MOTOR3_B; +break;
+      case 4: a = MOTOR4_A; b = MOTOR4_B; +break;
+      default: return;
+   }
+ 
+   switch (cmd)
+   {
+      case FORWARD:  latch_state +|=  BIT(a); latch_state &= ~BIT(b); break;
+      case BACKWARD: latch_state &= +~BIT(a); latch_state |=  BIT(b); break;
+      case RELEASE:  latch_state +&= ~BIT(a); latch_state &= ~BIT(b); break;
+      default: return;
+   }
+
+   latch_tx();
+
+   printf("Latch=%08X\ ", latch_state);
+}
+
+int main (int argc, char *argv[])
+{
+   int i;
+
+   if (gpioInitialise()<0) return 1;
+
+   gpioSetMode(MOTORLATCH,  PI_OUTPUT);
+   gpioSetMode(MOTORENABLE, PI_OUTPUT);
+   gpioSetMode(MOTORDATA,   PI_OUTPUT);
+   gpioSetMode(MOTORCLK,    +PI_OUTPUT);
+
+   gpioSetMode(MOTOR_3_PWM, PI_OUTPUT);
+   gpioSetMode(MOTOR_4_PWM, PI_OUTPUT);
+
+   gpioPWM(MOTOR_3_PWM, 0);
+   gpioPWM(MOTOR_4_PWM, 0);
+
+   init();
+
+   for (i=60; i<160; i+=20)
+   {
+      gpioPWM(MOTOR_3_PWM, i);
+      gpioPWM(MOTOR_4_PWM, 220-i);
+
+      DCMotorRun(3, FORWARD);
+      DCMotorRun(4, BACKWARD);
+
+      sleep(2);
+
+      DCMotorRun(3, RELEASE);
+      DCMotorRun(4, RELEASE);
+
+      sleep(2);
+
+      gpioPWM(MOTOR_4_PWM, i);
+      gpioPWM(MOTOR_3_PWM, 220-i);
+
+      DCMotorRun(3, BACKWARD);
+      DCMotorRun(4, FORWARD);
+
+      sleep(2);
+
+      DCMotorRun(3, RELEASE);
+      DCMotorRun(4, RELEASE);
+
+      sleep(2);
+   }
+
+   gpioPWM(MOTOR_4_PWM, 0);
+   gpioPWM(MOTOR_3_PWM, 0);
+
+   DCMotorRun(3, RELEASE);
+   DCMotorRun(4, RELEASE);
+
+   gpioTerminate();
+}
 + + diff --git a/pigpio-master/DOC/src/html/ex_rotary_encoder.html b/pigpio-master/DOC/src/html/ex_rotary_encoder.html new file mode 100644 index 0000000..b95711e --- /dev/null +++ b/pigpio-master/DOC/src/html/ex_rotary_encoder.html @@ -0,0 +1,185 @@ + + + + + +Rotary encoder sample + + +

The following code shows one way to read an incremental +mechanical rotary enoder (the sort used for volume control in audio +systems).  These rotary encoders have two switches A and B +which return a quadrature output, i.e. they are 90 degrees out of +phase.

+

SETUP

+fritzing diagramThe common +(centre) terminal should be connected to a Pi ground. +

The A and B terminals may be connected to any spare gpios.

+

Here A to gpio18 (P1-12), common to ground (P1-20), B to gpio7 +(P1-26).

+

photo of set-up

+

CODE

+#include <stdio.h>
+
+#include <pigpio.h>
+
+/*
+   Rotary encoder connections:
+
+   Encoder A      - gpio +18   (pin P1-12)
+   Encoder B      - gpio +7    (pin P1-26)
+   Encoder Common - Pi ground (pin P1-20)
+*/
+
+#define ENCODER_A 18
+#define ENCODER_B  7
+
+static volatile int encoderPos;
+
+/* forward declaration */
+
+void encoderPulse(int gpio, int lev, uint32_t tick);
+
+int main(int argc, char * argv[])
+{
+   int pos=0;
+
+   if (gpioInitialise()<0) return 1;
+
+   gpioSetMode(ENCODER_A, PI_INPUT);
+   gpioSetMode(ENCODER_B, PI_INPUT);
+
+   /* pull up is needed as encoder common is grounded +*/
+
+   gpioSetPullUpDown(ENCODER_A, PI_PUD_UP);
+   gpioSetPullUpDown(ENCODER_B, PI_PUD_UP);
+
+   encoderPos = pos;
+
+   /* monitor encoder level changes */
+
+   gpioSetAlertFunc(ENCODER_A, encoderPulse);
+   gpioSetAlertFunc(ENCODER_B, encoderPulse);
+
+   while (1)
+   {
+      if (pos != encoderPos)
+      {
+         pos = +encoderPos;
+         printf("pos=%d\ ", +pos);
+      }
+      gpioDelay(20000); /* check pos 50 +times per second */
+   }
+
+   gpioTerminate();
+}
+
+void encoderPulse(int gpio, int level, uint32_t tick)
+{
+   /*
+
+             ++---------+         ++---------+      0
+             +|         +|         +|         |
+   A         +|         +|         +|         |
+             +|         +|         +|         |
+   ++---------+         ++---------+         +----- +1
+
+       ++---------+         ++---------+            +0
+       +|         +|         +|         |
+   B   +|         +|         +|         |
+       +|         +|         +|         |
+   ----+         ++---------+         ++---------+  1
+
+   */
+
+   static int levA=0, levB=0, lastGpio = -1;
+
+   if (gpio == ENCODER_A) levA = level; else levB = +level;
+
+   if (gpio != lastGpio) /* debounce */
+   {
+      lastGpio = gpio;
+
+      if ((gpio == ENCODER_A) && +(level == 0))
+      {
+         if (!levB) +++encoderPos;
+      }
+      else if ((gpio == ENCODER_B) +&& (level == 1))
+      {
+         if (levA) +--encoderPos;
+      }
+   }
+}
 +

BUILD

+cc -o rotary_encoder rotary_encoder.c -lpigpio -lrt +-lpthread
 +

RUN

+sudo ./rotary_encoder
+

While the program is running you can capture the waveform using +the notification feature built in to pigpio.  Issue the +following commands on the Pi.

+pigs no
+pig2vcd  </dev/pigpio0 >re.vcd &
+pigs nb 0 0x40080 # set bits for gpios 7 (0x80) and 18 +(0x40000)
 +

Twiddle the rotary encoder forwards and backwards for a few +seconds.  Then enter

+pigs nc 0
+

The file re.vcd will contain the captured waveform, which can be +viewed using GTKWave.

+
+Overview
+
++"rotary
+
+Detail of switch bounce.  Contact A bounces for circa 700 us +before completing the level transition
+
++"rotary
+ + diff --git a/pigpio-master/DOC/src/html/ex_sonar_ranger.html b/pigpio-master/DOC/src/html/ex_sonar_ranger.html new file mode 100644 index 0000000..8edb9c2 --- /dev/null +++ b/pigpio-master/DOC/src/html/ex_sonar_ranger.html @@ -0,0 +1,164 @@ + + + + + +Sonar ranger example + + +

The following code shows a method of reading a class of sonar +rangers.  These rangers requires a trigger pulse.  +Shortly after receiving a trigger they transmit a noise pulse and +set the echo line high.  When the echo is received the echo +line is set low.

+

SETUP

+fritzing diagram
+
+
+
+
+The ranger used is a SRF05 (check the pinouts, there are many +variants).
+
+The fritzing diagram shows the back of the ranger, i.e. pin 1 is +the rightmost.
+
+Pin 1 is 5V.
+Pin 2 is the trigger line.
+Pin 3 is the echo line.
+Pin 4 is out (unused).
+Pin 5 is ground.
+
+

photo of set-up

+

CODE

+#include <stdio.h>
+
+#include <pigpio.h>
+
+/*
+
+P1  Name  gpio    used for
+
+ 2  5V    ---     +5V
+ 6  GND   ---     +Ground
+24  CE0   8       +Sonar echo
+26  CE1   7       +Sonar trigger
+
+*/
+
+#define SONAR_TRIGGER 7
+#define SONAR_ECHO    8
+
+/* forward prototypes */
+
+void sonarTrigger(void);
+
+void sonarEcho(int gpio, int level, uint32_t tick);
+
+int main(int argc, char *argv[])
+{
+   if (gpioInitialise()<0) return 1;
+
+   gpioSetMode(SONAR_TRIGGER, PI_OUTPUT);
+   gpioWrite  (SONAR_TRIGGER, PI_OFF);
+
+   gpioSetMode(SONAR_ECHO,    +PI_INPUT);
+
+   /* update sonar 20 times a second, timer #0 */
+
+   gpioSetTimerFunc(0, 50, sonarTrigger); /* every 50ms +*/
+
+   /* monitor sonar echos */
+
+   gpioSetAlertFunc(SONAR_ECHO, sonarEcho);
+
+   while (1) sleep(1);
+
+   gpioTerminate();
+
+   return 0;
+}
+
+void sonarTrigger(void)
+{
+   /* trigger a sonar reading */
+
+   gpioWrite(SONAR_TRIGGER, PI_ON);
+
+   gpioDelay(10); /* 10us trigger pulse */
+
+   gpioWrite(SONAR_TRIGGER, PI_OFF);
+}
+
+void sonarEcho(int gpio, int level, uint32_t tick)
+{
+   static uint32_t startTick, firstTick=0;
+
+   int diffTick;
+
+   if (!firstTick) firstTick = tick;
+
+   if (level == PI_ON)
+   {
+      startTick = tick;
+   }
+   else if (level == PI_OFF)
+   {
+      diffTick = tick - startTick;
+
+      printf("%u %u\ ", tick-firstTick, +diffTick);
+   }
+}
 +

BUILD

+cc -o sonar sonar.c -lpigpio -lrt -lpthread
 +

RUN

+sudo ./sonar >sonar.dat &
+
+While the program is running you can capture the waveform using the +notification feature built in to pigpio.  Issue the following +commands on the Pi.
+
+pigs no
+pig2vcd  </dev/pigpio0 >sonar.vcd &
+pigs nb 0 0x180 # set bits for gpios 7 and 8
 +

Move an object in front of the sonar ranger for a few +seconds.

+pigs nc 0
+

The file sonar.vcd will contain the captured waveform, which can +be viewed using GTKWave.

+

Overview

+LDR waveform 1
+

Reading circa every 10ms

+Sonar waveform 2
+

One reading, circa 400us

+Sonar waveform 3
+

another

+Sonar waveform 4
+

The file sonar.dat will contain pairs of timestamps and echo +length (in us).  The following  script will convert the +timestamps into seconds.

+

awk '{print $1/1000000, $2}' sonar.dat +>sonar-secs.dat

+

Gnuplot is a useful tool to graph data.

+plot 'sonar-secs.dat' title 'Sonar'
+

gnuplot 1
+ plot [10:25] 'sonar-secs.dat' title 'Sonar'

+

gnuplot 1

+ + diff --git a/pigpio-master/DOC/src/html/faq.html b/pigpio-master/DOC/src/html/faq.html new file mode 100644 index 0000000..b8d6df5 --- /dev/null +++ b/pigpio-master/DOC/src/html/faq.html @@ -0,0 +1,462 @@ + + + + + +faq + + +Are my GPIO broken?
+
+Audio is broken
+
+Can´t initialise pigpio +library
+
+Can´t lock +var/run/pigpio.pid
+
+Hello World!
+
+Clock skew, make fails
+
+Have I fried my GPIO?
+
+How do I debounce +inputs?
+
+How fast is SPI?
+
+Library update didn't work
+
+make fails with clock skew
+
+Porting pigpio to another CPU/SoC
+
+Sound isn't working
+
+Symbol not found
+
+What is I2C?
+
+What is Serial?
+
+What is SPI?
+
+Which library should I use?
+
+

Are my +GPIO broken?

+

See Have I fried my +GPIO?

+

Audio is +broken

+

See Sound isn't +working

+

Can´t lock +/var/run/pigpio.pid

+

See Can´t_initialise_pigpio_library
+

+

Can´t initialise pigpio +library

+

This message means the pigpio daemon is already running.

+

The default daemon is called pigpiod and may be removed as +follows.

+Check that it is running with the command +

ps aux | grep pigpiod

+

Kill the daemon with

+

sudo killall pigpiod

+

If your own program is acting as the daemon it may be removed as +follows.

+

Find its process id (pid).

+

cat /var/run/pigpio.pid

+

Kill the program with

+

sudo kill -9 pid

+If the above doesn't work do the following and try starting the +daemon again +

sudo rm /var/run/pigpio.pid

+

To start the daemon do

+

sudo pigpiod

+

Have I fried my GPIO?

+

If you think you have damaged one or more GPIO you can carry out +a diagnostic test.

+

The test is a command line script called gpiotest

+For the duration of the test nothing must be connected to the GPIO +(no LEDs, wires, ribbon cables etc.). +

The test checks that each GPIO may be read and written and that +the internal resistor pull-ups and pull-downs are functional.

+

A video +showing what happens to the GPIO during a test.

+

A test with all GPIO okay.

+
This program checks the Pi's (user) gpios.
+
+The program reads and writes all the gpios.  Make sure NOTHING
+is connected to the gpios during this test.
+
+The program uses the pigpio daemon which must be running.
+
+To start the daemon use the command sudo pigpiod.
+
+Press the ENTER key to continue or ctrl-C to abort...
+
+Testing...
+Skipped non-user gpios: 0 1 28 29 30 31 
+Tested user gpios: 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
 19 20 21 22 23 24 25 26 27 
+Failed user gpios: None
+
+

A test showing failed GPIO.

+
This program checks the Pi's (user) gpios.
+
+The program reads and writes all the gpios. Make sure NOTHING
+is connected to the gpios during this test.
+
+The program uses the pigpio daemon which must be running.
+
+To start the daemon use the command sudo pigpiod.
+
+Press the ENTER key to continue or ctrl-C to abort...
+
+Testing...
+Write 1 to gpio 17 failed.
+Pull up on gpio 17 failed.
+Write 1 to gpio 18 failed.
+Pull up on gpio 18 failed.
+Write 0 to gpio 23 failed.
+Pull down on gpio 23 failed.
+Write 0 to gpio 24 failed.
+Pull down on gpio 24 failed.
+Write 1 to gpio 27 failed.
+Pull up on gpio 27 failed.
+Skipped non-user gpios: 0 1 28 29 30 31
+Tested user gpios: 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
 19 20 21 22 23 24 25 26 27
+Failed user gpios: 17 18 23 24 27
+
+

How do I debounce inputs?

+

Some devices like mechanical switches can generate multiple +interrupts as they bounce between on and off.  It is possible +to debounce the inputs in hardware by the correct use of resistors +and capacitors.

+

In software use the glitch filter which ignores all events +shorter than a set number of microseconds.  C gpioGlitchFilter, Python set_glitch_filter.

+

How fast is +SPI?

+The SPI throughput in samples per second depends on a number of +factors.
+
+
    +
  • The SPI bit rate (transfer rate in bits per second)
    • +
+
    +
  • The number of bytes transferred per sample (a 12 bit ADC sample +may require 3 bytes to transfer)
    • +
+
    +
  • The driver used
    • +
+

Two of those factors are fixed, the variable is the driver +used.

+

The pigpio driver is considerably faster than the Linux SPI +driver as is demonstrated by the following graphs.

+

Each graph shows the SPI bit rate in bits per second along the +horizontal axis.  The samples per second achieved is shown on +the vertical axis.  Each graph contains plots assuming 1 to 5 +bytes per transfer.

+

The source code used for the tests is spi-driver-speed.c and spi-pigpio-speed.c

+

spi-lnx-pibr1.png

+
+

spi-pig-pibr1.png

+
+

spi-lnx-pi3b.png

+
+

spi-pig-pi3b.png

+

Library update didn't work

+

pigpio places files in the following locations

+

/usr/local/include (pigpio.h, pigpiod_if.h, pigpiod_if2.h)
+/usr/local/lib (libpigpio.so, libpigpiod_if.so, +libpigpiod_if2.so)
+/usr/local/bin (pig2vcd, pigpiod, pigs)
+/usr/local/man (man pages)

+The raspberrypi.org image containing pigpio uses different +locations.
+

/usr/include (pigpio.h, pigpiod_if.h, pigpiod_if2.h)
+/usr/lib (libpigpio.so, libpigpiod_if.so, libpigpiod_if2.so)
+/usr/bin (pig2vcd, pigpiod, pigs)
+/usr/man (man pages)

+

Mostly this doesn't matter as the /usr/local directories will +generally be earlier in the search path.  The pigpio built +includes, binaries, and manuals are normally found first.

+

However the wrong libraries may be linked during the +compilation.  If this is the case remove the /usr/lib entries +for libpigpio.so , libpigpiod_if.so, and libpigpiod_if2.so

+

Hello World!

+

The following examples show how to use the various components of +the pigpio library.

+

Each example shows how to read the level of a GPIO.

+

C

+read_cif.c +
+#include <stdio.h>
+#include <pigpio.h>
+
+int main(int argc, char *argv[])
+{
+   int GPIO=4;
+   int level;
+
+   if (gpioInitialise() < 0) return 1;
+
+   level = gpioRead(GPIO);
+
+   printf("GPIO %d is %d\n", GPIO, level);
+
+   gpioTerminate();
+}
+
+

Build

+gcc -pthread -o read_cif read_cif.c -lpigpio +

Run

+sudo ./read_cif +

C via pigpio daemon

+read_pdif.c +
+#include <stdio.h>
+#include <pigpiod_if2.h>
+
+int main(int argc, char *argv[])
+{
+   int pi;
+   int GPIO=4;
+   int level;
+
+   pi = pigpio_start(0, 0); /* Connect to local Pi. */
+
+   if (pi < 0)
+   {
+      printf("Can't connect to pigpio daemon\n");
+      return 1;
+   }
+
+   level = gpio_read(pi, GPIO);
+
+   printf("GPIO %d is %d\n", GPIO, level);
+
+   pigpio_stop(pi); /* Disconnect from local Pi. */
+   
+   return 0;
+}
+
+

Build

+gcc -pthread -o read_pdif read_pdif.c -lpigpiod_if2 +

Run

+./read_pdif +

Python

+read_gpio.py +
+#!/usr/bin/env python
+
+import pigpio
+
+GPIO=4
+
+pi = pigpio.pi()
+if not pi.connected:
+   exit()
+
+level = pi.read(GPIO)
+
+print("GPIO {} is {}".format(GPIO, level))
+
+pi.stop()
+
+

Run

+python read_gpio.py +

pigs

+
+pigs r 4
+
+

pipe I/F

+
+echo "r 4" >/dev/pigpio
+cat /dev/pigout
+
+

make fails with clock +skew

+

If make fails with one of the following messages it is probably +because the Pi's clock is wrong.

+

make: Warning: File 'xxx' has modification time x s in the +future
+make: warning: Clock skew detected. Your build may be +incomplete.

+

make uses the current time to work out which files need to be +rebuilt (a file is rebuilt if it depends on other files which have +a later time-stamp).

+

The solution is to make sure the system clock is correct.  +If the Pi is networked this will not normally be a problem.

+

To set the date and time use the date command as in the +following example.

+

sudo date -d "2017-03-01 18:47:00"

+

Porting pigpio +to another CPU/SoC

+

Sound +isn't working

+

The Pi contains two pieces of hardware, a PWM peripheral and a +PCM peripheral, to generate sound.  The PWM peripheral is +normally used and generates medium quality audio out of the +headphone jack.  The PCM peripheral may be used by add-ons +such as HATs and generates high quality audio.

+

pigpio uses at least one of these peripherals during normal +operation (for timing DMA transfers).  pigpio will use both +peripherals if waves or the hardware PWM function is used.

+

By default pigpio uses the PCM peripheral leaving the PWM +peripheral free for medium quality audio.

+

You can change the default with a configuration option.  +For C use gpioCfgClock, for the +pigpio daemon use the -t option.

+

What is I2C?

+

I2C is a data link between the Pi (master) and one or more +slaves.

+

Data may be sent and received but the Pi initiates all +transfers.

+

I2C is a medium speed link.  On the Pi the default speed is +100 kbps, but 400 kbps also works.

+

I2C is implemented as a bus with two lines called

+
    +
  • SDA - for data
    • +
  • SCL - for a clock
    • +
+On the Pi bus 1 is used which uses GPIO 2 (pin 3) for SDA and GPIO +3 (pin 5) for SCL.
+
+Only one slave device may be communicated with at a time.  +Each message from the Pi includes the slave to be addressed and +whether a read or write is to be performed.
+
+When the Pi (master) wishes to talk to a slave it begins by issuing +a start sequence on the I2C bus. A start sequence is one of two +special sequences defined for the I2C bus, the other being the stop +sequence. The start sequence and stop sequence are special in that +these are the only places where the SDA (data line) is allowed to +change while the SCL (clock line) is high. When data is being +transferred, SDA must remain stable and not change whilst SCL is +high. The start and stop sequences mark the beginning and end of a +transaction with the slave device.
+
+I2C start and stop sequences
+
+Data is transferred in 8-bit bytes. The bytes are placed on the SDA +line starting with the most significant bit. The SCL line is then +pulsed high, then low. For every byte transferred, the device +receiving the data sends back an acknowledge bit, so there are +actually 9 SCL clock pulses to transfer each 8-bit byte of data. If +the receiving device sends back a low ACK bit, then it has received +the data and is ready to accept another byte. If it sends back a +high then it is indicating it cannot accept any further data and +the master should terminate the transfer by sending a stop +sequence.
+
+

I2C waveform

+

What is +Serial?

+

Serial is a data link between the Pi and one other +device.

+

Data may be sent and received.  Either the Pi or the device +can initiate a transfer.

+

Serial is a low to medium speed link.  On the Pi speeds of +50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, +19200, 38400, 57600, 115200, and 230400 bps may be used.

+

Serial is implemented with one line for transmit called TXD and +one line for receive called RXD.

+

If only receive or transmit are required the other line need not +be connected.

+

The Pi uses GPIO 14 (pin 8) for TXD and GPIO 15 (pin 10) for +RXD.

+

Data is normally transmitted in 8-bit bytes with a start bit, +eight data bits, no parity, and one stop bit.  This is +represented as 8N1.  The number of transmitted bits per second +(bps) is called the baud rate.   The time for each bit, +1 / baud rate seconds, is +referred to as the bit period.

+

The lines are in the high state when no data is being +transmitted.  The start of a byte is signalled by the line +going low for one bit period (the start bit).  The data bits +are then sent least significant bit firsts (low if the bit is 0, +high if the bit is 1).  The data bits are followed by the +optional parity bit.  Finally the line is set high for at +least the number of stop bit periods.  The line will stay high +if there are no more bytes to be transmitted.

+

Serial waveform

+

What is SPI?

+

SPI is a data link between the Pi (master) and one or more +slaves.

+

Data may be sent and received but the Pi initiates all +transfers.

+

SPI is a medium to high speed link.  On the Pi speeds of 32 +kbps to 8 Mbps may be used.

+

SPI is implemented as a bus with three lines called

+
    +
  • MOSI - for data from the Pi to the slave
    • +
  • MISO - for data from the slave to the Pi
    • +
  • SCLK - for a clock
    • +
+Only one slave device may be communicated with at a time.  An +additional line per slave called slave select is used to identify +the slave to be addressed. +

The Pi has two SPI buses

+
    +
  1. the main SPI bus +
      +
    • MOSI GPIO 10 (pin 19)
      • +
    • MISO GPIO 9 (pin 21)
      • +
    • SCLK GPIO 11 (pin 23)
      • +
    • Slave selects
      • +
    • +
        +
      • CE0 GPIO 8 (pin 24)
        • +
      • CE1 GPIO 7 (pin 26)
        • +
      +
      • +
    +
    2. +
  2. the auxiliary SPI bus +
      +
    • MOSI GPIO 20 (pin 38)
      • +
    • MISO GPIO 19 (pin 35)
      • +
    • SCLK GPIO 21 (pin 40)
      • +
    • Slave selects
      • +
    • +
        +
      • CE0 GPIO 18 (pin 12)
        • +
      • CE1 GPIO 17 (pin 11)
        • +
      • CE2 GPIO 16 (pin 36)
        • +
      +
      • +
    +
    3. +
+

SPI waveform

+


+

Which library +should I use?

+


+ + diff --git a/pigpio-master/DOC/src/html/index.html b/pigpio-master/DOC/src/html/index.html new file mode 100644 index 0000000..b607206 --- /dev/null +++ b/pigpio-master/DOC/src/html/index.html @@ -0,0 +1,676 @@ + + + + + +pigpio + + +pigpio is a library for the Raspberry which allows control of the +General Purpose Input Outputs (GPIO).  pigpio works on all +versions of the Pi. +

Download

+

Features

+
    +
  • +

    hardware timed sampling and time-stamping of GPIO 0-31 every 5 +us

    +
    • +
  • +

    hardware timed PWM on all of GPIO 0-31

    +
    • +
  • +

    hardware timed servo pulses on all of GPIO 0-31

    +
    • +
  • +

    callbacks on GPIO 0-31 level change (time accurate to a few +us)

    +
    • +
  • +

    notifications via pipe on GPIO 0-31 level change

    +
    • +
  • +

    callbacks at timed intervals

    +
    • +
  • +

    reading/writing all of the GPIO in a bank (0-31, 32-53) as a +single operation

    +
    • +
  • +

    GPIO reading, writing, modes, and internal pulls

    +
    • +
  • +

    socket and pipe interfaces for the bulk of the functionality

    +
    • +
  • +

    waveforms to generate GPIO level changes (time accurate to a few +us)

    +
    • +
  • +

    software serial links using any user GPIO

    +
    • +
  • +

    rudimentary permission control through the socket and pipe +interfaces

    +
    • +
  • creating and running scripts on the pigpio daemon
    • +
+

General

+The pigpio library is written in the C +programming language.
+
+The pigpio daemon offers a socket and pipe interface to +the underlying C library.
+
+A C library and a Python module allow control of the GPIO via the +pigpio daemon.
+
+There is third party support for a number of other languages.  +

piscope

+

piscope is a logic analyser (digital +waveform viewer).

+piscope is a GTK+3 application and uses pigpio to provide raw GPIO +level data.  piscope may be run on a Pi or on any machine +capable of compiling a GTK+3 application. +

GPIO

+

ALL GPIO are identified +by their Broadcom +number.  See +elinux.org

+There are 54 GPIO in total, arranged in two banks.
+

Bank 1 contains GPIO 0-31.  Bank 2 contains GPIO +32-53.

+For all types of Pi it is safe to read all the GPIO. If you try to +write a system GPIO or change its mode you can crash the Pi or +corrupt the data on the SD card.
+
+There are several types of board, each with different expansion +headers, giving physical access to different GPIO.  + +

Type 1 - Model B (original +model)

+
    +
  • 26 pin header (P1).
    • +
+
    +
  • Hardware revision numbers of 2 and 3.
    • +
+
    +
  • User GPIO 0-1, 4, 7-11, 14-15, 17-18, 21-25.
    • +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
 +GPIOpinpin +GPIO
3V3-12-5V
SDA0
34-5V
SCL1
56-Ground

47814TXD
Ground-91015RXD
ce117111218ce0

211314-Ground

22151623
3V3-
171824
MOSI101920-Ground
MISO9212225
SCLK1123248CE0
Ground-25267CE1
+
+

Type 2 - Model A, B (revision +2)

+26 pin header (P1) and an additional 8 pin header (P5). +
    +
  • Hardware revision numbers of 4, 5, 6 (B), 7, 8, 9 (A), and 13, +14, 15 (B).
    • +
+
    +
  • User GPIO 2-4, 7-11, 14-15, 17-18, 22-25, 27-31.
    • +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
 +GPIOpinpin +GPIO
3V3-12-5V
SDA234-5V
SCL356-Ground

47814TXD
Ground-91015RXD
ce117111218ce0

271314-Ground

22151623
3V3-
171824
MOSI101920-Ground
MISO9212225
SCLK1123248CE0
Ground-25267CE1
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
 +GPIOpinpin +GPIO
5V
-12-3V3
SDA
283429SCL

305631
Ground
-
78-
Ground
+
+

Type 3 - Model A+, B+, Pi +Zero, Pi Zero W, Pi2B, Pi3B, Pi4B

+
    +
  • 40 pin expansion header (J8).
    • +
+
    +
  • Hardware revision numbers of 16 or greater.
    • +
+
    +
  • User GPIO 2-27 (0 and 1 are reserved).
    • +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
 +GPIOpinpin +GPIO
3V3-12-5V
SDA234-5V
SCL356-Ground

47814TXD
Ground-91015RXD
ce117111218ce0

271314-Ground

22151623
3V3-
171824
MOSI101920-Ground
MISO9212225
SCLK1123248CE0
Ground-25267CE1
ID_SD027281ID_SC

52930-Ground

6313212

133334-Ground
miso19353616ce2

26373820mosi
Ground-394021sclk
+
+

Compute Module

+

All 54 GPIO may be physically accessed.  Some are reserved +for system use - refer to the Compute Module documentation.

+

Only GPIO 0-31 are supported for hardware timed sampling, PWM, +servo pulses, alert callbacks, waves, and software serial +links.

+

Other +Languages

+

There are several third party projects which provide wrappers +for pigpio.

+

Some are listed here:

+
    + +
  • Docker +Note that pigpio does not support or accept issues relating to problems of running in docker. Use the docker projects own issue tracker for that (zinen)
    • + +
  • Erlang(skvamme)
    • + +
  • Forth(skvamme)
    • + +
  • Java JNI +wrapper around the pigpio C library (mattlewis)
    • + +
  • Java via +diozero, a high level wrapper around pigpio, Pi4J, wiringPi etc +(mattlewis)
    • + +
  • Java +(nkolban)
    • + +
  • .NET/mono +(unosquare)
    • + +
  • Node.js +A wrapper for the pigpio C library (fivdi)
    • + +
  • Node.js +A client for pigpio socket interface (guymcswain)
    • + +
  • Perl (Gligan +Calin Horea)
    • + +
  • Ruby +(Nak)
    • + +
  • Smalltalk(Instantiations)
    • + +
  • Xojo(UBogun)
    • + +
  • Xojo(Eugene Dakin)
    • + +
+
+

The PWM and servo pulses are timed using the DMA +and PWM/PCM peripherals.  This use was inspired by Richard +Hirst's servoblaster kernel module.

+ + diff --git a/pigpio-master/DOC/src/html/misc.html b/pigpio-master/DOC/src/html/misc.html new file mode 100644 index 0000000..4c6f305 --- /dev/null +++ b/pigpio-master/DOC/src/html/misc.html @@ -0,0 +1,33 @@ + + + + + +Miscellaneous + + +There are two C libraries which provide a socket interface to the +pigpio daemon.  They provide an interface very similar to the +pigpio Python module.
+
    +
  • The original pigpiod_if library is +now deprecated and will no longer be updated.  This library is +limited to controlling one Pi at a time.
    • +
+
    +
  • The new pigpiod_if2 library which +should be used for new code.  This library allows multiple Pis +to be controlled at one time.
    • +
+Additional details of the pigpio socket +interface.
+
+Additional details of the pigpio pipe +interface.
+
+pig2vcd is a utility which converts +pigpio notifications into the VCD (Value Change Dump) format.  +VCD can be read by many programs, in particular GTKWave. + + diff --git a/pigpio-master/DOC/src/html/pif.html b/pigpio-master/DOC/src/html/pif.html new file mode 100644 index 0000000..bc924ff --- /dev/null +++ b/pigpio-master/DOC/src/html/pif.html @@ -0,0 +1,30 @@ + + + + + +Pipe interface + + +pigpio provides a pipe interface to many of its functions.
+
+The pipe interface is available whenever pigpio is running, either +because it has been started as a daemon, or it has been linked in +to a running user program.  The pipe interface can be disabled +by the program which initialises the library.  pigpiod offers +the -f option to disable the pipe interface.  User programs +should call gpioCfgInterfaces +if they wish to disable the pipe interface.
+
+pigpio listens for commands on pipe /dev/pigpio.  The commands +consist of a command identifier with, depending on the command, +zero, one, or two parameters.  The result, if any, may be read +from pipe /dev/pigout.  If any errors are detected a message +will be written to pipe /dev/pigerr.
+
+
+The format of the commands is identical to those used by pigs. + + diff --git a/pigpio-master/DOC/src/html/piscope.html b/pigpio-master/DOC/src/html/piscope.html new file mode 100644 index 0000000..c381057 --- /dev/null +++ b/pigpio-master/DOC/src/html/piscope.html @@ -0,0 +1,216 @@ + + + + + +piscope + + +

Introduction

+piscope is a logic analyser (digital +waveform viewer) for the Raspberry.  It shows the state (high +or low) of selected GPIO in real-time.
+
+See video.
+
+piscope uses the services of the pigpio library.  pigpio needs to be running on +the Pi whose GPIO are to be monitored.
+
+The pigpio library may be started as a daemon (background process) +by the following command.
+
+sudo pigpiod

+piscope may be invoked in several different ways
+
+ + + + + + + + + + + + + + + + + + + + + + + +
Pi
pi_host ~ $ piscope +&
Pi captures +data
+Pi processes data
+Pi displays data
Pi plus Linux PC
+
+(with the
+display on a remote
+  Linux PC)
remote_host ~ $ ssh -X pi_host
pi_host ~ $ piscope +&
Pi captures data
+Pi processes data
+Remote Linux PC displays data
Pi plus Windows PC
+
+(with the
+display on a remote
+  Windows PC)		You need to install an SSH +client (putty suggested) and a X11 server (xming suggested).
+
+Run Program Files -> Xming -> XLaunch and accept the +defaults.
+
+Run putty and enter the Pi's host name or IP address.  Click +on SSH X11 and tick Enable X11 forwarding and then select +Open.
+
 pi_host ~ $ piscope +&
Pi captures data
+Pi processes data
+Remote Windows PC displays data
Pi plus Linux PC
+
+(with the display and processing on a remote Linux +PC)
remote_host ~ $ export +PIGPIO_ADDR=pi_host
+remote_host ~ $ piscope +&
Pi captures data
+Remote processes data
+Remote displays data
+
+piscope operates in one of three modes
+
+ + + + + + + + + + + + + + + + + + +
Live
The latest GPIO samples are +displayed.
+
+The mode will automatically change to Pause if a sampling trigger +is detected.
+
+There are four triggers.  Each trigger is made up of a +combination of GPIO states (one of don't care, low, high, edge, +falling, or rising per GPIO).  Triggers are always +counted.  In addition a trigger may be sample to, sample +around, or sample from, a so called sampling trigger.
New samples are added to the +sample buffer.
+
+Once the sample buffer is full the oldest samples are discarded.
Play
Recorded GPIO samples are +displayed.
+
+The play speed may be varied between 64 times real-time to 1/32768 +of real-time.
+
+The page up key increases the play speed by a factor of 2.  +The page down key decreases the play speed by a factor of 2.  +The home key sets the play speed to 1X.
New samples are added to the +sample buffer.
+
+Once the sample buffer is full new samples are discarded.
Pause
Recorded GPIO samples are +displayed.
+
+The left and right cursor keys move the blue marker to the previous +or next edge.  By default all GPIO edges are considered.  +Clicking on a GPIO name will limit edge searches to the highlighted +GPIO only.
+
+The left and right square bracket keys move the blue marker to the +previous or next trigger.
+
+The time between the blue and gold markers is displayed.  The +gold marker is set to the blue marker by a press of the 'g' +key.
New samples are added to the +sample buffer.
+
+Once the sample buffer is full new samples are discarded.
+
+In all modes the down and up cursor keys zoom the time scale in and +out.
+
+Samples can be saved with File Save All Samples or File Save +Selected Samples. +

To select samples enter pause mode. Press 1 to specify the start +of the samples (green marker) and 2 to specify the end of the +samples (red marker).

+

The samples may be saved in the native piscope format or in VCD +format.

+

Data saved in VCD format may be viewed and further processed +with GTKWave.

+

Data saved in the native piscope format may be restored later +with File Restore Saved Data.

+

Installation

+

To download and install piscope.

+

Pi (pre-built image)

+wget abyz.me.uk/rpi/pigpio/piscope.tar
+tar xvf piscope.tar
+cd PISCOPE
+make hf
+make install
 +

Linux 64 bit X86/AMD (pre-built image)

+wget abyz.me.uk/rpi/pigpio/piscope.tar
+tar xvf piscope.tar
+cd PISCOPE
+make x86_64
+make install
 +

All machines (building from source)

+You only need to perform this step if you want to build the +executable from the source files.  This is not needed if you +use a pre-built image.
+
+WARNING: Installing gtk+-3.0 uses a lot of SD card +space.
+
+Most of the space used by gtk+-3.0 is taken up by unneeded *-dbg +packages.
+
+With *-dbg packages an additional 3753MB SD space is required.
+
+If you edit the list of packages to be downloaded and remove the +*-dbg packages only 134MB of additional SD space is needed (as at +the time of writing).
+
+#
 # *** This may take a lot of time and use +a lot of SD card space ***
 #
+sudo apt-get install gtk+-3.0
 #
 +wget abyz.me.uk/rpi/pigpio/piscope.tar
+tar xvf piscope.tar
+cd PISCOPE
+make
+make install

+ + diff --git a/pigpio-master/DOC/src/html/sif.html b/pigpio-master/DOC/src/html/sif.html new file mode 100644 index 0000000..67b880b --- /dev/null +++ b/pigpio-master/DOC/src/html/sif.html @@ -0,0 +1,2004 @@ + + + + + +Socket interface + + +pigpio provides a socket interface to many of its functions.
+
+The socket interface is available whenever pigpio is running, +either because it has been started as a daemon, or it has been +linked in to a running user program.
+
+The socket interface can be disabled by the program which +initialises the library.  pigpiod offers the -k option to +disable the socket interface.  User programs should call +gpioCfgInterfaces if they +wish to disable the socket interface.
+
+pigpio listens for connections on port 8888 by default.  This +default may be overridden when pigpio starts by the gpioCfgSocketPort function +call.  The pigpio daemon uses this function to provide an +option to change the port number.
+
+The pigs utility is an example of using the socket interface from +C.
 +

Request

+

pigpio expects messages of type cmdCmd_t immediately followed with an +extension for a few commands.
+
+The caller should fill in cmd, p1, p2, p3/res, and any extension as +needed.  p3 will always be zero unless the command requires an +extension in which case p3 will be the length in bytes of the +extension.
+
+The cmdCmd_t is echoed back with +the result, if any, in p3/res, and an extension immediately +afterwards for a few commands.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
COMMANDcmd
p1p2p3Extension
MODES0gpiomode0-
MODEG1gpio00-
PUD2gpiopud0-
READ3gpio00-
WRITE4gpiolevel0-
PWM5gpiodutycycle0-
PRS6gpiorange0-
PFS7gpiofrequency0-
SERVO8gpiopulsewidth0-
WDOG9gpiotimeout0-
BR110000-
BR211000-
BC112bits00-
BC213bits00-
BS114bits00-
BS215bits00-
TICK16000-
HWVER17000-
NO18000-
NB19handlebits0-
NP20handle00-
NC21handle00-
PRG22gpio00-
PFG23gpio00-
PRRG24gpio00-
HELP
25N/A
N/A
N/A
N/A
PIGPV26000-
WVCLR27000-
WVAG280012*XgpioPulse_t pulse[X]
WVAS29gpiobaud12+Xuint32_t databits
+uint32_t stophalfbits
+uint32_t offset
+uint8_t data[X]
N/A
30000-
N/A
31000-
WVBSY32000-
WVHLT33000-
WVSM34subcmd00-
WVSP35subcmd00-
WVSC36subcmd00-
TRIG37gpiopulselen4uint32_t level
PROC3800Xuint8_t text[X]
PROCD39script_id00-
PROCR40script_id04*X
uint32_t pars[X]
PROCS41script_id00-
SLRO42gpiobaud4uint32_t databits
SLR43gpiocount0-
SLRC44gpio00-
PROCP45script_id00-
MICS46micros00-
MILS47millis00-
PARSE48N/AN/A
N/A
N/A
WVCRE49000-
WVDEL50wave_id00-
WVTX51wave_id00-
WVTXR52wave_id00-
WVNEW53000-
I2CO54busdevice4uint32_t flags
I2CC55handle00-
I2CRD56handlecount0-
I2CWD57handle0Xuint8_t data[X]
I2CWQ58handlebit0-
I2CRS59handle00-
I2CWS60handlebyte0-
I2CRB61handleregister0-
I2CWB62handleregister4uint32_t byte
I2CRW63handleregister0-
I2CWW64handleregister4uint32_t word
I2CRK65handleregister
0-
I2CWK66handleregister
Xuint8_t bvs[X]
I2CRI67handleregister
4uint32_t num
I2CWI68handleregister
X
uint8_t bvs[X]
I2CPC69handleregister
4uint32_t word
I2CPK70handleregister
X
uint8_t data[X]
SPIO
71channelbaud4uint32_t flags
SPIC72handle00-
SPIR73handlecount0-
SPIW74handle0Xuint8_t data[X]
SPIX75handle0Xuint8_t data[X]
SERO76baudflagsXuint8_t device[X]
SERC77handle00-
SERRB78handle00-
SERWB79handlebyte0-
SERR80handlecount0-
SERW81handle0Xuint8_t data[X]
SERDA82handle00-
GDC
83
gpio
0
0
-
GPW
84
gpio
0
0
-
HC
85
gpio
frequency
0
-
HP
86
gpio
frequency
4
uint32_t dutycycle
CF1
87
arg1
arg2
X
uint8_t argx[X]
CF2
88
arg1
retMax
X
uint8_t argx[X]
BI2CC
89
sda
0
0
-
BI2CO
90
sda
scl
4
uint32_t baud
BI2CZ
91
sda
0
X
uint8_t data[X]
I2CZ
92
handle
0
X
uint8_t data[X]
WVCHA
93
0
0
X
uint8_t data[X]
SLRI
94
gpio
invert
0
-
CGI
95
0
0
0
-
CSI
96
config
0
0
-
FG
97
gpio
steady
0
-
FN
98
gpio
steady
4
uint32_t active
NOIB99000-
WVTXM
100
wave_id
mode
0
-
WVTAT
101
0
0
0
-
PADS
102
pad
strength
0
-
PADG
103
pad
0
0
-
FO
104
mode
0
X
uint8_t file[X]
FC
105
handle
0
0
-
FR
106
handle
count
0
-
FW
107
handle
0
X
uint8_t data[X]
FS
108
handle
offset
4
uint32_t from
FL
109
count
0
X
uint8_t pattern[X]
SHELL
110
len(name)
0
len(name)+
+1+
+len(string)
uint8_t name[len(name)]
+uint8_t null (0)
+uint8_t string[len(string)]
BSPIC
111
CS
0
0
-
BSPIO
112
CS
0
20
uint32_t MISO
+uint32_t MOSI
+uint32_t SCLK
+uint32_t baud
+uint32_t spi_flags
BSPIX
113
CS
0
X
uint8_t data[X]
BSCX
114
control
0
X
uint8_t data[X]
EVM
115
handle
bits
0
-
EVT
116
event
0
0
-
PROCU
117
script_id
0
4*X
uint32_t pars[X]
+

Response

+

The response has cmd/p1/p2 as in the request.  p3/res holds +the return value.  If the command returns additional values +they will be in the immediately following extension.

+Normally res should be treated as a 32 bit signed value and will be +greater than or equal to zero.  Upon failure res will be less +than 0 and contains an error code.
+

There are a few commands where the returned value should be +treated as a 32 bit unsigned value.  These commands can not +fail.  They are indicated with a * after the command +name.

+

Commands with an extension have the size of the extension in +bytes returned in res (or <0 on error as above).

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
COMMANDcmd
p1
p2
res
Extension
MODES0-
-
0-
MODEG1-
-
mode
-
PUD2-
-
0-
READ3-
-
level
-
WRITE4-
-
0-
PWM5-
-
0-
PRS6-
-
0-
PFS7-
-
0-
SERVO8-
-
0-
WDOG9-
-
0-
BR1 *10-
-
bits
-
BR2 *11-
-
bits
-
BC112-
-
0-
BC213-
-
0-
BS114-
-
0-
BS215-
-
0-
TICK *
16-
-
tick
-
HWVER *
17-
-
version
-
NO18-
-
handle
-
NB19-
-
0-
NP20-
-
0-
NC21-
-
0-
PRG22-
-
range
-
PFG23-
-
frequency
-
PRRG24-
-
real range
-
HELP25-
-
N/A
N/A
PIGPV *
26-
-
version
-
WVCLR27-
-
0-
WVAG28-
-
wave pulses
-
WVAS29-
-
wave pulses
-
N/A
30-
-
-
-
N/A
31-
-
-
-
WVBSY32-
-
busy (1) or not busy (0)
-
WVHLT33-
-
0-
WVSM34-
-
wave micros
+wave micros - high
+wave micros - max
-
WVSP35-
-
wave pulses
+wave pulses - high
+wave pulses - max
-
WVSC36-
-
wave DMA CBs
+wave DMA CBs - high
+wave DMA CBs - max
-
TRIG37-
-
0
-
PROC38-
-
script id
-
PROCD39-
-
0-
PROCR40-
-
script status
-
PROCS41-
-
0-
SLRO42-
-
0
-
SLR43-
-
X
uint8_t data[X]
SLRC44-
-
0-
PROCP45-
-
44uint32_t script_status
+uint32_t pars[10]
MICS46-
-
0-
MILS47-
-
0-
PARSE48-
-
N/A
-
WVCRE49-
-
wave id
-
WVDEL50-
-
0-
WVTX51-
-
wave DMA CBs
-
WVTXR52-
-
wave DMA CBs
-
WVNEW53-
-
0-
I2CO54-
-
handle-
I2CC55-
-
0-
I2CRD56-
-
X
uint8_t data[X]
I2CWD57-
-
0
-
I2CWQ58-
-
0-
I2CRS59-
-
byte value
-
I2CWS60-
-
0-
I2CRB61-
-
byte value
-
I2CWB62-
-
0
-
I2CRW63-
-
word value
-
I2CWW64-
-
0
-
I2CRK65-
-
0-
I2CWK66-
-
0
-
I2CRI67-
-
X
uint8_t data[X]
I2CWI68-
-
0
-
I2CPC69-
-
word value
-
I2CPK70-
-
X
uint8_t data[X]
SPIO
71-
-
handle
-
SPIC72-
-
0-
SPIR73-
-
X
uint8_t data[X]
SPIW74-
-
0
-
SPIX75-
-
Xuint8_t data[X]
SERO76-
-
handle
-
SERC77-
-
0-
SERRB78-
-
byte value
-
SERWB79-
-
0-
SERR80-
-
X
uint8_t data[X]
SERW81-
-
0
-
SERDA82-
-
data ready count
-
GDC
83
-
-
dutycycle
-
GPW
84
-
-
pulsewidth
-
HC
85
-
-
0
-
HP
86
-
-
0
-
CF1
87
-
-
value
-
CF2
88
-
-
X
uint8_t retBuf[X]
BI2CC
89
-
-
0
-
BI2CO
90
-
-
handle
-
BI2CZ
91
-
-
X
uint8_t data[X]
I2CZ
92
-
-
X
uint8_t data[X]
WVCHA
93
-
-
0
-
SLRI
94
-
-
0
-
CGI
95
-
-
config
-
CSI
96
-
-
0
-
FG
97
-
-
0
-
FN
98
-
-
0
-
NOIB99-
-
0-
WVTXM
100
-
-
wave DMA CBs
-
WVTAT
101
-
-
wave id
-
PADS
102
-
-
0
-
PADG
103
-
-
strength
-
FO
104
-
-
handle
-
FC
105
-
-
0
-
FR
106
-
-
X
uint8_t data[X]
FW
107
-
-
0
-
FS
108
-
-
position
-
FL
109
-
-
X
uint8_t filenames[X]
SHELL
110
-
-
exit status
-
BSPIC
111
-
-
0
-
BSPIO
112
-
-
0
-
BSPIX
113
-
-
X
uint8_t data[X]
BSCX
114
-
-
X+4
uint32_t status
+uint8_t data[X]
EVM
115
-
-
0
-
EVT
116
-
-
0
-
PROCU
117
-
-
0
-
+
 +

cmdCmd_t

+typedef struct
+{
+   uint32_t cmd;
+   uint32_t p1;
+   uint32_t p2;
+   union
+   {
+      uint32_t p3;
+      uint32_t ext_len;
+      uint32_t res;
+   };
+} cmdCmd_t;

+ + diff --git a/pigpio-master/EXAMPLES/C/COUNTER_1/README b/pigpio-master/EXAMPLES/C/COUNTER_1/README new file mode 100644 index 0000000..5eec110 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/COUNTER_1/README @@ -0,0 +1,3 @@ +A program showing how to use the gpioSetAlertFunc function to set a callback for gpio state changes. + +A frequency count is generated for each monitored gpio (frequencies up to 500KHz and beyond). diff --git a/pigpio-master/EXAMPLES/C/COUNTER_1/freq_count_1.c b/pigpio-master/EXAMPLES/C/COUNTER_1/freq_count_1.c new file mode 100644 index 0000000..31b5d38 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/COUNTER_1/freq_count_1.c @@ -0,0 +1,238 @@ +#include +#include +#include +#include + +#include + +/* +2014-08-20 + +gcc -o freq_count_1 freq_count_1.c -lpigpio -lpthread +$ sudo ./freq_count_1 4 7 8 + +This program uses the gpioSetAlertFunc function to request +a callback (the same one) for each gpio to be monitored. + +EXAMPLES + +Monitor gpio 4 (default settings) +sudo ./freq_count_1 4 + +Monitor gpios 4 and 8 (default settings) +sudo ./freq_count_1 4 8 + +Monitor gpios 4 and 8, sample rate 2 microseconds +sudo ./freq_count_1 4 8 -s2 + +Monitor gpios 7 and 8, sample rate 4 microseconds, report every second +sudo ./freq_count_1 7 8 -s4 -r10 + +Monitor gpios 4,7, 8, 9, 10, 23 24, report five times a second +sudo ./freq_count_1 4 7 8 9 10 23 24 -r2 + +Monitor gpios 4, 7, 8, and 9, report once a second, sample rate 1us, +generate 2us edges (4us square wave, 250000 highs per second). +sudo ./freq_count_1 4 7 8 9 -r 10 -s 1 -p 2 +*/ + +#define MAX_GPIOS 32 + +#define OPT_P_MIN 1 +#define OPT_P_MAX 1000 +#define OPT_P_DEF 20 + +#define OPT_R_MIN 1 +#define OPT_R_MAX 10 +#define OPT_R_DEF 5 + +#define OPT_S_MIN 1 +#define OPT_S_MAX 10 +#define OPT_S_DEF 5 + +static volatile int g_pulse_count[MAX_GPIOS]; +static volatile int g_reset_counts; +static uint32_t g_mask; + +static int g_num_gpios; +static int g_gpio[MAX_GPIOS]; + +static int g_opt_p = OPT_P_DEF; +static int g_opt_r = OPT_R_DEF; +static int g_opt_s = OPT_S_DEF; +static int g_opt_t = 0; + +void usage() +{ + fprintf + (stderr, + "\n" \ + "Usage: sudo ./freq_count_1 gpio ... [OPTION] ...\n" \ + " -p value, sets pulses every p micros, %d-%d, TESTING only\n" \ + " -r value, sets refresh period in deciseconds, %d-%d, default %d\n" \ + " -s value, sets sampling rate in micros, %d-%d, default %d\n" \ + "\nEXAMPLE\n" \ + "sudo ./freq_count_1 4 7 -r2 -s2\n" \ + "Monitor gpios 4 and 7. Refresh every 0.2 seconds. Sample rate 2 micros.\n" \ + "\n", + OPT_P_MIN, OPT_P_MAX, + OPT_R_MIN, OPT_R_MAX, OPT_R_DEF, + OPT_S_MIN, OPT_S_MAX, OPT_S_DEF + ); +} + +void fatal(int show_usage, char *fmt, ...) +{ + char buf[128]; + va_list ap; + + va_start(ap, fmt); + vsnprintf(buf, sizeof(buf), fmt, ap); + va_end(ap); + + fprintf(stderr, "%s\n", buf); + + if (show_usage) usage(); + + fflush(stderr); + + exit(EXIT_FAILURE); +} + +static int initOpts(int argc, char *argv[]) +{ + int i, opt; + + while ((opt = getopt(argc, argv, "p:r:s:")) != -1) + { + i = -1; + + switch (opt) + { + case 'p': + i = atoi(optarg); + if ((i >= OPT_P_MIN) && (i <= OPT_P_MAX)) + g_opt_p = i; + else fatal(1, "invalid -p option (%d)", i); + g_opt_t = 1; + break; + + case 'r': + i = atoi(optarg); + if ((i >= OPT_R_MIN) && (i <= OPT_R_MAX)) + g_opt_r = i; + else fatal(1, "invalid -r option (%d)", i); + break; + + case 's': + i = atoi(optarg); + if ((i >= OPT_S_MIN) && (i <= OPT_S_MAX)) + g_opt_s = i; + else fatal(1, "invalid -s option (%d)", i); + break; + + default: /* '?' */ + usage(); + exit(-1); + } + } + return optind; +} + +void edges(int gpio, int level, uint32_t tick) +{ + int g; + + if (g_reset_counts) + { + g_reset_counts = 0; + for (g=0; g=0) && (g<32)) + { + g_gpio[g_num_gpios++] = g; + g_mask |= (1< +#include +#include +#include + +#include + +/* +2014-08-20 + +gcc -o freq_count_2 freq_count_2.c -lpigpio -lpthread +$ sudo ./freq_count_2 4 7 8 + +This program uses the gpioSetGetSamplesFunc function to request +a callback once a millisecond for all accumulated gpio changes +in that millisecond. + +This tends to be more efficient then calling a callback for each +gpio change during the millisecond. + +EXAMPLES + +Monitor gpio 4 (default settings) +sudo ./freq_count_2 4 + +Monitor gpios 4 and 8 (default settings) +sudo ./freq_count_2 4 8 + +Monitor gpios 4 and 8, sample rate 2 microseconds +sudo ./freq_count_2 4 8 -s2 + +Monitor gpios 7 and 8, sample rate 4 microseconds, report every second +sudo ./freq_count_2 7 8 -s4 -r10 + +Monitor gpios 4,7, 8, 9, 10, 23 24, report five times a second +sudo ./freq_count_2 4 7 8 9 10 23 24 -r2 + +Monitor gpios 4, 7, 8, and 9, report once a second, sample rate 1us, +generate 2us edges (4us square wave, 250000 highs per second). +sudo ./freq_count_2 4 7 8 9 -r 10 -s 1 -p 2 + +*/ + +#define MAX_GPIOS 32 + +#define OPT_P_MIN 1 +#define OPT_P_MAX 1000 +#define OPT_P_DEF 20 + +#define OPT_R_MIN 1 +#define OPT_R_MAX 10 +#define OPT_R_DEF 5 + +#define OPT_S_MIN 1 +#define OPT_S_MAX 10 +#define OPT_S_DEF 5 + +static volatile int g_pulse_count[MAX_GPIOS]; +static volatile int g_reset_counts; +static uint32_t g_mask; + +static int g_num_gpios; +static int g_gpio[MAX_GPIOS]; + +static int g_opt_p = OPT_P_DEF; +static int g_opt_r = OPT_R_DEF; +static int g_opt_s = OPT_S_DEF; +static int g_opt_t = 0; + +void usage() +{ + fprintf + (stderr, + "\n" \ + "Usage: sudo ./freq_count_2 gpio ... [OPTION] ...\n" \ + " -p value, sets pulses every p micros, %d-%d, TESTING only\n" \ + " -r value, sets refresh period in deciseconds, %d-%d, default %d\n" \ + " -s value, sets sampling rate in micros, %d-%d, default %d\n" \ + "\nEXAMPLE\n" \ + "sudo ./freq_count_2 4 7 -r2 -s2\n" \ + "Monitor gpios 4 and 7. Refresh every 0.2 seconds. Sample rate 2 micros.\n" \ + "\n", + OPT_P_MIN, OPT_P_MAX, + OPT_R_MIN, OPT_R_MAX, OPT_R_DEF, + OPT_S_MIN, OPT_S_MAX, OPT_S_DEF + ); +} + +void fatal(int show_usage, char *fmt, ...) +{ + char buf[128]; + va_list ap; + + va_start(ap, fmt); + vsnprintf(buf, sizeof(buf), fmt, ap); + va_end(ap); + + fprintf(stderr, "%s\n", buf); + + if (show_usage) usage(); + + fflush(stderr); + + exit(EXIT_FAILURE); +} + +static int initOpts(int argc, char *argv[]) +{ + int i, opt; + + while ((opt = getopt(argc, argv, "p:r:s:")) != -1) + { + i = -1; + + switch (opt) + { + case 'p': + i = atoi(optarg); + if ((i >= OPT_P_MIN) && (i <= OPT_P_MAX)) + g_opt_p = i; + else fatal(1, "invalid -p option (%d)", i); + g_opt_t = 1; + break; + + case 'r': + i = atoi(optarg); + if ((i >= OPT_R_MIN) && (i <= OPT_R_MAX)) + g_opt_r = i; + else fatal(1, "invalid -r option (%d)", i); + break; + + case 's': + i = atoi(optarg); + if ((i >= OPT_S_MIN) && (i <= OPT_S_MAX)) + g_opt_s = i; + else fatal(1, "invalid -s option (%d)", i); + break; + + default: /* '?' */ + usage(); + exit(-1); + } + } + return optind; +} + +void samples(const gpioSample_t *samples, int numSamples) +{ + static uint32_t state = 0; + uint32_t high, level; + int g, s; + + if (g_reset_counts) + { + g_reset_counts = 0; + for (g=0; g=0) && (g<32)) + { + g_gpio[g_num_gpios++] = g; + g_mask |= (1< + +#include + +/* +OH3144E or equivalent Hall effect sensor + +Pin 1 - 5V +Pin 2 - Ground +Pin 3 - gpio (here P1-8, gpio 14, TXD is used) + +The internal gpio pull-up is enabled so that the sensor +normally reads high. It reads low when a magnet is close. + +gcc -o hall hall.c -lpigpio -lrt -lpthread +sudo ./hall +*/ + +#define HALL 14 + +void alert(int gpio, int level, uint32_t tick) +{ + static uint32_t lastTick=0; + + if (lastTick) printf("%d %.2f\n", level, (float)(tick-lastTick)/1000000.0); + else printf("%d 0.00\n", level); + + lastTick = tick; +} + +int main(int argc, char *argv[]) +{ + int secs=60; + + if (argc>1) secs = atoi(argv[1]); /* program run seconds */ + + if ((secs<1) || (secs>3600)) secs = 3600; + + if (gpioInitialise()<0) return 1; + + gpioSetMode(HALL, PI_INPUT); + + gpioSetPullUpDown(HALL, PI_PUD_UP); + + gpioSetAlertFunc(HALL, alert); + + sleep(secs); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/C/I2C_SNIFFER/README b/pigpio-master/EXAMPLES/C/I2C_SNIFFER/README new file mode 100644 index 0000000..23b5594 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/I2C_SNIFFER/README @@ -0,0 +1,4 @@ +A program to passively sniff I2C transactions (100kHz bus maximum) and display the results. + +This C program uses pigpio notifications. + diff --git a/pigpio-master/EXAMPLES/C/I2C_SNIFFER/pig2i2c.c b/pigpio-master/EXAMPLES/C/I2C_SNIFFER/pig2i2c.c new file mode 100644 index 0000000..bf9102c --- /dev/null +++ b/pigpio-master/EXAMPLES/C/I2C_SNIFFER/pig2i2c.c @@ -0,0 +1,205 @@ +/* +*/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" + +/* +This software reads pigpio notification reports monitoring the I2C signals. + +Notifications are pipe based so this software must be run on the Pi +being monitored. + +It should be able to handle a 100kHz bus. You are unlikely to get any +usable results if the bus is running at 400kHz. + +gcc -o pig2i2c pig2i2c.c + +Do something like + +sudo pigpiod -s 2 + +# get a notification handle, assume handle 0 was returned + +pigs no + +# start notifications for SCL/SDA + +e.g. pigs nb 0 0x3 # Rev. 1 select gpios 0/1 +e.g. pigs nb 0 0xC # Rev. 2 select gpios 2/3 +e.g. pigs nb 0 0xA00 # select gpios 9/11 (1<<9|1<<11) + +# run the program, specifying SCL/SDA and notification pipe + +./pig2i2c SCL SDA 2) + { + gSCL = atoi(argv[1]); + gSDA = atoi(argv[2]); + + bSCL = 1< + +#include + +#include "ir_hasher.h" + +/* +This code forms a hash over the IR pulses generated by an +IR remote. + +The remote key press is not converted into a code in the manner of +the lirc module. No attempt is made to decode the type of protocol +used by the remote. The hash is likely to be unique for different +keys and different remotes but this is not guaranteed. + +This hashing process works for some remotes/protocols but not for +others. The only way to find out if it works for one or more of +your remotes is to try it and see. +*/ + +struct _Pi_Hasher_s +{ + int gpio; + Pi_Hasher_CB_t callback; + int timeout; + int in_code; + uint32_t hash_val; + int edges; + int t1; + int t2; + int t3; + int t4; +}; + + +static uint32_t _hash(uint32_t hv, int old_val, int new_val) +{ + int val; + + if (new_val < (old_val * 0.60)) val = 13; + else if (old_val < (new_val * 0.60)) val = 23; + else val = 2; + + hv ^= val; + hv *= 16777619; /* FNV_PRIME_32 */ + + return hv; +} + +static void _cb(int gpio, int level, uint32_t tick, void *user) +{ + Pi_Hasher_t * hasher; + + hasher = user; + + if (level != PI_TIMEOUT) + { + if (hasher->in_code == 0) + { + hasher->in_code = 1; + + gpioSetWatchdog(gpio, hasher->timeout); + + hasher->hash_val = 2166136261U; /* FNV_BASIS_32 */ + + hasher->edges = 1; + + hasher->t1 = 0; + hasher->t2 = 0; + hasher->t3 = 0; + hasher->t4 = tick; + } + else + { + hasher->edges++; + + hasher->t1 = hasher->t2; + hasher->t2 = hasher->t3; + hasher->t3 = hasher->t4; + hasher->t4 = tick; + + if (hasher->edges > 3) + { + hasher->hash_val = + _hash(hasher->hash_val, + (hasher->t2)-(hasher->t1), + (hasher->t4)-(hasher->t3)); + } + } + } + else + { + if (hasher->in_code) + { + hasher->in_code = 0; + + gpioSetWatchdog(gpio, 0); + + if (hasher->edges > 12) /* Anything less is probably noise. */ + { + (hasher->callback)(hasher->hash_val); + } + } + } +} + +Pi_Hasher_t *Pi_Hasher(int gpio, Pi_Hasher_CB_t callback, int timeout) +{ + Pi_Hasher_t *hasher; + + hasher = malloc(sizeof(Pi_Hasher_t)); + + hasher->gpio = gpio; + hasher->callback = callback; + hasher->timeout = 5; + + hasher->in_code = 0; + + gpioSetMode(gpio, PI_INPUT); + gpioSetAlertFuncEx(gpio, _cb, hasher); + + return hasher; +} + +void Pi_Hasher_cancel(Pi_Hasher_t *hasher) +{ + if (hasher) + { + gpioSetAlertFunc(hasher->gpio, 0); + + free(hasher); + + hasher = NULL; + } +} + diff --git a/pigpio-master/EXAMPLES/C/IR_RECEIVER/ir_hasher.h b/pigpio-master/EXAMPLES/C/IR_RECEIVER/ir_hasher.h new file mode 100644 index 0000000..ef2278f --- /dev/null +++ b/pigpio-master/EXAMPLES/C/IR_RECEIVER/ir_hasher.h @@ -0,0 +1,33 @@ +#ifndef IR_HASHER_H +#define IR_HASHER_H + +#include + +typedef void (*Pi_Hasher_CB_t)(uint32_t); + +struct _Pi_Hasher_s; + +typedef struct _Pi_Hasher_s Pi_Hasher_t; + +Pi_Hasher_t * Pi_Hasher(int gpio, Pi_Hasher_CB_t callback, int timeout); + /* + This function establishes an IR hasher on the gpio. + + A gap of timeout milliseconds without a new bit indicates + the end of a code. + + When code end is detected the callback function is called + with the code hash. + + A pointer to a private data type is returned. This should be passed + to Pi_Hasher_cancel if the hasher is to be cancelled. + */ + + +void Pi_Hasher_cancel(Pi_Hasher_t *hasher); + /* + This function releases the resources used by the hasher. + */ + + +#endif diff --git a/pigpio-master/EXAMPLES/C/IR_RECEIVER/test_ir_hasher.c b/pigpio-master/EXAMPLES/C/IR_RECEIVER/test_ir_hasher.c new file mode 100644 index 0000000..28673b7 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/IR_RECEIVER/test_ir_hasher.c @@ -0,0 +1,47 @@ +#include + +#include + +#include "ir_hasher.h" + +/* + +REQUIRES + +An IR receiver output pin connected to a Pi gpio. + +TO BUILD + +gcc -o ir_hash_c test_ir_hasher.c ir_hasher.c -lpigpio -lrt -lpthread + +TO RUN + +sudo ./ir_hash_c + +*/ + +void callback(uint32_t hash) +{ + printf("hash=%u\n", hash); +} + +int main(int argc, char *argv[]) +{ + Pi_Hasher_t *hasher; + + if (gpioInitialise() < 0) return 1; + + /* + This assumes the output pin of an IR receiver is + connected to gpio 7. + */ + + hasher = Pi_Hasher(7, callback, 5); + + sleep(300); + + Pi_Hasher_cancel(hasher); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/C/PCF8591_YL-40/PCF8591.c b/pigpio-master/EXAMPLES/C/PCF8591_YL-40/PCF8591.c new file mode 100644 index 0000000..5d9e185 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/PCF8591_YL-40/PCF8591.c @@ -0,0 +1,131 @@ +#include +#include +#include +#include +#include +#include /* libncurses5-dev */ + +/* +2014-08-26 PCF8591.c + +sudo apt-get install libncurses5-dev + +gcc -o PCF8591 PCF8591.c -lcurses -lpigpio -lpthread + +sudo ./PCF8591 +*/ + +/* +Connect Pi 3V3 - VCC, Ground - Ground, SDA - SDA, SCL - SCL. +*/ + +#define PCF8591_I2C_ADDR 0x48 + +/* + P4 The thermister voltage is provided at AIN 1. + P5 The photocell voltage is provided at AIN 0. + P6 The single turn 10K ohm trim pot voltage is provided at AIN 3. +*/ + +/* +7 6 5 4 3 2 1 0 +0 X X X 0 X X X + | | | | | | + A B B C D D + +0 1 0 0 0 1 0 0 + +A 0 D/A inactive + 1 D/A active + +B 00 single ended inputs + 01 differential inputs + 10 single ended and differential + 11 two differential inputs + +C 0 no auto inc + 1 auto inc + +D 00 select channel 0 + 01 select channel 1 + 10 select channel 2 + 11 select channel 3 + +*/ + +int main(int argc, char *argv[]) +{ + int i; + int r; + int handle; + char aout; + unsigned char command[2]; + unsigned char value[4]; + unsigned char str[8]; + + int j; + int key; + + if (gpioInitialise() < 0) return 1; + + initscr(); + noecho(); + cbreak(); + nodelay(stdscr, true); + curs_set(0); + + printw("PCF8591 + or - to change aout, any other key to quit."); + + mvaddstr(10, 0, "Brightness"); + mvaddstr(12, 0, "Temperature"); + mvaddstr(14, 0, "?"); + mvaddstr(16, 0, "Resistor"); + + refresh(); + + handle = i2cOpen(1, PCF8591_I2C_ADDR, 0); + + command[1] = 0; + aout = 128; + + while (1) + { + for (i=0; i<4; i++) + { + command[1] = aout; + command[0] = 0x40 | ((i + 1) & 0x03); // output enable | read input i + + i2cWriteDevice(handle, &command, 2); + + usleep(20000); + + // the read is always one step behind the selected input + value[i] = i2cReadByte(handle); + + sprintf(str, "%3d", value[i]); + mvaddstr(10+i+i, 12, str); + value[i] = value[i] / 4; + move(10 + i + i, 16); + + for(j = 0; j < 64; j++) + if(j < value[i]) addch('*'); else addch(' '); + } + + refresh(); + + key = getch(); + + if ((key == '+') || (key == '=')) aout++; + else if ((key == '-') || (key == '_')) aout--; + else if (key != -1) break; + } + + endwin(); + + i2cClose(handle); + + gpioTerminate(); + + return (0); +} + diff --git a/pigpio-master/EXAMPLES/C/PCF8591_YL-40/README b/pigpio-master/EXAMPLES/C/PCF8591_YL-40/README new file mode 100644 index 0000000..40428b1 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/PCF8591_YL-40/README @@ -0,0 +1 @@ +A program to display readings from the (I2C) PCF8591. diff --git a/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/README b/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/README new file mode 100644 index 0000000..530685c --- /dev/null +++ b/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/README @@ -0,0 +1,3 @@ +Function to time capacitor charging (through a resistance). + +The time can be used to estimate the resistance. diff --git a/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/pot_cap_charge.c b/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/pot_cap_charge.c new file mode 100644 index 0000000..811e3f7 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/POT_CAP_RECHARGE/pot_cap_charge.c @@ -0,0 +1,94 @@ +#include + +#include + +/* + Measure how long a capacitor takes to charge through a resistance. + + A potentimeter is used to vary the resistance. + + The time taken will be proportional to the resistance. + + 3V3 ----- Potentiometer --+-- Capacitor ----- Ground + | + +-- gpio + + + gcc -o pot_cap_charge pot_cap_charge.c -lpigpio -lpthread -lrt + sudo ./pot_cap_charge + +*/ + +#define GPIO 25 + +#define MAX_READING 1000 + +static uint32_t rechargeTick = 0; + +void callback(int gpio, int level, uint32_t tick) +{ + static uint32_t smooth = 0; + static int reading = 0; + + uint32_t raw; + + if (level == 1) /* measure recharge time */ + { + ++reading; + + if (rechargeTick) + { + raw = tick - rechargeTick; /* set in main */ + + if (raw < MAX_READING) /* ignore outliers */ + { + /* smooth using 0.8 * smooth + 0.2 * raw */ + + smooth = (raw + (4 * smooth)) / 5; + + printf("%d %d %d\n", reading, raw, smooth); + } + else + { + /* ignore outlier, set dot at fixed position */ + printf("%d %d %d\n", reading, 40, smooth); + } + } + else + { + /* ignore reschedule, set dot at fixed position */ + printf("%d %d %d\n", reading, 20, smooth); + } + } +} + +int main (int argc, char *argv[]) +{ + uint32_t t1, t2; + int tDiff; + + if (gpioInitialise()<0) return 1; + + gpioSetAlertFunc(GPIO, callback); /* callback when GPIO changes state */ + + while (1) + { + gpioWrite(GPIO, PI_OFF); /* drain capacitor */ + + gpioDelay(200); /* microseconds */ + + t1 = gpioTick(); + + gpioSetMode(GPIO, PI_INPUT); /* start capacitor recharge */ + + t2 = gpioTick(); + + /* dump reading if rechargeTick not accurate to 3 micros */ + + if ((t2 - t1) < 3) rechargeTick = t1; else rechargeTick = 0; + + gpioDelay(5000); /* microseconds, nominal 200 readings per second */ + } + + gpioTerminate(); +} diff --git a/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/README b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/README new file mode 100644 index 0000000..d07037e --- /dev/null +++ b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/README @@ -0,0 +1,4 @@ +Function to decode a mechanical rotary encoder. + +Follow the instructions in the test file to build and run. + diff --git a/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.c b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.c new file mode 100644 index 0000000..5bccba7 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.c @@ -0,0 +1,94 @@ +#include +#include + +#include + +#include "rotary_encoder.h" + +struct _Pi_Renc_s +{ + int gpioA; + int gpioB; + Pi_Renc_CB_t callback; + int levA; + int levB; + int lastGpio; +}; + +/* + + +---------+ +---------+ 0 + | | | | + A | | | | + | | | | + +---------+ +---------+ +----- 1 + + +---------+ +---------+ 0 + | | | | + B | | | | + | | | | + ----+ +---------+ +---------+ 1 + +*/ + +static void _cb(int gpio, int level, uint32_t tick, void *user) +{ + Pi_Renc_t *renc; + + renc = user; + + if (gpio == renc->gpioA) renc->levA = level; else renc->levB = level; + + if (gpio != renc->lastGpio) /* debounce */ + { + renc->lastGpio = gpio; + + if ((gpio == renc->gpioA) && (level == 1)) + { + if (renc->levB) (renc->callback)(1); + } + else if ((gpio == renc->gpioB) && (level == 1)) + { + if (renc->levA) (renc->callback)(-1); + } + } +} + +Pi_Renc_t * Pi_Renc(int gpioA, int gpioB, Pi_Renc_CB_t callback) +{ + Pi_Renc_t *renc; + + renc = malloc(sizeof(Pi_Renc_t)); + + renc->gpioA = gpioA; + renc->gpioB = gpioB; + renc->callback = callback; + renc->levA=0; + renc->levB=0; + renc->lastGpio = -1; + + gpioSetMode(gpioA, PI_INPUT); + gpioSetMode(gpioB, PI_INPUT); + + /* pull up is needed as encoder common is grounded */ + + gpioSetPullUpDown(gpioA, PI_PUD_UP); + gpioSetPullUpDown(gpioB, PI_PUD_UP); + + /* monitor encoder level changes */ + + gpioSetAlertFuncEx(gpioA, _cb, renc); + gpioSetAlertFuncEx(gpioB, _cb, renc); +} + +void Pi_Renc_cancel(Pi_Renc_t *renc) +{ + if (renc) + { + gpioSetAlertFunc(renc->gpioA, 0); + gpioSetAlertFunc(renc->gpioB, 0); + + free(renc); + } +} + diff --git a/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.h b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.h new file mode 100644 index 0000000..73f7454 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/rotary_encoder.h @@ -0,0 +1,25 @@ +#ifndef ROTARY_ENCODER_H +#define ROTARY_ENCODER_H + +typedef void (*Pi_Renc_CB_t)(int); + +struct _Pi_Renc_s; + +typedef struct _Pi_Renc_s Pi_Renc_t; + +Pi_Renc_t * Pi_Renc(int gpioA, int gpioB, Pi_Renc_CB_t callback); +/* + This function establishes a rotary encoder on gpioA and gpioB. + + When the encoder is turned the callback function is called. + + A pointer to a private data type is returned. This should be passed + to Pi_Renc_cancel if the rotary encoder is to be cancelled. +*/ + +void Pi_Renc_cancel(Pi_Renc_t *renc); +/* + This function releases the resources used by the decoder. +*/ + +#endif diff --git a/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/test_rotary_encoder.c b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/test_rotary_encoder.c new file mode 100644 index 0000000..9f512e0 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/ROTARY_ENCODER/test_rotary_encoder.c @@ -0,0 +1,47 @@ +#include + +#include + +#include "rotary_encoder.h" + +/* + +REQUIRES + +A rotary encoder contacts A and B connected to separate gpios and +the common contact connected to Pi ground. + +TO BUILD + +gcc -o rot_enc_c test_rotary_encoder.c rotary_encoder.c -lpigpio -lrt + +TO RUN + +sudo ./rot_enc_c + +*/ + +void callback(int way) +{ + static int pos = 0; + + pos += way; + + printf("pos=%d\n", pos); +} + +int main(int argc, char *argv[]) +{ + Pi_Renc_t * renc; + + if (gpioInitialise() < 0) return 1; + + renc = Pi_Renc(7, 8, callback); + + sleep(300); + + Pi_Renc_cancel(renc); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/C/WIEGAND_CODE/README b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/README new file mode 100644 index 0000000..38d5acb --- /dev/null +++ b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/README @@ -0,0 +1,4 @@ +Function to decode a Wiegand code. + +Follow the instructions in the test file to build and run. + diff --git a/pigpio-master/EXAMPLES/C/WIEGAND_CODE/test_wiegand.c b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/test_wiegand.c new file mode 100644 index 0000000..8aef6d6 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/test_wiegand.c @@ -0,0 +1,42 @@ +#include + +#include + +#include "wiegand.h" + +/* + +REQUIRES + +Wiegand contacts 0 and 1 connected to separate gpios. + +TO BUILD + +gcc -o wiegand_c test_wiegand.c wiegand.c -lpigpio -lrt + +TO RUN + +sudo ./wiegand_c + +*/ + +void callback(int bits, uint32_t value) +{ + printf("bits=%d value=%u\n", bits, value); +} + +int main(int argc, char *argv[]) +{ + Pi_Wieg_t * w; + + if (gpioInitialise() < 0) return 1; + + w = Pi_Wieg(14, 15, callback, 5); + + sleep(300); + + Pi_Wieg_cancel(w); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.c b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.c new file mode 100644 index 0000000..5bfecd7 --- /dev/null +++ b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.c @@ -0,0 +1,137 @@ +#include + +#include + +#include "wiegand.h" + +struct _Pi_Wieg_s +{ + int mygpio_0; + int mygpio_1; + int mytimeout; + int in_code; + int bits; + Pi_Wieg_CB_t mycallback; + uint32_t num; + uint32_t code_timeout; +}; + +void _cb(int gpio, int level, uint32_t tick, void *user) +{ + /* + Accumulate bits until both gpios 0 and 1 timeout. + */ + + Pi_Wieg_t *wieg; + + wieg = user; + + if (level == 0) /* a falling edge indicates a new bit */ + { + if (!wieg->in_code) + { + wieg->bits = 1; + wieg->num = 0; + + wieg->in_code = 1; + wieg->code_timeout = 0; + + gpioSetWatchdog(wieg->mygpio_0, wieg->mytimeout); + gpioSetWatchdog(wieg->mygpio_1, wieg->mytimeout); + } + else + { + wieg->bits++; + wieg->num <<= 1; + } + + if (gpio == wieg->mygpio_0) + { + wieg->code_timeout &= 2; /* clear gpio 0 timeout */ + } + else + { + wieg->code_timeout &= 1; /* clear gpio 1 timeout */ + wieg->num |= 1; + } + } + else if (level == PI_TIMEOUT) + { + if (wieg->in_code) + { + if (gpio == wieg->mygpio_0) + { + wieg->code_timeout |= 1; /* timeout gpio 0 */ + } + else + { + wieg->code_timeout |= 2; /* timeout gpio 1 */ + } + + if (wieg->code_timeout == 3) /* both gpios timed out */ + { + gpioSetWatchdog(wieg->mygpio_0, 0); + gpioSetWatchdog(wieg->mygpio_1, 0); + + wieg->in_code = 0; + + (wieg->mycallback)(wieg->bits, wieg->num); + } + } + } +} + +Pi_Wieg_t * Pi_Wieg( + int gpio_0, + int gpio_1, + Pi_Wieg_CB_t callback, + int timeout) +{ + /* + Instantiate with the gpio for 0 (green wire), the gpio for 1 + (white wire), the callback function, and the timeout in + milliseconds which indicates the end of a code. + + The callback is passed the code length in bits and the value. + */ + + Pi_Wieg_t *wieg; + + wieg = malloc(sizeof(Pi_Wieg_t)); + + wieg->mygpio_0 = gpio_0; + wieg->mygpio_1 = gpio_1; + + wieg->mycallback = callback; + + wieg->mytimeout = timeout; + + wieg->in_code = 0; + + gpioSetMode(gpio_0, PI_INPUT); + gpioSetMode(gpio_1, PI_INPUT); + + gpioSetPullUpDown(gpio_0, PI_PUD_UP); + gpioSetPullUpDown(gpio_1, PI_PUD_UP); + + gpioSetAlertFuncEx(gpio_0, _cb, wieg); + gpioSetAlertFuncEx(gpio_1, _cb, wieg); + + return wieg; +} + +void Pi_Wieg_cancel(Pi_Wieg_t *wieg) +{ + /* + Cancel the Wiegand decoder. + */ + + if (wieg) + { + gpioSetAlertFunc(wieg->mygpio_0, 0); + gpioSetAlertFunc(wieg->mygpio_1, 0); + + free(wieg); + } +} + diff --git a/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.h b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.h new file mode 100644 index 0000000..8deaa3a --- /dev/null +++ b/pigpio-master/EXAMPLES/C/WIEGAND_CODE/wiegand.h @@ -0,0 +1,32 @@ +#ifndef WIEGAND_H +#define WIEGAND_H + +#include + +typedef void (*Pi_Wieg_CB_t)(int, uint32_t); + +struct _Pi_Wieg_s; + +typedef struct _Pi_Wieg_s Pi_Wieg_t; + +Pi_Wieg_t *Pi_Wieg(int gpio_0, int gpio_1, Pi_Wieg_CB_t callback, int timeout); + /* + This function establishes a Wiegand decoder on gpio_0 and gpio_1. + + A gap of timeout milliseconds without a new bit indicates the + end of a code. + + When the code is ended the callback function is called with the code + bit length and value. + + A pointer to a private data type is returned. This should be passed + to Pi_Wieg_cancel if the decoder is to be cancelled. + */ + +void Pi_Wieg_cancel(Pi_Wieg_t *wieg); + /* + This function releases the resources used by the decoder. + */ + +#endif + diff --git a/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/README b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/README new file mode 100644 index 0000000..ccb0165 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/README @@ -0,0 +1,4 @@ +Class to hash a code from an IR receiver (reading an IR remote control). + +Follow the instructions in the test file to build and run. + diff --git a/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.cpp b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.cpp new file mode 100644 index 0000000..d2d01fd --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.cpp @@ -0,0 +1,91 @@ +#include + +#include "ir_hasher.hpp" + +void Hasher::_hash(int old_val, int new_val) +{ + int val; + + if (new_val < (old_val * 0.60)) val = 13; + else if (old_val < (new_val * 0.60)) val = 23; + else val = 2; + + hash_val ^= val; + hash_val *= 16777619; /* FNV_PRIME_32 */ +} + +void Hasher::_callback(int gpio, int level, uint32_t tick) +{ + if (level != PI_TIMEOUT) + { + if (in_code == 0) + { + in_code = 1; + + gpioSetWatchdog(mygpio, mytimeout); + + hash_val = 2166136261U; /* FNV_BASIS_32 */ + + edges = 1; + + t1 = 0; + t2 = 0; + t3 = 0; + t4 = tick; + } + else + { + edges++; + + t1 = t2; + t2 = t3; + t3 = t4; + t4 = tick; + + if (edges > 3) _hash(t2-t1, t4-t3); + } + } + else + { + if (in_code) + { + in_code = 0; + + gpioSetWatchdog(mygpio, 0); + + if (edges > 12) /* Anything less is probably noise. */ + { + (mycallback)(hash_val); + } + } + } +} + +void Hasher::_callbackExt(int gpio, int level, uint32_t tick, void *user) +{ + /* + Need a static callback to link with C. + */ + + Hasher *mySelf = (Hasher *) user; + + mySelf->_callback(gpio, level, tick); /* Call the instance callback. */ +} + +Hasher::Hasher(int gpio, HasherCB_t callback, int timeout) +{ + /* + Initialises an IR remote hasher on a gpio. A gap of timeout + milliseconds indicates the end of the remote key press. + */ + mygpio = gpio; + mycallback = callback; + mytimeout = timeout; + + in_code = 0; + + gpioSetMode(gpio, PI_INPUT); + + gpioSetAlertFuncEx(gpio, _callbackExt, (void *)this); +} + diff --git a/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.hpp b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.hpp new file mode 100644 index 0000000..2e9322a --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/ir_hasher.hpp @@ -0,0 +1,44 @@ +#ifndef IR_RX_HASHER_HPP +#define IR_RX_HASHER_HPP + +#include + +typedef void (*HasherCB_t)(uint32_t); + +class Hasher +{ + + /* + This class forms a hash over the IR pulses generated by an + IR remote. + + The remote key press is not converted into a code in the manner of + the lirc module. No attempt is made to decode the type of protocol + used by the remote. The hash is likely to be unique for different + keys and different remotes but this is not guaranteed. + + This hashing process works for some remotes/protocols but not for + others. The only way to find out if it works for one or more of + your remotes is to try it and see. + */ + + int mygpio, mytimeout; + HasherCB_t mycallback; + int in_code; + uint32_t hash_val; + int edges; + uint32_t t1, t2, t3, t4; + + void _hash(int old_val, int new_val); + void _callback(int gpio, int level, uint32_t tick); + + /* Need a static callback to link with C. */ + static void _callbackExt(int gpio, int level, uint32_t tick, void *user); + + public: + + Hasher(int gpio, HasherCB_t callback, int timeout=5); +}; + +#endif + diff --git a/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/test_ir_hasher.cpp b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/test_ir_hasher.cpp new file mode 100644 index 0000000..40788cc --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/IR_RECEIVER/test_ir_hasher.cpp @@ -0,0 +1,44 @@ +#include + +#include + +#include "ir_hasher.hpp" + +/* + +REQUIRES + +An IR receiver output pin connected to a Pi gpio. + +TO BUILD + +g++ -o ir_hash_cpp test_ir_hasher.cpp ir_hasher.cpp -lpigpio -lrt -lpthread + +TO RUN + +sudo ./ir_hash_cpp + +*/ + +void callback(uint32_t hash) +{ + std::cout << "hash=" << hash << std::endl; +} + +int main(int argc, char *argv[]) +{ + if (gpioInitialise() >= 0) + { + /* Can't instantiate a Hasher before pigpio is initialised. */ + + /* + This assumes the output pin of an IR receiver is + connected to gpio 7. + */ + + Hasher ir(7, callback); + + sleep(300); + } +} + diff --git a/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/README b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/README new file mode 100644 index 0000000..f9e01cb --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/README @@ -0,0 +1,4 @@ +Class to decode a mechanical rotary encoder. + +Follow the instructions in the test file to build and run. + diff --git a/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.cpp b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.cpp new file mode 100644 index 0000000..f0b6fb7 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.cpp @@ -0,0 +1,84 @@ +#include + +#include + +#include "rotary_encoder.hpp" + +/* + + +---------+ +---------+ 0 + | | | | + A | | | | + | | | | + +---------+ +---------+ +----- 1 + + +---------+ +---------+ 0 + | | | | + B | | | | + | | | | + ----+ +---------+ +---------+ 1 + +*/ + +void re_decoder::_pulse(int gpio, int level, uint32_t tick) +{ + if (gpio == mygpioA) levA = level; else levB = level; + + if (gpio != lastGpio) /* debounce */ + { + lastGpio = gpio; + + if ((gpio == mygpioA) && (level == 1)) + { + if (levB) (mycallback)(1); + } + else if ((gpio == mygpioB) && (level == 1)) + { + if (levA) (mycallback)(-1); + } + } +} + +void re_decoder::_pulseEx(int gpio, int level, uint32_t tick, void *user) +{ + /* + Need a static callback to link with C. + */ + + re_decoder *mySelf = (re_decoder *) user; + + mySelf->_pulse(gpio, level, tick); /* Call the instance callback. */ +} + +re_decoder::re_decoder(int gpioA, int gpioB, re_decoderCB_t callback) +{ + mygpioA = gpioA; + mygpioB = gpioB; + + mycallback = callback; + + levA=0; + levB=0; + + lastGpio = -1; + + gpioSetMode(gpioA, PI_INPUT); + gpioSetMode(gpioB, PI_INPUT); + + /* pull up is needed as encoder common is grounded */ + + gpioSetPullUpDown(gpioA, PI_PUD_UP); + gpioSetPullUpDown(gpioB, PI_PUD_UP); + + /* monitor encoder level changes */ + + gpioSetAlertFuncEx(gpioA, _pulseEx, this); + gpioSetAlertFuncEx(gpioB, _pulseEx, this); +} + +void re_decoder::re_cancel(void) +{ + gpioSetAlertFuncEx(mygpioA, 0, this); + gpioSetAlertFuncEx(mygpioB, 0, this); +} + diff --git a/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.hpp b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.hpp new file mode 100644 index 0000000..e2ef8c0 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/rotary_encoder.hpp @@ -0,0 +1,35 @@ +#ifndef ROTARY_ENCODER_HPP +#define ROTARY_ENCODER_HPP + +#include + +typedef void (*re_decoderCB_t)(int); + +class re_decoder +{ + int mygpioA, mygpioB, levA, levB, lastGpio; + + re_decoderCB_t mycallback; + + void _pulse(int gpio, int level, uint32_t tick); + + /* Need a static callback to link with C. */ + static void _pulseEx(int gpio, int level, uint32_t tick, void *user); + + + public: + + re_decoder(int gpioA, int gpioB, re_decoderCB_t callback); + /* + This function establishes a rotary encoder on gpioA and gpioB. + + When the encoder is turned the callback function is called. + */ + + void re_cancel(void); + /* + This function releases the resources used by the decoder. + */ +}; + +#endif diff --git a/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/test_rotary_encoder.cpp b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/test_rotary_encoder.cpp new file mode 100644 index 0000000..f1d6a59 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/ROTARY_ENCODER/test_rotary_encoder.cpp @@ -0,0 +1,45 @@ +#include + +#include + +#include "rotary_encoder.hpp" + +/* + +REQUIRES + +A rotary encoder contacts A and B connected to separate gpios and +the common contact connected to Pi ground. + +TO BUILD + +g++ -o rot_enc_cpp test_rotary_encoder.cpp rotary_encoder.cpp -lpigpio -lrt + +TO RUN + +sudo ./rot_enc_cpp + +*/ + +void callback(int way) +{ + static int pos = 0; + + pos += way; + + std::cout << "pos=" << pos << std::endl; +} + +int main(int argc, char *argv[]) +{ + if (gpioInitialise() < 0) return 1; + + re_decoder dec(7, 8, callback); + + sleep(3000); + + dec.re_cancel(); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/README b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/README new file mode 100644 index 0000000..28079b4 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/README @@ -0,0 +1,3 @@ +Class to decode a Wiegand code. + +Follow the instructions in the test file to build and run. diff --git a/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/test_wiegand.cpp b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/test_wiegand.cpp new file mode 100644 index 0000000..ca225a4 --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/test_wiegand.cpp @@ -0,0 +1,40 @@ +#include + +#include + +#include "wiegand.hpp" + +/* + +REQUIRES + +Wiegand contacts 0 and 1 connected to separate gpios. + +TO BUILD + +g++ -o wiegand_cpp test_wiegand.cpp wiegand.cpp -lpigpio -lrt + +TO RUN + +sudo ./wiegand_cpp + +*/ + +void callback(int bits, uint32_t value) +{ + std::cout << "bits=" << bits << " value=" << value << std::endl; +} + +int main(int argc, char *argv[]) +{ + if (gpioInitialise() < 0) return 1; + + Wiegand dec(14, 15, callback); + + sleep(300); + + dec.cancel(); + + gpioTerminate(); +} + diff --git a/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.cpp b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.cpp new file mode 100644 index 0000000..598b76d --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.cpp @@ -0,0 +1,116 @@ +#include + +#include "wiegand.hpp" + +Wiegand::Wiegand(int gpio_0, int gpio_1, WiegandCB_t callback, int timeout) +{ + /* + Instantiate with the gpio for 0 (green wire), the gpio for 1 + (white wire), the callback function, and the bit timeout in + milliseconds which indicates the end of a code. + + The callback is passed the code length in bits and the value. + */ + + mygpio_0 = gpio_0; + mygpio_1 = gpio_1; + + mycallback = callback; + + mytimeout = timeout; + + in_code = 0; + + gpioSetMode(gpio_0, PI_INPUT); + gpioSetMode(gpio_1, PI_INPUT); + + gpioSetPullUpDown(gpio_0, PI_PUD_UP); + gpioSetPullUpDown(gpio_1, PI_PUD_UP); + + gpioSetAlertFuncEx(gpio_0, _cbEx, this); + gpioSetAlertFuncEx(gpio_1, _cbEx, this); +} + +void Wiegand::_cb(int gpio, int level, uint32_t tick) +{ + /* + Accumulate bits until both gpios 0 and 1 timeout. + */ + + if (level == 0) /* a falling edge indicates a new bit */ + { + if (!in_code) + { + bits = 1; + num = 0; + + in_code = 1; + code_timeout = 0; + + gpioSetWatchdog(mygpio_0, mytimeout); + gpioSetWatchdog(mygpio_1, mytimeout); + } + else + { + bits++; + num <<= 1; + } + + if (gpio == mygpio_0) + { + code_timeout &= 2; /* clear gpio 0 timeout */ + } + else + { + code_timeout &= 1; /* clear gpio 1 timeout */ + num |= 1; + } + } + else if (level == PI_TIMEOUT) + { + if (in_code) + { + if (gpio == mygpio_0) + { + code_timeout |= 1; /* timeout gpio 0 */ + } + else + { + code_timeout |= 2; /* timeout gpio 1 */ + } + + if (code_timeout == 3) /* both gpios timed out */ + { + gpioSetWatchdog(mygpio_0, 0); + gpioSetWatchdog(mygpio_1, 0); + + in_code = 0; + + (mycallback)(bits, num); + } + } + } +} + +void Wiegand::_cbEx(int gpio, int level, uint32_t tick, void *user) +{ + /* + Need a static callback to link with C. + */ + + Wiegand *mySelf = (Wiegand *) user; + + mySelf->_cb(gpio, level, tick); /* Call the instance callback. */ +} + + +void Wiegand::cancel(void) +{ + /* + Cancel the Wiegand decoder. + */ + + gpioSetAlertFuncEx(mygpio_0, 0, this); + gpioSetAlertFuncEx(mygpio_1, 0, this); +} + diff --git a/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.hpp b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.hpp new file mode 100644 index 0000000..4b5215c --- /dev/null +++ b/pigpio-master/EXAMPLES/CPP/WIEGAND_CODE/wiegand.hpp @@ -0,0 +1,43 @@ +#ifndef WIEGAND_HPP +#define WIEGAND_HPP + +#include + +typedef void (*WiegandCB_t)(int, uint32_t); + +class Wiegand +{ + int mygpio_0, mygpio_1, mytimeout, in_code, bits; + + WiegandCB_t mycallback; + + uint32_t num; + + uint32_t code_timeout; + + void _cb(int gpio, int level, uint32_t tick); + + /* Need a static callback to link with C. */ + static void _cbEx(int gpio, int level, uint32_t tick, void *user); + + public: + + Wiegand(int gpio_0, int gpio_1, WiegandCB_t callback, int timeout=5); + /* + This function establishes a Wiegand decoder on gpio_0 and gpio_1. + + A gap of timeout milliseconds without a new bit indicates + the end of a code. + + When the code is ended the callback function is called with the code + bit length and value. + */ + + void cancel(void); + /* + This function releases the resources used by the decoder. + */ +}; + +#endif + diff --git a/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/README b/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/README new file mode 100644 index 0000000..6e3259c --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/README @@ -0,0 +1,2 @@ +Class to read the relative humidity and temperature from a DHT11 sensor. +It implements the iterator python protocol. diff --git a/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/dht11.py b/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/dht11.py new file mode 100644 index 0000000..455ad2a --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/DHT11_SENSOR/dht11.py @@ -0,0 +1,163 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- + +from __future__ import absolute_import, division, print_function, unicode_literals + +import time +import pigpio + + +class DHT11(object): + """ + The DHT11 class is a stripped version of the DHT22 sensor code by joan2937. + You can find the initial implementation here: + - https://github.com/srounet/pigpio/tree/master/EXAMPLES/Python/DHT22_AM2302_SENSOR + + example code: + >>> pi = pigpio.pi() + >>> sensor = DHT11(pi, 4) # 4 is the data GPIO pin connected to your sensor + >>> for response in sensor: + .... print("Temperature: {}".format(response['temperature'])) + .... print("Humidity: {}".format(response['humidity'])) + """ + + def __init__(self, pi, gpio): + """ + pi (pigpio): an instance of pigpio + gpio (int): gpio pin number + """ + self.pi = pi + self.gpio = gpio + self.high_tick = 0 + self.bit = 40 + self.temperature = 0 + self.humidity = 0 + self.either_edge_cb = None + self.setup() + + def setup(self): + """ + Clears the internal gpio pull-up/down resistor. + Kills any watchdogs. + """ + self.pi.set_pull_up_down(self.gpio, pigpio.PUD_OFF) + self.pi.set_watchdog(self.gpio, 0) + self.register_callbacks() + + def register_callbacks(self): + """ + Monitors RISING_EDGE changes using callback. + """ + self.either_edge_cb = self.pi.callback( + self.gpio, + pigpio.EITHER_EDGE, + self.either_edge_callback + ) + + def either_edge_callback(self, gpio, level, tick): + """ + Either Edge callbacks, called each time the gpio edge changes. + Accumulate the 40 data bits from the dht11 sensor. + """ + level_handlers = { + pigpio.FALLING_EDGE: self._edge_FALL, + pigpio.RISING_EDGE: self._edge_RISE, + pigpio.EITHER_EDGE: self._edge_EITHER + } + handler = level_handlers[level] + diff = pigpio.tickDiff(self.high_tick, tick) + handler(tick, diff) + + def _edge_RISE(self, tick, diff): + """ + Handle Rise signal. + """ + val = 0 + if diff >= 50: + val = 1 + if diff >= 200: # Bad bit? + self.checksum = 256 # Force bad checksum + + if self.bit >= 40: # Message complete + self.bit = 40 + elif self.bit >= 32: # In checksum byte + self.checksum = (self.checksum << 1) + val + if self.bit == 39: + # 40th bit received + self.pi.set_watchdog(self.gpio, 0) + total = self.humidity + self.temperature + # is checksum ok ? + if not (total & 255) == self.checksum: + raise + elif 16 <= self.bit < 24: # in temperature byte + self.temperature = (self.temperature << 1) + val + elif 0 <= self.bit < 8: # in humidity byte + self.humidity = (self.humidity << 1) + val + else: # skip header bits + pass + self.bit += 1 + + def _edge_FALL(self, tick, diff): + """ + Handle Fall signal. + """ + self.high_tick = tick + if diff <= 250000: + return + self.bit = -2 + self.checksum = 0 + self.temperature = 0 + self.humidity = 0 + + def _edge_EITHER(self, tick, diff): + """ + Handle Either signal. + """ + self.pi.set_watchdog(self.gpio, 0) + + def read(self): + """ + Start reading over DHT11 sensor. + """ + self.pi.write(self.gpio, pigpio.LOW) + time.sleep(0.017) # 17 ms + self.pi.set_mode(self.gpio, pigpio.INPUT) + self.pi.set_watchdog(self.gpio, 200) + time.sleep(0.2) + + def close(self): + """ + Stop reading sensor, remove callbacks. + """ + self.pi.set_watchdog(self.gpio, 0) + if self.either_edge_cb: + self.either_edge_cb.cancel() + self.either_edge_cb = None + + def __iter__(self): + """ + Support the iterator protocol. + """ + return self + + def next(self): + """ + Call the read method and return temperature and humidity informations. + """ + self.read() + response = { + 'humidity': self.humidity, + 'temperature': self.temperature + } + return response + + +if __name__ == '__main__': + pi = pigpio.pi() + sensor = DHT11(pi, 4) + for d in sensor: + print("temperature: {}".format(d['temperature'])) + print("humidity: {}".format(d['humidity'])) + time.sleep(1) + sensor.close() + diff --git a/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/DHT22.py b/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/DHT22.py new file mode 100644 index 0000000..c9ce87e --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/DHT22.py @@ -0,0 +1,283 @@ +#!/usr/bin/env python + +# 2014-07-11 DHT22.py + +import time +import atexit + +import pigpio + +class sensor: + """ + A class to read relative humidity and temperature from the + DHT22 sensor. The sensor is also known as the AM2302. + + The sensor can be powered from the Pi 3V3 or the Pi 5V rail. + + Powering from the 3V3 rail is simpler and safer. You may need + to power from 5V if the sensor is connected via a long cable. + + For 3V3 operation connect pin 1 to 3V3 and pin 4 to ground. + + Connect pin 2 to a gpio. + + For 5V operation connect pin 1 to 5V and pin 4 to ground. + + The following pin 2 connection works for me. Use at YOUR OWN RISK. + + 5V--5K_resistor--+--10K_resistor--Ground + | + DHT22 pin 2 -----+ + | + gpio ------------+ + """ + + def __init__(self, pi, gpio, LED=None, power=None): + """ + Instantiate with the Pi and gpio to which the DHT22 output + pin is connected. + + Optionally a LED may be specified. This will be blinked for + each successful reading. + + Optionally a gpio used to power the sensor may be specified. + This gpio will be set high to power the sensor. If the sensor + locks it will be power cycled to restart the readings. + + Taking readings more often than about once every two seconds will + eventually cause the DHT22 to hang. A 3 second interval seems OK. + """ + + self.pi = pi + self.gpio = gpio + self.LED = LED + self.power = power + + if power is not None: + pi.write(power, 1) # Switch sensor on. + time.sleep(2) + + self.powered = True + + self.cb = None + + atexit.register(self.cancel) + + self.bad_CS = 0 # Bad checksum count. + self.bad_SM = 0 # Short message count. + self.bad_MM = 0 # Missing message count. + self.bad_SR = 0 # Sensor reset count. + + # Power cycle if timeout > MAX_TIMEOUTS. + self.no_response = 0 + self.MAX_NO_RESPONSE = 2 + + self.rhum = -999 + self.temp = -999 + + self.tov = None + + self.high_tick = 0 + self.bit = 40 + + pi.set_pull_up_down(gpio, pigpio.PUD_OFF) + + pi.set_watchdog(gpio, 0) # Kill any watchdogs. + + self.cb = pi.callback(gpio, pigpio.EITHER_EDGE, self._cb) + + def _cb(self, gpio, level, tick): + """ + Accumulate the 40 data bits. Format into 5 bytes, humidity high, + humidity low, temperature high, temperature low, checksum. + """ + diff = pigpio.tickDiff(self.high_tick, tick) + + if level == 0: + + # Edge length determines if bit is 1 or 0. + + if diff >= 50: + val = 1 + if diff >= 200: # Bad bit? + self.CS = 256 # Force bad checksum. + else: + val = 0 + + if self.bit >= 40: # Message complete. + self.bit = 40 + + elif self.bit >= 32: # In checksum byte. + self.CS = (self.CS << 1) + val + + if self.bit == 39: + + # 40th bit received. + + self.pi.set_watchdog(self.gpio, 0) + + self.no_response = 0 + + total = self.hH + self.hL + self.tH + self.tL + + if (total & 255) == self.CS: # Is checksum ok? + + self.rhum = ((self.hH << 8) + self.hL) * 0.1 + + if self.tH & 128: # Negative temperature. + mult = -0.1 + self.tH = self.tH & 127 + else: + mult = 0.1 + + self.temp = ((self.tH << 8) + self.tL) * mult + + self.tov = time.time() + + if self.LED is not None: + self.pi.write(self.LED, 0) + + else: + + self.bad_CS += 1 + + elif self.bit >= 24: # in temp low byte + self.tL = (self.tL << 1) + val + + elif self.bit >= 16: # in temp high byte + self.tH = (self.tH << 1) + val + + elif self.bit >= 8: # in humidity low byte + self.hL = (self.hL << 1) + val + + elif self.bit >= 0: # in humidity high byte + self.hH = (self.hH << 1) + val + + else: # header bits + pass + + self.bit += 1 + + elif level == 1: + self.high_tick = tick + if diff > 250000: + self.bit = -2 + self.hH = 0 + self.hL = 0 + self.tH = 0 + self.tL = 0 + self.CS = 0 + + else: # level == pigpio.TIMEOUT: + self.pi.set_watchdog(self.gpio, 0) + if self.bit < 8: # Too few data bits received. + self.bad_MM += 1 # Bump missing message count. + self.no_response += 1 + if self.no_response > self.MAX_NO_RESPONSE: + self.no_response = 0 + self.bad_SR += 1 # Bump sensor reset count. + if self.power is not None: + self.powered = False + self.pi.write(self.power, 0) + time.sleep(2) + self.pi.write(self.power, 1) + time.sleep(2) + self.powered = True + elif self.bit < 39: # Short message receieved. + self.bad_SM += 1 # Bump short message count. + self.no_response = 0 + + else: # Full message received. + self.no_response = 0 + + def temperature(self): + """Return current temperature.""" + return self.temp + + def humidity(self): + """Return current relative humidity.""" + return self.rhum + + def staleness(self): + """Return time since measurement made.""" + if self.tov is not None: + return time.time() - self.tov + else: + return -999 + + def bad_checksum(self): + """Return count of messages received with bad checksums.""" + return self.bad_CS + + def short_message(self): + """Return count of short messages.""" + return self.bad_SM + + def missing_message(self): + """Return count of missing messages.""" + return self.bad_MM + + def sensor_resets(self): + """Return count of power cycles because of sensor hangs.""" + return self.bad_SR + + def trigger(self): + """Trigger a new relative humidity and temperature reading.""" + if self.powered: + if self.LED is not None: + self.pi.write(self.LED, 1) + + self.pi.write(self.gpio, pigpio.LOW) + time.sleep(0.017) # 17 ms + self.pi.set_mode(self.gpio, pigpio.INPUT) + self.pi.set_watchdog(self.gpio, 200) + + def cancel(self): + """Cancel the DHT22 sensor.""" + + self.pi.set_watchdog(self.gpio, 0) + + if self.cb is not None: + self.cb.cancel() + self.cb = None + +if __name__ == "__main__": + + import time + + import pigpio + + import DHT22 + + # Intervals of about 2 seconds or less will eventually hang the DHT22. + INTERVAL = 3 + + pi = pigpio.pi() + + s = DHT22.sensor(pi, 22, LED=16, power=8) + + r = 0 + + next_reading = time.time() + + while True: + + r += 1 + + s.trigger() + + time.sleep(0.2) + + print("{} {} {} {:3.2f} {} {} {} {}".format( + r, s.humidity(), s.temperature(), s.staleness(), + s.bad_checksum(), s.short_message(), s.missing_message(), + s.sensor_resets())) + + next_reading += INTERVAL + + time.sleep(next_reading-time.time()) # Overall INTERVAL second polling. + + s.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/README b/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/README new file mode 100644 index 0000000..328c023 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/DHT22_AM2302_SENSOR/README @@ -0,0 +1,2 @@ +Class to read the relative humidity and temperature from a DHT22/AM2302 sensor. + diff --git a/pigpio-master/EXAMPLES/Python/GPIO_STATUS/README b/pigpio-master/EXAMPLES/Python/GPIO_STATUS/README new file mode 100644 index 0000000..4ee48d3 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/GPIO_STATUS/README @@ -0,0 +1,2 @@ +Script to display the status of gpios 0-31. + diff --git a/pigpio-master/EXAMPLES/Python/GPIO_STATUS/gpio_status.py b/pigpio-master/EXAMPLES/Python/GPIO_STATUS/gpio_status.py new file mode 100644 index 0000000..9b3bf78 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/GPIO_STATUS/gpio_status.py @@ -0,0 +1,65 @@ +#!/usr/bin/env python + +import time +import curses +import atexit +import sys + +import pigpio + +GPIOS=32 + +MODES=["INPUT", "OUTPUT", "ALT5", "ALT4", "ALT0", "ALT1", "ALT2", "ALT3"] + +def cleanup(): + curses.nocbreak() + curses.echo() + curses.endwin() + pi.stop() + +pi = pigpio.pi() +if not pi.connected: + sys.exit(1) + +stdscr = curses.initscr() +curses.noecho() +curses.cbreak() + +atexit.register(cleanup) + +cb = [] + +for g in range(GPIOS): + cb.append(pi.callback(g, pigpio.EITHER_EDGE)) + +# disable gpio 28 as the PCM clock is swamping the system + +cb[28].cancel() + +stdscr.nodelay(1) + +stdscr.addstr(0, 23, "Status of gpios 0-31", curses.A_REVERSE) + +while True: + + for g in range(GPIOS): + tally = cb[g].tally() + mode = pi.get_mode(g) + + col = (g // 11) * 25 + row = (g % 11) + 2 + + stdscr.addstr(row, col, "{:2}".format(g), curses.A_BOLD) + + stdscr.addstr( + "={} {:>6}: {:<10}".format(pi.read(g), MODES[mode], tally)) + + stdscr.refresh() + + time.sleep(0.1) + + c = stdscr.getch() + + if c != curses.ERR: + break + diff --git a/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/README b/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/README new file mode 100644 index 0000000..57f9143 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/README @@ -0,0 +1,2 @@ +Program to show status changes for a Hall effect sensor. + diff --git a/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/hall.py b/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/hall.py new file mode 100644 index 0000000..a3a19bb --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/HALL_EFFECT_SENSOR/hall.py @@ -0,0 +1,32 @@ +#!/usr/bin/env python + +import time + +import pigpio + +# +# OH3144E or equivalent Hall effect sensor +# +# Pin 1 - 5V +# Pin 2 - Ground +# Pin 3 - gpio (here P1-8, gpio 14, TXD is used) +# +# The internal gpio pull-up is enabled so that the sensor +# normally reads high. It reads low when a magnet is close. +# + +HALL=14 + +pi = pigpio.pi() # connect to local Pi + +pi.set_mode(HALL, pigpio.INPUT) +pi.set_pull_up_down(HALL, pigpio.PUD_UP) + +start = time.time() + +while (time.time() - start) < 60: + print("Hall = {}".format(pi.read(HALL))) + time.sleep(0.2) + +pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/I2C_sniffer.py b/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/I2C_sniffer.py new file mode 100644 index 0000000..e45fa21 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/I2C_sniffer.py @@ -0,0 +1,163 @@ +#!/usr/bin/env python + +import time + +import pigpio + +class sniffer: + """ + A class to passively monitor activity on an I2C bus. This should + work for an I2C bus running at 100kbps or less. You are unlikely + to get any usable results for a bus running any faster. + """ + + def __init__(self, pi, SCL, SDA, set_as_inputs=True): + """ + Instantiate with the Pi and the gpios for the I2C clock + and data lines. + + If you are monitoring one of the Raspberry Pi buses you + must set set_as_inputs to False so that they remain in + I2C mode. + + The pigpio daemon should have been started with a higher + than default sample rate. + + For an I2C bus rate of 100Kbps sudo pigpiod -s 2 should work. + + A message is printed for each I2C transaction formatted with + "[" for the START + "XX" two hex characters for each data byte + "+" if the data is ACKd, "-" if the data is NACKd + "]" for the STOP + + E.g. Reading the X, Y, Z values from an ADXL345 gives: + + [A6+32+] + [A7+01+FF+F2+FF+06+00-] + """ + + self.pi = pi + self.gSCL = SCL + self.gSDA = SDA + + self.FALLING = 0 + self.RISING = 1 + self.STEADY = 2 + + self.in_data = False + self.byte = 0 + self.bit = 0 + self.oldSCL = 1 + self.oldSDA = 1 + + self.transact = "" + + if set_as_inputs: + self.pi.set_mode(SCL, pigpio.INPUT) + self.pi.set_mode(SDA, pigpio.INPUT) + + self.cbA = self.pi.callback(SCL, pigpio.EITHER_EDGE, self._cb) + self.cbB = self.pi.callback(SDA, pigpio.EITHER_EDGE, self._cb) + + def _parse(self, SCL, SDA): + """ + Accumulate all the data between START and STOP conditions + into a string and output when STOP is detected. + """ + + if SCL != self.oldSCL: + self.oldSCL = SCL + if SCL: + xSCL = self.RISING + else: + xSCL = self.FALLING + else: + xSCL = self.STEADY + + if SDA != self.oldSDA: + self.oldSDA = SDA + if SDA: + xSDA = self.RISING + else: + xSDA = self.FALLING + else: + xSDA = self.STEADY + + if xSCL == self.RISING: + if self.in_data: + if self.bit < 8: + self.byte = (self.byte << 1) | SDA + self.bit += 1 + else: + self.transact += '{:02X}'.format(self.byte) + if SDA: + self.transact += '-' + else: + self.transact += '+' + self.bit = 0 + self.byte = 0 + + elif xSCL == self.STEADY: + + if xSDA == self.RISING: + if SCL: + self.in_data = False + self.byte = 0 + self.bit = 0 + self.transact += ']' # STOP + print (self.transact) + self.transact = "" + + if xSDA == self.FALLING: + if SCL: + self.in_data = True + self.byte = 0 + self.bit = 0 + self.transact += '[' # START + + def _cb(self, gpio, level, tick): + """ + Check which line has altered state (ignoring watchdogs) and + call the parser with the new state. + """ + SCL = self.oldSCL + SDA = self.oldSDA + + if gpio == self.gSCL: + if level == 0: + SCL = 0 + elif level == 1: + SCL = 1 + + if gpio == self.gSDA: + if level == 0: + SDA = 0 + elif level == 1: + SDA = 1 + + self._parse(SCL, SDA) + + def cancel(self): + """Cancel the I2C callbacks.""" + self.cbA.cancel() + self.cbB.cancel() + +if __name__ == "__main__": + + import time + + import pigpio + + import I2C_sniffer + + pi = pigpio.pi() + + s = I2C_sniffer.sniffer(pi, 1, 0, False) # leave gpios 1/0 in I2C mode + + time.sleep(60000) + + s.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/README b/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/README new file mode 100644 index 0000000..68aa6a7 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/I2C_SNIFFER/README @@ -0,0 +1,2 @@ +A program to passively sniff I2C transactions (100kHz bus maximum) and display the results. + diff --git a/pigpio-master/EXAMPLES/Python/IR_RECEIVER/README b/pigpio-master/EXAMPLES/Python/IR_RECEIVER/README new file mode 100644 index 0000000..7b3cf33 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/IR_RECEIVER/README @@ -0,0 +1,2 @@ +Class to hash a code from an IR receiver (reading an IR remote control). + diff --git a/pigpio-master/EXAMPLES/Python/IR_RECEIVER/ir_hasher.py b/pigpio-master/EXAMPLES/Python/IR_RECEIVER/ir_hasher.py new file mode 100644 index 0000000..61a443f --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/IR_RECEIVER/ir_hasher.py @@ -0,0 +1,165 @@ +#!/usr/bin/env python + +import pigpio + +class hasher: + + """ + This class forms a hash over the IR pulses generated by an + IR remote. + + The remote key press is not converted into a code in the manner of + the lirc module. No attempt is made to decode the type of protocol + used by the remote. The hash is likely to be unique for different + keys and different remotes but this is not guaranteed. + + This hashing process works for some remotes/protocols but not for + others. The only way to find out if it works for one or more of + your remotes is to try it and see. + + EXAMPLE CODE + + #!/usr/bin/env python + + import time + import pigpio + import ir_hasher + + def callback(hash): + print("hash={}".format(hash)); + + pi = pigpio.pi() + + ir = ir_hasher.hasher(pi, 7, callback, 5) + + print("ctrl c to exit"); + + time.sleep(300) + + pi.stop() + """ + + def __init__(self, pi, gpio, callback, timeout=5): + + """ + Initialises an IR remote hasher on a pi's gpio. A gap of timeout + milliseconds indicates the end of the remote key press. + """ + + self.pi = pi + self.gpio = gpio + self.code_timeout = timeout + self.callback = callback + + self.in_code = False + + pi.set_mode(gpio, pigpio.INPUT) + + self.cb = pi.callback(gpio, pigpio.EITHER_EDGE, self._cb) + + def _hash(self, old_val, new_val): + + if new_val < (old_val * 0.60): + val = 13 + elif old_val < (new_val * 0.60): + val = 23 + else: + val = 2 + + self.hash_val = self.hash_val ^ val + self.hash_val *= 16777619 # FNV_PRIME_32 + self.hash_val = self.hash_val & ((1<<32)-1) + + def _cb(self, gpio, level, tick): + + if level != pigpio.TIMEOUT: + + if self.in_code == False: + + self.in_code = True + + self.pi.set_watchdog(self.gpio, self.code_timeout) + + self.hash_val = 2166136261 # FNV_BASIS_32 + + self.edges = 1 + + self.t1 = None + self.t2 = None + self.t3 = None + self.t4 = tick + + else: + + self.edges += 1 + + self.t1 = self.t2 + self.t2 = self.t3 + self.t3 = self.t4 + self.t4 = tick + + if self.t1 is not None: + + d1 = pigpio.tickDiff(self.t1,self.t2) + d2 = pigpio.tickDiff(self.t3,self.t4) + + self._hash(d1, d2) + + else: + + if self.in_code: + + self.in_code = False + + self.pi.set_watchdog(self.gpio, 0) + + if self.edges > 12: + + self.callback(self.hash_val) + +if __name__ == "__main__": + + import time + import pigpio + import ir_hasher + + hashes = { + 142650387: '2', 244341844: 'menu', 262513468: 'vol-', + 272048826: '5', 345069212: '6', 363685443: 'prev.ch', + 434191356: '1', 492745084: 'OK', 549497027: 'mute', + 603729091: 'text', 646476378: 'chan-', 832916949: 'home', + 923778138: 'power', 938165610: 'power', 953243510: 'forward', + 1009731980:'1', 1018231875:'TV', 1142888517:'c-up', + 1151589683:'chan+', 1344018636:'OK', 1348032067:'chan+', + 1367109971:'prev.ch', 1370712102:'c-left', 1438405361:'rewind', + 1452589043:'pause', 1518578730:'chan-', 1554432645:'8', + 1583569525:'0', 1629745313:'rewind', 1666513749:'record', + 1677653754:'c-down', 1825951717:'c-right', 1852412236:'6', + 1894279468:'9', 1904895749:'vol+', 1941947509:'ff', + 2076573637:'0', 2104823531:'back', 2141641957:'home', + 2160787557:'record', 2398525299:'7', 2468117013:'8', + 2476712746:'play', 2574308838:'forward', 2577952149:'4', + 2706654902:'stop', 2829002741:'c-up', 2956097083:'back', + 3112717386:'5', 3263244773:'ff', 3286088195:'pause', + 3363767978:'c-down', 3468076364:'vol-', 3491068358:'stop', + 3593710134:'c-left', 3708232515:'3', 3734134565:'back', + 3766109107:'TV', 3798010010:'play', 3869937700:'menu', + 3872715523:'7', 3885097091:'2', 3895301587:'text', + 3931058739:'mute', 3983900853:'c-right', 4032250885:'4', + 4041913909:'vol+', 4207017660:'9', 4227138677:'back', + 4294027955:'3'} + + def callback(hash): + if hash in hashes: + print("key={} hash={}".format(hashes[hash], hash)); + + pi = pigpio.pi() + + ir = ir_hasher.hasher(pi, 7, callback, 5) + + print("ctrl c to exit"); + + time.sleep(300) + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/MORSE_CODE/README b/pigpio-master/EXAMPLES/Python/MORSE_CODE/README new file mode 100644 index 0000000..2ceb79c --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/MORSE_CODE/README @@ -0,0 +1,2 @@ +Script to transmit the morse code corresponding to a text string. + diff --git a/pigpio-master/EXAMPLES/Python/MORSE_CODE/morse_code.py b/pigpio-master/EXAMPLES/Python/MORSE_CODE/morse_code.py new file mode 100644 index 0000000..a452747 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/MORSE_CODE/morse_code.py @@ -0,0 +1,72 @@ +#!/usr/bin/env python + +import pigpio + +morse={ +'a':'.-' , 'b':'-...' , 'c':'-.-.' , 'd':'-..' , 'e':'.' , +'f':'..-.' , 'g':'--.' , 'h':'....' , 'i':'..' , 'j':'.---' , +'k':'-.-' , 'l':'.-..' , 'm':'--' , 'n':'-.' , 'o':'---' , +'p':'.--.' , 'q':'--.-' , 'r':'.-.' , 's':'...' , 't':'-' , +'u':'..-' , 'v':'...-' , 'w':'.--' , 'x':'-..-' , 'y':'-.--' , +'z':'--..' , '1':'.----', '2':'..---', '3':'...--', '4':'....-', +'5':'.....', '6':'-....', '7':'--...', '8':'---..', '9':'----.', +'0':'-----'} + +GPIO=22 + +MICROS=100000 + +NONE=0 + +DASH=3 +DOT=1 + +GAP=1 +LETTER_GAP=3-GAP +WORD_GAP=7-LETTER_GAP + +def transmit_string(pi, gpio, str): + + pi.wave_clear() # start a new waveform + + wf=[] + + for C in str: + c=C.lower() + print(c) + if c in morse: + k = morse[c] + for x in k: + + if x == '.': + wf.append(pigpio.pulse(1<AIN2") +stdscr.addstr(16, 0, "Resistor") + +stdscr.nodelay(1) + +try: + while True: + + for a in range(0,4): + aout = aout + 1 + pi.i2c_write_byte_data(handle, 0x40 | ((a+1) & 0x03), aout&0xFF) + v = pi.i2c_read_byte(handle) + hashes = v / 4 + spaces = 64 - hashes + stdscr.addstr(10+a*2, 12, str(v) + ' ') + stdscr.addstr(10+a*2, 16, '#' * hashes + ' ' * spaces ) + + stdscr.refresh() + time.sleep(0.04) + + c = stdscr.getch() + + if c != curses.ERR: + break + +except: + pass + +curses.nocbreak() +curses.echo() +curses.endwin() + +pi.i2c_close(handle) +pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/PCF8591_YL-40/README b/pigpio-master/EXAMPLES/Python/PCF8591_YL-40/README new file mode 100644 index 0000000..cdd9374 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/PCF8591_YL-40/README @@ -0,0 +1,2 @@ +Script to display readings from the (I2C) PCF8591. + diff --git a/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/README b/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/README new file mode 100644 index 0000000..4c6e46b --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/README @@ -0,0 +1,2 @@ +Script to benchmark the pigpio Python module's performance. + diff --git a/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/bench_1.py b/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/bench_1.py new file mode 100644 index 0000000..0a66bdc --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/PIGPIO_BENCHMARK/bench_1.py @@ -0,0 +1,91 @@ +#!/usr/bin/env python + +# +# WARNING! +# + +############################################################################## +# # +# Unless you know what you are doing don't run this script with anything # +# connected to the gpios. You will CAUSE damage. # +# # +############################################################################## + +# +# WARNING! +# + +import time + +import pigpio + +delay = 30 + +class gpioTest: + + def __init__(self, pi, gpio, edge, freq, duty): + self.pi = pi + self.gpio = gpio + self.edge = edge + self.freq = freq + self.duty = duty + self.calls = 0 + + def cb(self, g, t, l): + self.calls = self.calls + 1 + # print g,t,l + + def num(self): + return self.calls + + def start(self): + self.pi.set_PWM_frequency(self.gpio, self.freq) + self.pi.set_PWM_range(self.gpio, 25) + self.pi.set_PWM_dutycycle(self.gpio, self.duty) + self.n = self.pi.callback(self.gpio, self.edge, self.cb) + + def stop(self): + self.pi.set_PWM_dutycycle(self.gpio, 0) + self.n.cancel() + +pi = pigpio.pi() + +t1 = gpioTest(pi, 4, pigpio.EITHER_EDGE, 4000, 1) +t2 = gpioTest(pi, 7, pigpio.RISING_EDGE, 8000, 2) +t3 = gpioTest(pi, 8, pigpio.FALLING_EDGE, 8000, 3) +t4 = gpioTest(pi, 9, pigpio.EITHER_EDGE, 4000, 4) +t5 = gpioTest(pi,10, pigpio.RISING_EDGE, 8000, 5) +t6 = gpioTest(pi,11, pigpio.FALLING_EDGE, 8000, 6) +t7 = gpioTest(pi,14, pigpio.EITHER_EDGE, 4000, 7) +t8 = gpioTest(pi,15, pigpio.RISING_EDGE, 8000, 8) +t9 = gpioTest(pi,17, pigpio.FALLING_EDGE, 8000, 9) +t10 = gpioTest(pi,18, pigpio.EITHER_EDGE, 4000, 10) +t11 = gpioTest(pi,22, pigpio.RISING_EDGE, 8000, 11) +t12 = gpioTest(pi,23, pigpio.FALLING_EDGE, 8000, 12) +t13 = gpioTest(pi,24, pigpio.EITHER_EDGE, 4000, 13) +t14 = gpioTest(pi,25, pigpio.RISING_EDGE, 8000, 14) + +# R1: 0 1 4 7 8 9 10 11 14 15 17 18 21 22 23 24 25 +# R2: 2 3 4 7 8 9 10 11 14 15 17 18 22 23 24 25 27 28 29 30 31 + +tests = [t1, t2, t3, t4, t5, t6, t7, t8, t9, t10, t11, t12, t13, t14] + +for i in tests: i.start() + +time.sleep(delay) + +for i in tests: i.stop() + +pi.stop() + +tot = 0 +msg = "" + +for i in tests: + tot += i.num() + msg += str(i.num()) + " " + +print(msg) + +print("eps={} ({}/{})".format(tot/delay, tot, delay)) + diff --git a/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/README b/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/README new file mode 100644 index 0000000..8dbe585 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/README @@ -0,0 +1,2 @@ +Class to decode a mechanical rotary encoder. + diff --git a/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/rotary_encoder.py b/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/rotary_encoder.py new file mode 100644 index 0000000..884ff61 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/ROTARY_ENCODER/rotary_encoder.py @@ -0,0 +1,135 @@ +#!/usr/bin/env python + +import pigpio + +class decoder: + + """Class to decode mechanical rotary encoder pulses.""" + + def __init__(self, pi, gpioA, gpioB, callback): + + """ + Instantiate the class with the pi and gpios connected to + rotary encoder contacts A and B. The common contact + should be connected to ground. The callback is + called when the rotary encoder is turned. It takes + one parameter which is +1 for clockwise and -1 for + counterclockwise. + + EXAMPLE + + import time + import pigpio + + import rotary_encoder + + pos = 0 + + def callback(way): + + global pos + + pos += way + + print("pos={}".format(pos)) + + pi = pigpio.pi() + + decoder = rotary_encoder.decoder(pi, 7, 8, callback) + + time.sleep(300) + + decoder.cancel() + + pi.stop() + + """ + + self.pi = pi + self.gpioA = gpioA + self.gpioB = gpioB + self.callback = callback + + self.levA = 0 + self.levB = 0 + + self.lastGpio = None + + self.pi.set_mode(gpioA, pigpio.INPUT) + self.pi.set_mode(gpioB, pigpio.INPUT) + + self.pi.set_pull_up_down(gpioA, pigpio.PUD_UP) + self.pi.set_pull_up_down(gpioB, pigpio.PUD_UP) + + self.cbA = self.pi.callback(gpioA, pigpio.EITHER_EDGE, self._pulse) + self.cbB = self.pi.callback(gpioB, pigpio.EITHER_EDGE, self._pulse) + + def _pulse(self, gpio, level, tick): + + """ + Decode the rotary encoder pulse. + + +---------+ +---------+ 0 + | | | | + A | | | | + | | | | + +---------+ +---------+ +----- 1 + + +---------+ +---------+ 0 + | | | | + B | | | | + | | | | + ----+ +---------+ +---------+ 1 + """ + + if gpio == self.gpioA: + self.levA = level + else: + self.levB = level; + + if gpio != self.lastGpio: # debounce + self.lastGpio = gpio + + if gpio == self.gpioA and level == 1: + if self.levB == 1: + self.callback(1) + elif gpio == self.gpioB and level == 1: + if self.levA == 1: + self.callback(-1) + + def cancel(self): + + """ + Cancel the rotary encoder decoder. + """ + + self.cbA.cancel() + self.cbB.cancel() + +if __name__ == "__main__": + + import time + import pigpio + + import rotary_encoder + + pos = 0 + + def callback(way): + + global pos + + pos += way + + print("pos={}".format(pos)) + + pi = pigpio.pi() + + decoder = rotary_encoder.decoder(pi, 7, 8, callback) + + time.sleep(300) + + decoder.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/README.md b/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/README.md new file mode 100644 index 0000000..8f3c83b --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/README.md @@ -0,0 +1,28 @@ +# Python Class for Reading Single Edge Nibble Transmission (SENT) using the Raspberry Pi + +A full description of this Python script is described at [www.surfncircuits.com](https://surfncircuits.com) in the blog entry: [Implementing a Single Edge Nibble Transmission (SENT) protocol in Python for the Raspberry Pi Zero](https://surfncircuits.com/?p=3725) + + +This python library will read a Raspberry Pi GPIO pin connected. Start the pigpiod daemon with one microsecond sampling to read SENT transmissions with three microsecond tick times. + +## To start the daemon on Raspberry Pi +- sudo pigpiod -s 1 + +## SENT packet frame summary + +- Sync Pulse: 56 ticks +- 4 bit Status and Message Pulse: 17-32 ticks +- 4 bit (9:12) Data1 Field: 17-32 ticks +- 4 bit (5:8) Data1 Field: 17-32 ticks +- 4 bit (1:4) Data1 Field: 17-32 ticks +- 4 bit (9-12) Data2 Field: 17-32 ticks +- 4 bit (5-8) Data2 Field: 17-32 ticks +- 4 bit (1-4) Data2 Field: 17-32 ticks +- 4 bit CRC: 17-32 ticks + + +## requirements +[pigpiod](http://abyz.me.uk/rpi/pigpio/) library required + +## To run the script for a signal attached to GPIO BCD 18 (pin 12) +- python3 sent_READ.py diff --git a/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/read_SENT.py b/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/read_SENT.py new file mode 100644 index 0000000..1bc9709 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/SENT_PROTOCOL/read_SENT.py @@ -0,0 +1,322 @@ +#!/usr/bin/env python3 + +# read_PWM.py +# Public Domain by mark smith, www.surfncircuits.com +# blog:https://surfncircuits.com/2020/11/27/implementing-a-single-edge-nibble-transmission-sent-protocol-in-python-for-the-raspberry-pi-zero/ + +import time +import pigpio # http://abyz.co.uk/rpi/pigpio/python.html +import threading + +class SENTReader: + """ + A class to read short Format SENT frames + (see the LX3302A datasheet for a SENT reference from Microchip) + (also using sent transmission mode where ) + from wikiPedia: The SAE J2716 SENT (Single Edge Nibble Transmission) protocol + is a point-to-point scheme for transmitting signal values + from a sensor to a controller. It is intended to allow for + transmission of high resolution data with a low system cost. + + Short sensor format: + The first is the SYNC pulse (56 ticks) + first Nibble : Status (4 bits) + 2nd NIbble : DAta1 (4 bits) + 3nd Nibble : Data2 (4 bits) + 4th Nibble : Data3 (4 bits) + 5th Nibble : Data1 (4 bits) + 6th Nibble : Data2 (4 bits) + 7th Nibble : Data3 (4 bits) + 8th Nibble : CRC (4 bits) + """ + def __init__(self, pi, gpio, Mode = 0): + """ + Instantiate with the Pi and gpio of the SENT signal + to monitor. + SENT mode = A0: Microchip LX3302A where the two 12 bit data values are identical. there are other modes + + """ + self.pi = pi + self.gpio = gpio + self.SENTMode = Mode + + # the time that pulse goes high + self._high_tick = 0 + # the period of the low tick + self._low_tick = 0 + # the period of the pulse (total data) + self._period = 0 + # the time the item was low during the period + self._low = 0 + # the time the output was high during the period + self._high = 0 + # setting initial value to 100 + self.syncTick = 100 + + + #keep track of the periods + self.syncWidth = 0 + self.status = 0 + self.data1 = 0 + self.data2 = 0 + self.data3 = 0 + self.data4 = 0 + self.data5 = 0 + self.data6 = 0 + self.crc = 0 + #initize the sent frame . Need to use hex for data + #self.frame = [0,0,0,'0x0','0x0','0x0','0x0','0x0','0x0',0] + self.frame = [0,0,0,0,0,0,0,0,0,0] + self.syncFound = False + self.frameComplete = False + self.nibble = 0 + self.numberFrames = 0 + self.SampleStopped = False + + self.pi.set_mode(gpio, pigpio.INPUT) + + #self._cb = pi.callback(gpio, pigpio.EITHER_EDGE, self._cbf) + #sleep enougth to start reading SENT + #time.sleep(0.05) + + #start thread to sample the SENT property + # this is needed for piGPIO sample of 1us and sensing the 3us + self.OutputSampleThread = threading.Thread(target = self.SampleCallBack) + self.OutputSampleThread.daemon = True + self.OutputSampleThread.start() + + #give time for thread to start capturing data + time.sleep(.05) + + + def SampleCallBack(self): + + # this will run in a loop and sample the SENT path + # this sampling is required when 1us sample rate for SENT 3us tick time + while True: + + self.SampleStopped = False + self._cb = self.pi.callback(self.gpio, pigpio.EITHER_EDGE, self._cbf) + # wait until sample stopped + while self.SampleStopped == False: + #do nothing + time.sleep(.001) + + # gives the callback time to cancel so we can start again. + time.sleep(0.20) + + def _cbf(self, gpio, level, tick): + # depending on the system state set the tick times. + # first look for sync pulse. this is found when duty ratio >90 + #print(pgio) + #print("inside _cpf") + #print(tick) + if self.syncFound == False: + if level == 1: + self._high_tick = tick + self._low = pigpio.tickDiff(self._low_tick,tick) + elif level == 0: + # this may be a syncpulse if the duty is 51/56 + self._period = pigpio.tickDiff(self._low_tick,tick) + # not reset the self._low_tick + self._low_tick = tick + self._high = pigpio.tickDiff(self._high_tick,tick) + # sync pulse is detected by finding duty ratio. 51/56 + # but also filter if period is > 90us*56 = 5040 + if (100*self._high/self._period) > 87 and (self._period<5100): + self.syncFound = True + self.syncWidth = self._high + self.syncPeriod = self._period + #self.syncTick = round(self.syncPeriod/56.0,2) + self.syncTick = self.syncPeriod + # reset the nibble to zero + self.nibble = 0 + self.SampleStopped = False + else: + # now look for the nibble information for each nibble (8 Nibbles) + if level == 1: + self._high_tick = tick + self._low = pigpio.tickDiff(self._low_tick,tick) + elif level == 0: + # This will be a data nibble + self._period = pigpio.tickDiff(self._low_tick,tick) + # not reset the self._low_tick + self._low_tick = tick + self._high = pigpio.tickDiff(self._high_tick,tick) + self.nibble = self.nibble + 1 + if self.nibble == 1: + self.status = self._period + elif self.nibble == 2: + #self.data1 = hex(int(round(self._period / self.syncTick)-12)) + self.data1 = self._period + elif self.nibble == 3: + self.data2 = self._period + elif self.nibble == 4: + self.data3 = self._period + elif self.nibble == 5: + self.data4 = self._period + elif self.nibble == 6: + self.data5 = self._period + elif self.nibble == 7: + self.data6 = self._period + elif self.nibble == 8: + self.crc = self._period + # now send all to the SENT Frame + self.frame = [self.syncPeriod,self.syncTick,self.status,self.data1,self.data2,self.data3,self.data4,self.data5,self.data6,self.crc] + self.syncFound = False + self.nibble = 0 + self.numberFrames += 1 + if self.numberFrames > 2: + self.cancel() + self.SampleStopped = True + self.numberFrames = 0 + + def ConvertData(self,tickdata,tickTime): + if tickdata == 0: + t = '0x0' + else: + t = hex(int(round(tickdata / tickTime)-12)) + if t[0] =='-': + t='0x0' + return t + + def SENTData(self): + # check that data1 = Data2 if they are not equal return fault = True + # will check the CRC code for faults. if fault, return = true + # returns status, data1, data2, crc, fault + #self._cb = self.pi.callback(self.gpio, pigpio.EITHER_EDGE, self._cbf) + #time.sleep(0.1) + fault = False + SentFrame = self.frame[:] + SENTTick = round(SentFrame[1]/56.0,2) + + # the greatest SYNC sync is 90us. So trip a fault if this occurs + if SENTTick > 90: + fault = True + + #print(SentFrame) + # convert SentFrame to HEX Format including the status and Crc bits + for x in range (2,10): + SentFrame[x] = self.ConvertData(SentFrame[x],SENTTick) + SENTCrc = SentFrame[9] + SENTStatus = SentFrame[2] + SENTPeriod = SentFrame[0] + #print(SentFrame) + # combine the datafield nibbles + datanibble = '0x' + datanibble2 = '0x' + for x in range (3,6): + datanibble = datanibble + str((SentFrame[x]))[2:] + for x in range (6,9): + datanibble2 = datanibble2 + str((SentFrame[x]))[2:] + # if using SENT mode 0, then data nibbles should be equal + #if self.SENTMode == 0 : + # if datanibble != datanibble2: + # fault = True + # if datanibble or datanibble2 == 0 then fault = true + if (int(datanibble,16) == 0) or (int(datanibble2,16) ==0): + fault = True + # if datanibble or datanibble2 > FFF (4096) then fault = True + if ( (int(datanibble,16) > 0xFFF) or (int(datanibble2,16) > 0xFFF)): + fault = True + #print(datanibble) + # CRC checking + # converting the datanibble values to a binary bit string. + # remove the first two characters. Not needed for crcCheck + InputBitString = bin(int((datanibble + datanibble2[2:]),16))[2:] + # converting Crcvalue to bin but remove the first two characters 0b + # format is set to remove the leading 0b, 4 charactors long + crcBitValue = format(int(str(SENTCrc),16),'04b') + #checking the crcValue + # polybitstring is 1*X^4+1*X^3+1*x^2+0*X+1 = '11101' + if self.crcCheck(InputBitString,'11101',crcBitValue) == False: + fault = True + + # converter to decimnal + returnData = int(datanibble,16) + returnData2 = int(datanibble2,16) + #returns both Data values and if there is a FAULT + return (SENTStatus, returnData, returnData2,SENTTick, SENTCrc, fault, SENTPeriod) + + def tick(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return ticktime + + def crcNibble(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return crc + + def dataField1(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return data1 + + def dataField2(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return data2 + + def statusNibble(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return status + + def syncPulse(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return syncPulse + + def errorFrame(self): + status, data1, data2, ticktime, crc, errors, syncPulse = self.SENTData() + return errors + + def cancel(self): + self._cb.cancel() + + def stop(self): + self.OutputSampleThread.stop() + + def crcCheck(self, InputBitString, PolyBitString, crcValue ): + # the input string will be a binary string all 6 nibbles of the SENT data + # the seed value ( = '0101) is appended to the input string. Do not use zeros for SENT protocal + # this uses the SENT CRC recommended implementation. + checkOK = False + + LenPolyBitString = len(PolyBitString) + PolyBitString = PolyBitString.lstrip('0') + LenInput = len(InputBitString) + InputPaddedArray = list(InputBitString + '0101') + while '1' in InputPaddedArray[:LenInput]: + cur_shift = InputPaddedArray.index('1') + for i in range(len(PolyBitString)): + InputPaddedArray[cur_shift + i] = str(int(PolyBitString[i] != InputPaddedArray[cur_shift + i])) + + if (InputPaddedArray[LenInput:] == list(crcValue)): + checkOK = True + + return checkOK + +if __name__ == "__main__": + + import time + import pigpio + import read_SENT + + SENT_GPIO = 18 + RUN_TIME = 6000000000.0 + SAMPLE_TIME = 0.1 + + pi = pigpio.pi() + + p = read_SENT.SENTReader(pi, SENT_GPIO) + + start = time.time() + + while (time.time() - start) < RUN_TIME: + + time.sleep(SAMPLE_TIME) + + status, data1, data2, ticktime, crc, errors, syncPulse = p.SENTData() + print("Sent Status= %s - 12-bit DATA 1= %4.0f - DATA 2= %4.0f - tickTime(uS)= %4.2f - CRC= %s - Errors= %s - PERIOD = %s" % (status,data1,data2,ticktime,crc,errors,syncPulse)) + print("Sent Stat2s= %s - 12-bit DATA 1= %4.0f - DATA 2= %4.0f - tickTime(uS)= %4.2f - CRC= %s - Errors= %s - PERIOD = %s" % (p.statusNibble(),p.dataField1(),p.dataField2(),p.tick(),p.crcNibble(),p.errorFrame(),p.syncPulse())) + + # stop the thread in SENTReader + p.stop() + # clear the pi object instance + pi.stop() diff --git a/pigpio-master/EXAMPLES/Python/SONAR_RANGER/README b/pigpio-master/EXAMPLES/Python/SONAR_RANGER/README new file mode 100644 index 0000000..effc9e6 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/SONAR_RANGER/README @@ -0,0 +1,2 @@ +Class to read sonar rangers with separate trigger and echo pins. + diff --git a/pigpio-master/EXAMPLES/Python/SONAR_RANGER/sonar_trigger_echo.py b/pigpio-master/EXAMPLES/Python/SONAR_RANGER/sonar_trigger_echo.py new file mode 100644 index 0000000..9485ef4 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/SONAR_RANGER/sonar_trigger_echo.py @@ -0,0 +1,114 @@ +#!/usr/bin/env python + +import time + +import pigpio + +class ranger: + """ + This class encapsulates a type of acoustic ranger. In particular + the type of ranger with separate trigger and echo pins. + + A pulse on the trigger initiates the sonar ping and shortly + afterwards a sonar pulse is transmitted and the echo pin + goes high. The echo pins stays high until a sonar echo is + received (or the response times-out). The time between + the high and low edges indicates the sonar round trip time. + """ + + def __init__(self, pi, trigger, echo): + """ + The class is instantiated with the Pi to use and the + gpios connected to the trigger and echo pins. + """ + self.pi = pi + self._trig = trigger + self._echo = echo + + self._ping = False + self._high = None + self._time = None + + self._triggered = False + + self._trig_mode = pi.get_mode(self._trig) + self._echo_mode = pi.get_mode(self._echo) + + pi.set_mode(self._trig, pigpio.OUTPUT) + pi.set_mode(self._echo, pigpio.INPUT) + + self._cb = pi.callback(self._trig, pigpio.EITHER_EDGE, self._cbf) + self._cb = pi.callback(self._echo, pigpio.EITHER_EDGE, self._cbf) + + self._inited = True + + def _cbf(self, gpio, level, tick): + if gpio == self._trig: + if level == 0: # trigger sent + self._triggered = True + self._high = None + else: + if self._triggered: + if level == 1: + self._high = tick + else: + if self._high is not None: + self._time = tick - self._high + self._high = None + self._ping = True + + def read(self): + """ + Triggers a reading. The returned reading is the number + of microseconds for the sonar round-trip. + + round trip cms = round trip time / 1000000.0 * 34030 + """ + if self._inited: + self._ping = False + self.pi.gpio_trigger(self._trig) + start = time.time() + while not self._ping: + if (time.time()-start) > 5.0: + return 20000 + time.sleep(0.001) + return self._time + else: + return None + + def cancel(self): + """ + Cancels the ranger and returns the gpios to their + original mode. + """ + if self._inited: + self._inited = False + self._cb.cancel() + self.pi.set_mode(self._trig, self._trig_mode) + self.pi.set_mode(self._echo, self._echo_mode) + +if __name__ == "__main__": + + import time + + import pigpio + + import sonar_trigger_echo + + pi = pigpio.pi() + + sonar = sonar_trigger_echo.ranger(pi, 23, 18) + + end = time.time() + 600.0 + + r = 1 + while time.time() < end: + + print("{} {}".format(r, sonar.read())) + r += 1 + time.sleep(0.03) + + sonar.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/README b/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/README new file mode 100644 index 0000000..106c186 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/README @@ -0,0 +1,2 @@ +Class to send and receive radio messages compatible with the Virtual Wire library for Arduinos. + diff --git a/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/vw.py b/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/vw.py new file mode 100644 index 0000000..e871f4f --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/VIRTUAL_WIRE/vw.py @@ -0,0 +1,372 @@ +#!/usr/bin/env python +""" +This module provides a 313MHz/434MHz radio interface compatible +with the Virtual Wire library used on Arduinos. + +It has been tested between a Pi, TI Launchpad, and Arduino Pro Mini. +""" +# 2014-08-14 +# vw.py + +import time + +import pigpio + +MAX_MESSAGE_BYTES=77 + +MIN_BPS=50 +MAX_BPS=10000 + +_HEADER=[0x2a, 0x2a, 0x2a, 0x2a, 0x2a, 0x2a, 0x38, 0x2c] + +_CTL=3 + +_SYMBOL=[ + 0x0d, 0x0e, 0x13, 0x15, 0x16, 0x19, 0x1a, 0x1c, + 0x23, 0x25, 0x26, 0x29, 0x2a, 0x2c, 0x32, 0x34] + + +def _sym2nibble(symbol): + for nibble in range(16): + if symbol == _SYMBOL[nibble]: + return nibble + return 0 + +def _crc_ccitt_update(crc, data): + + data = data ^ (crc & 0xFF); + + data = (data ^ (data << 4)) & 0xFF; + + return ( + (((data << 8) & 0xFFFF) | (crc >> 8)) ^ + ((data >> 4) & 0x00FF) ^ ((data << 3) & 0xFFFF) + ) + +class tx(): + + def __init__(self, pi, txgpio, bps=2000): + """ + Instantiate a transmitter with the Pi, the transmit gpio, + and the bits per second (bps). The bps defaults to 2000. + The bps is constrained to be within MIN_BPS to MAX_BPS. + """ + self.pi = pi + + self.txbit = (1< MAX_BPS: + bps = MAX_BPS + + self.mics = int(1000000 / bps) + + self.wave_id = None + + pi.wave_add_new() + + pi.set_mode(txgpio, pigpio.OUTPUT) + + + def _nibble(self, nibble): + + for i in range(6): + if nibble & (1<>4]) + self._nibble(_SYMBOL[byte&0x0F]) + return _crc_ccitt_update(crc, byte) + + def put(self, data): + """ + Transmit a message. If the message is more than + MAX_MESSAGE_BYTES in size it is discarded. If a message + is currently being transmitted it is aborted and replaced + with the new message. True is returned if message + transmission has successfully started. False indicates + an error. + """ + if len(data) > MAX_MESSAGE_BYTES: + return False + + self.wf = [] + + self.cancel() + + for i in _HEADER: + self._nibble(i) + + crc = self._byte(0xFFFF, len(data)+_CTL) + + for i in data: + + if type(i) == type(""): + v = ord(i) + else: + v = i + + crc = self._byte(crc, v) + + crc = ~crc + + self._byte(0, crc&0xFF) + self._byte(0, crc>>8) + + self.pi.wave_add_generic(self.wf) + + self.wave_id = self.pi.wave_create() + + if self.wave_id >= 0: + self.pi.wave_send_once(self.wave_id) + return True + else: + return False + + + def ready(self): + """ + Returns True if a new message may be transmitted. + """ + return not self.pi.wave_tx_busy() + + def cancel(self): + """ + Cancels the wireless transmitter, aborting any message + in progress. + """ + if self.wave_id is not None: + self.pi.wave_tx_stop() + self.pi.wave_delete(self.wave_id) + self.pi.wave_add_new() + + self.wave_id = None + +class rx(): + + def __init__(self, pi, rxgpio, bps=2000): + """ + Instantiate a receiver with the Pi, the receive gpio, and + the bits per second (bps). The bps defaults to 2000. + The bps is constrained to be within MIN_BPS to MAX_BPS. + """ + self.pi = pi + self.rxgpio = rxgpio + + self.messages = [] + self.bad_CRC = 0 + + if bps < MIN_BPS: + bps = MIN_BPS + elif bps > MAX_BPS: + bps = MAX_BPS + + slack = 0.20 + self.mics = int(1000000 / bps) + slack_mics = int(slack * self.mics) + self.min_mics = self.mics - slack_mics # Shortest legal edge. + self.max_mics = (self.mics + slack_mics) * 4 # Longest legal edge. + + self.timeout = 8 * self.mics / 1000 # 8 bits time in ms. + if self.timeout < 8: + self.timeout = 8 + + self.last_tick = None + self.good = 0 + self.bits = 0 + self.token = 0 + self.in_message = False + self.message = [0]*(MAX_MESSAGE_BYTES+_CTL) + self.message_len = 0 + self.byte = 0 + + pi.set_mode(rxgpio, pigpio.INPUT) + + self.cb = pi.callback(rxgpio, pigpio.EITHER_EDGE, self._cb) + + def _calc_crc(self): + + crc = 0xFFFF + for i in range(self.message_length): + crc = _crc_ccitt_update(crc, self.message[i]) + return crc + + def _insert(self, bits, level): + + for i in range(bits): + + self.token >>= 1 + + if level == 0: + self.token |= 0x800 + + if self.in_message: + + self.bits += 1 + + if self.bits >= 12: # Complete token. + + byte = ( + _sym2nibble(self.token & 0x3f) << 4 | + _sym2nibble(self.token >> 6)) + + if self.byte == 0: + self.message_length = byte + + if byte > (MAX_MESSAGE_BYTES+_CTL): + self.in_message = False # Abort message. + return + + self.message[self.byte] = byte + + self.byte += 1 + self.bits = 0 + + if self.byte >= self.message_length: + self.in_message = False + self.pi.set_watchdog(self.rxgpio, 0) + + crc = self._calc_crc() + + if crc == 0xF0B8: # Valid CRC. + self.messages.append( + self.message[1:self.message_length-2]) + else: + self.bad_CRC += 1 + + else: + if self.token == 0xB38: # Start message token. + self.in_message = True + self.pi.set_watchdog(self.rxgpio, self.timeout) + self.bits = 0 + self.byte = 0 + + def _cb(self, gpio, level, tick): + + if self.last_tick is not None: + + if level == pigpio.TIMEOUT: + + self.pi.set_watchdog(self.rxgpio, 0) # Switch watchdog off. + + if self.in_message: + self._insert(4, not self.last_level) + + self.good = 0 + self.in_message = False + + else: + + edge = pigpio.tickDiff(self.last_tick, tick) + + if edge < self.min_mics: + + self.good = 0 + self.in_message = False + + elif edge > self.max_mics: + + if self.in_message: + self._insert(4, level) + + self.good = 0 + self.in_message = False + + else: + + self.good += 1 + + if self.good > 8: + + bitlen = (100 * edge) / self.mics + + if bitlen < 140: + bits = 1 + elif bitlen < 240: + bits = 2 + elif bitlen < 340: + bits = 3 + else: + bits = 4 + + self._insert(bits, level) + + self.last_tick = tick + self.last_level = level + + def get(self): + """ + Returns the next unread message, or None if none is avaiable. + """ + if len(self.messages): + return self.messages.pop(0) + else: + return None + + def ready(self): + """ + Returns True if there is a message available to be read. + """ + return len(self.messages) + + def cancel(self): + """ + Cancels the wireless receiver. + """ + if self.cb is not None: + self.cb.cancel() + self.pi.set_watchdog(self.rxgpio, 0) + self.cb = None + +if __name__ == "__main__": + + import time + + import pigpio + + import vw + + RX=11 + TX=25 + + BPS=2000 + + pi = pigpio.pi() # Connect to local Pi. + + rx = vw.rx(pi, RX, BPS) # Specify Pi, rx gpio, and baud. + tx = vw.tx(pi, TX, BPS) # Specify Pi, tx gpio, and baud. + + msg = 0 + + start = time.time() + + while (time.time()-start) < 300: + + msg += 1 + + while not tx.ready(): + time.sleep(0.1) + + time.sleep(0.2) + + tx.put([48, 49, 65, ((msg>>6)&0x3F)+32, (msg&0x3F)+32]) + + while not tx.ready(): + time.sleep(0.1) + + time.sleep(0.2) + + tx.put("Hello World #{}!".format(msg)) + + while rx.ready(): + print("".join(chr (c) for c in rx.get())) + + rx.cancel() + tx.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/README b/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/README new file mode 100644 index 0000000..e19bc7c --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/README @@ -0,0 +1,2 @@ +Class to decode a Wiegand code. + diff --git a/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/wiegand.py b/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/wiegand.py new file mode 100644 index 0000000..f7c4610 --- /dev/null +++ b/pigpio-master/EXAMPLES/Python/WIEGAND_CODE/wiegand.py @@ -0,0 +1,135 @@ +#!/usr/bin/env python + +import pigpio + +class decoder: + + """ + A class to read Wiegand codes of an arbitrary length. + + The code length and value are returned. + + EXAMPLE + + #!/usr/bin/env python + + import time + + import pigpio + + import wiegand + + def callback(bits, code): + print("bits={} code={}".format(bits, code)) + + pi = pigpio.pi() + + w = wiegand.decoder(pi, 14, 15, callback) + + time.sleep(300) + + w.cancel() + + pi.stop() + """ + + def __init__(self, pi, gpio_0, gpio_1, callback, bit_timeout=5): + + """ + Instantiate with the pi, gpio for 0 (green wire), the gpio for 1 + (white wire), the callback function, and the bit timeout in + milliseconds which indicates the end of a code. + + The callback is passed the code length in bits and the value. + """ + + self.pi = pi + self.gpio_0 = gpio_0 + self.gpio_1 = gpio_1 + + self.callback = callback + + self.bit_timeout = bit_timeout + + self.in_code = False + + self.pi.set_mode(gpio_0, pigpio.INPUT) + self.pi.set_mode(gpio_1, pigpio.INPUT) + + self.pi.set_pull_up_down(gpio_0, pigpio.PUD_UP) + self.pi.set_pull_up_down(gpio_1, pigpio.PUD_UP) + + self.cb_0 = self.pi.callback(gpio_0, pigpio.FALLING_EDGE, self._cb) + self.cb_1 = self.pi.callback(gpio_1, pigpio.FALLING_EDGE, self._cb) + + def _cb(self, gpio, level, tick): + + """ + Accumulate bits until both gpios 0 and 1 timeout. + """ + + if level < pigpio.TIMEOUT: + + if self.in_code == False: + self.bits = 1 + self.num = 0 + + self.in_code = True + self.code_timeout = 0 + self.pi.set_watchdog(self.gpio_0, self.bit_timeout) + self.pi.set_watchdog(self.gpio_1, self.bit_timeout) + else: + self.bits += 1 + self.num = self.num << 1 + + if gpio == self.gpio_0: + self.code_timeout = self.code_timeout & 2 # clear gpio 0 timeout + else: + self.code_timeout = self.code_timeout & 1 # clear gpio 1 timeout + self.num = self.num | 1 + + else: + + if self.in_code: + + if gpio == self.gpio_0: + self.code_timeout = self.code_timeout | 1 # timeout gpio 0 + else: + self.code_timeout = self.code_timeout | 2 # timeout gpio 1 + + if self.code_timeout == 3: # both gpios timed out + self.pi.set_watchdog(self.gpio_0, 0) + self.pi.set_watchdog(self.gpio_1, 0) + self.in_code = False + self.callback(self.bits, self.num) + + def cancel(self): + + """ + Cancel the Wiegand decoder. + """ + + self.cb_0.cancel() + self.cb_1.cancel() + +if __name__ == "__main__": + + import time + + import pigpio + + import wiegand + + def callback(bits, value): + print("bits={} value={}".format(bits, value)) + + pi = pigpio.pi() + + w = wiegand.decoder(pi, 14, 15, callback) + + time.sleep(300) + + w.cancel() + + pi.stop() + diff --git a/pigpio-master/EXAMPLES/Shell/GPIOTEST/README b/pigpio-master/EXAMPLES/Shell/GPIOTEST/README new file mode 100644 index 0000000..981e62e --- /dev/null +++ b/pigpio-master/EXAMPLES/Shell/GPIOTEST/README @@ -0,0 +1,7 @@ +This bash script tests the user gpios. + +Everything should be disconnected from the gpios. + +The pigpio daemon must be running (sudo pigpiod). + +Video at http://youtu.be/sCJFLKWaxHo diff --git a/pigpio-master/EXAMPLES/Shell/GPIOTEST/gpiotest b/pigpio-master/EXAMPLES/Shell/GPIOTEST/gpiotest new file mode 100644 index 0000000..b04b622 --- /dev/null +++ b/pigpio-master/EXAMPLES/Shell/GPIOTEST/gpiotest @@ -0,0 +1,126 @@ +#!/bin/bash + +skipped="" +tested="" +failed="" + +usage() +{ + cat </dev/null + +usage + +v=$(pigs hwver) + +if [[ $v < 0 ]] +then + echo "The pigpio daemon wasn't found. Did you sudo pigpiod?" + exit +fi + +echo "Testing..." + +for ((i=0; i<4; i++)) do check_gpio $i 1; done +for ((i=4; i<16; i++)) do check_gpio $i 0; done + +if [[ $v -ge 16 ]]; +then + check_gpio 16 0 +else + skipped+="16 " +fi + +for ((i=17; i<28; i++)) do check_gpio $i 0; done +for ((i=28; i<30; i++)) do check_gpio $i 1; done +for ((i=30; i<32; i++)) do check_gpio $i 0; done + +if [[ $failed = "" ]]; then failed="None"; fi + +echo "Skipped non-user gpios: $skipped" +echo "Tested user gpios: $tested" +echo "Failed user gpios: $failed" + diff --git a/pigpio-master/MakeRemote b/pigpio-master/MakeRemote new file mode 100644 index 0000000..250d40e --- /dev/null +++ b/pigpio-master/MakeRemote @@ -0,0 +1,101 @@ +# +CC = gcc +SIZE = size +SHLIB = gcc -shared +STRIPLIB = strip --strip-unneeded + +CFLAGS += -O3 -Wall -pthread + +ALL = libpigpiod_if.so libpigpiod_if2.so pigs x_pigpiod_if x_pigpiod_if2 + +prefix = /usr/local +exec_prefix = $(prefix) +bindir = $(exec_prefix)/bin +includedir = $(prefix)/include +libdir = $(prefix)/lib +mandir = $(prefix)/man + +all: $(ALL) pigpio.py setup.py + +pigpiod_if.o: pigpiod_if.c pigpio.h command.h pigpiod_if.h + $(CC) $(CFLAGS) -fpic -c -o pigpiod_if.o pigpiod_if.c + +pigpiod_if2.o: pigpiod_if2.c pigpio.h command.h pigpiod_if2.h + $(CC) $(CFLAGS) -fpic -c -o pigpiod_if2.o pigpiod_if2.c + +command.o: command.c pigpio.h command.h + $(CC) $(CFLAGS) -fpic -c -o command.o command.c + +pigs: command.o pigs.o + $(CC) $(CFLAGS) -fpic -o pigs pigs.c command.c + +x_pigpiod_if: x_pigpiod_if.o $(LIB1) + $(CC) -o x_pigpiod_if x_pigpiod_if.o $(LL1) + +x_pigpiod_if2: x_pigpiod_if2.o $(LIB2) + $(CC) -o x_pigpiod_if2 x_pigpiod_if2.o $(LL2) + +clean: + rm -f *.o *.i *.s *~ $(ALL) + +install: $(LIB1) $(LIB2) + install -m 0755 -d $(DESTDIR)$(includedir) + install -m 0644 pigpio.h $(DESTDIR)$(includedir) + install -m 0644 pigpiod_if.h $(DESTDIR)$(includedir) + install -m 0644 pigpiod_if2.h $(DESTDIR)$(includedir) + install -m 0755 -d $(DESTDIR)$(libdir) + install -m 0644 libpigpiod_if.so $(DESTDIR)$(libdir) + install -m 0644 libpigpiod_if2.so $(DESTDIR)$(libdir) + install -m 0755 -d $(DESTDIR)$(bindir) + install -m 0755 pigs $(DESTDIR)$(bindir) + python2 setup.py install + python3 setup.py install + install -m 0755 -d $(DESTDIR)$(mandir)/man1 + install -m 0644 *.1 $(DESTDIR)$(mandir)/man1 + install -m 0755 -d $(DESTDIR)$(mandir)/man3 + install -m 0644 *.3 $(DESTDIR)$(mandir)/man3 + +uninstall: + rm -f $(DESTDIR)$(includedir)/pigpio.h + rm -f $(DESTDIR)$(includedir)/pigpiod_if.h + rm -f $(DESTDIR)$(includedir)/pigpiod_if2.h + rm -f $(DESTDIR)$(libdir)/libpigpiod_if.so + rm -f $(DESTDIR)$(libdir)/libpigpiod_if2.so + echo removing python2 files + python2 setup.py install --record /tmp/pigpio >/dev/null + xargs rm -f < /tmp/pigpio >/dev/null + echo removing python3 files + python3 setup.py install --record /tmp/pigpio >/dev/null + xargs rm -f < /tmp/pigpio >/dev/null + rm -f $(DESTDIR)$(bindir)/pigs + rm -f $(DESTDIR)$(mandir)/man1/pig*.1 + rm -f $(DESTDIR)$(mandir)/man3/pig*.3 + +LL1 = -L. -lpigpiod_if -pthread -lrt +LL2 = -L. -lpigpiod_if2 -pthread -lrt + +LIB1 = libpigpiod_if.so +OBJ1 = pigpiod_if.o command.o + +LIB2 = libpigpiod_if2.so +OBJ2 = pigpiod_if2.o command.o + +$(LIB1): $(OBJ1) + $(SHLIB) -o $(LIB1) $(OBJ1) + $(STRIPLIB) $(LIB1) + $(SIZE) $(LIB1) + +$(LIB2): $(OBJ2) + $(SHLIB) -o $(LIB2) $(OBJ2) + $(STRIPLIB) $(LIB2) + $(SIZE) $(LIB2) + +# generated using gcc -MM *.c + +command.o: command.c pigpio.h command.h +pigpiod.o: pigpiod.c pigpio.h +pigpiod_if.o: pigpiod_if.c pigpio.h pigpiod_if.h command.h +pigpiod_if2.o: pigpiod_if2.c pigpio.h pigpiod_if2.h command.h +pigs.o: pigs.c pigpio.h command.h pigs.h + + diff --git a/pigpio-master/Makefile b/pigpio-master/Makefile new file mode 100644 index 0000000..0aa14fe --- /dev/null +++ b/pigpio-master/Makefile @@ -0,0 +1,164 @@ +# +# Set CROSS_PREFIX to prepend to all compiler tools at once for easier +# cross-compilation. +CROSS_PREFIX = +CC = $(CROSS_PREFIX)gcc +AR = $(CROSS_PREFIX)ar +RANLIB = $(CROSS_PREFIX)ranlib +SIZE = $(CROSS_PREFIX)size +STRIP = $(CROSS_PREFIX)strip +SHLIB = $(CC) -shared +STRIPLIB = $(STRIP) --strip-unneeded + +SOVERSION = 1 + +CFLAGS += -O3 -Wall -pthread + +LIB1 = libpigpio.so +OBJ1 = pigpio.o command.o + +LIB2 = libpigpiod_if.so +OBJ2 = pigpiod_if.o command.o + +LIB3 = libpigpiod_if2.so +OBJ3 = pigpiod_if2.o command.o + +LIB = $(LIB1) $(LIB2) $(LIB3) + +ALL = $(LIB) x_pigpio x_pigpiod_if x_pigpiod_if2 pig2vcd pigpiod pigs + +LL1 = -L. -lpigpio -pthread -lrt + +LL2 = -L. -lpigpiod_if -pthread -lrt + +LL3 = -L. -lpigpiod_if2 -pthread -lrt + +prefix = /usr/local +exec_prefix = $(prefix) +bindir = $(exec_prefix)/bin +includedir = $(prefix)/include +libdir = $(prefix)/lib +mandir = $(prefix)/man + +all: $(ALL) + +lib: $(LIB) + +pigpio.o: pigpio.c pigpio.h command.h custom.cext + $(CC) $(CFLAGS) -fpic -c -o pigpio.o pigpio.c + +pigpiod_if.o: pigpiod_if.c pigpio.h command.h pigpiod_if.h + $(CC) $(CFLAGS) -fpic -c -o pigpiod_if.o pigpiod_if.c + +pigpiod_if2.o: pigpiod_if2.c pigpio.h command.h pigpiod_if2.h + $(CC) $(CFLAGS) -fpic -c -o pigpiod_if2.o pigpiod_if2.c + +command.o: command.c pigpio.h command.h + $(CC) $(CFLAGS) -fpic -c -o command.o command.c + +x_pigpio: x_pigpio.o $(LIB1) + $(CC) -o x_pigpio x_pigpio.o $(LL1) + +x_pigpiod_if: x_pigpiod_if.o $(LIB2) + $(CC) -o x_pigpiod_if x_pigpiod_if.o $(LL2) + +x_pigpiod_if2: x_pigpiod_if2.o $(LIB3) + $(CC) -o x_pigpiod_if2 x_pigpiod_if2.o $(LL3) + +pigpiod: pigpiod.o $(LIB1) + $(CC) -o pigpiod pigpiod.o $(LL1) + $(STRIP) pigpiod + +pigs: pigs.o command.o + $(CC) -o pigs pigs.o command.o + $(STRIP) pigs + +pig2vcd: pig2vcd.o + $(CC) -o pig2vcd pig2vcd.o + $(STRIP) pig2vcd + +clean: + rm -f *.o *.i *.s *~ $(ALL) *.so.$(SOVERSION) + +ifeq ($(DESTDIR),) + PYINSTALLARGS = +else + PYINSTALLARGS = --root=$(DESTDIR) +endif + +install: $(ALL) + install -m 0755 -d $(DESTDIR)/opt/pigpio/cgi + install -m 0755 -d $(DESTDIR)$(includedir) + install -m 0644 pigpio.h $(DESTDIR)$(includedir) + install -m 0644 pigpiod_if.h $(DESTDIR)$(includedir) + install -m 0644 pigpiod_if2.h $(DESTDIR)$(includedir) + install -m 0755 -d $(DESTDIR)$(libdir) + install -m 0755 libpigpio.so.$(SOVERSION) $(DESTDIR)$(libdir) + install -m 0755 libpigpiod_if.so.$(SOVERSION) $(DESTDIR)$(libdir) + install -m 0755 libpigpiod_if2.so.$(SOVERSION) $(DESTDIR)$(libdir) + cd $(DESTDIR)$(libdir) && ln -fs libpigpio.so.$(SOVERSION) libpigpio.so + cd $(DESTDIR)$(libdir) && ln -fs libpigpiod_if.so.$(SOVERSION) libpigpiod_if.so + cd $(DESTDIR)$(libdir) && ln -fs libpigpiod_if2.so.$(SOVERSION) libpigpiod_if2.so + install -m 0755 -d $(DESTDIR)$(bindir) + install -m 0755 pig2vcd $(DESTDIR)$(bindir) + install -m 0755 pigpiod $(DESTDIR)$(bindir) + install -m 0755 pigs $(DESTDIR)$(bindir) + if which python2; then python2 setup.py install $(PYINSTALLARGS); fi + if which python3; then python3 setup.py install $(PYINSTALLARGS); fi + install -m 0755 -d $(DESTDIR)$(mandir)/man1 + install -m 0644 p*.1 $(DESTDIR)$(mandir)/man1 + install -m 0755 -d $(DESTDIR)$(mandir)/man3 + install -m 0644 p*.3 $(DESTDIR)$(mandir)/man3 +ifeq ($(DESTDIR),) + ldconfig +endif + +uninstall: + rm -f $(DESTDIR)$(includedir)/pigpio.h + rm -f $(DESTDIR)$(includedir)/pigpiod_if.h + rm -f $(DESTDIR)$(includedir)/pigpiod_if2.h + rm -f $(DESTDIR)$(libdir)/libpigpio.so + rm -f $(DESTDIR)$(libdir)/libpigpiod_if.so + rm -f $(DESTDIR)$(libdir)/libpigpiod_if2.so + rm -f $(DESTDIR)$(libdir)/libpigpio.so.$(SOVERSION) + rm -f $(DESTDIR)$(libdir)/libpigpiod_if.so.$(SOVERSION) + rm -f $(DESTDIR)$(libdir)/libpigpiod_if2.so.$(SOVERSION) + rm -f $(DESTDIR)$(bindir)/pig2vcd + rm -f $(DESTDIR)$(bindir)/pigpiod + rm -f $(DESTDIR)$(bindir)/pigs + if which python2; then python2 setup.py install $(PYINSTALLARGS) --record /tmp/pigpio >/dev/null; sed 's!^!$(DESTDIR)!' < /tmp/pigpio | xargs rm -f >/dev/null; fi + if which python3; then python3 setup.py install $(PYINSTALLARGS) --record /tmp/pigpio >/dev/null; sed 's!^!$(DESTDIR)!' < /tmp/pigpio | xargs rm -f >/dev/null; fi + rm -f $(DESTDIR)$(mandir)/man1/pig*.1 + rm -f $(DESTDIR)$(mandir)/man1/libpigpio*.1 + rm -f $(DESTDIR)$(mandir)/man3/pig*.3 +ifeq ($(DESTDIR),) + ldconfig +endif + +$(LIB1): $(OBJ1) + $(SHLIB) -pthread -Wl,-soname,$(LIB1).$(SOVERSION) -o $(LIB1).$(SOVERSION) $(OBJ1) + ln -fs $(LIB1).$(SOVERSION) $(LIB1) + $(STRIPLIB) $(LIB1) + $(SIZE) $(LIB1) + +$(LIB2): $(OBJ2) + $(SHLIB) -pthread -Wl,-soname,$(LIB2).$(SOVERSION) -o $(LIB2).$(SOVERSION) $(OBJ2) + ln -fs $(LIB2).$(SOVERSION) $(LIB2) + $(STRIPLIB) $(LIB2) + $(SIZE) $(LIB2) + +$(LIB3): $(OBJ3) + $(SHLIB) -pthread -Wl,-soname,$(LIB3).$(SOVERSION) -o $(LIB3).$(SOVERSION) $(OBJ3) + ln -fs $(LIB3).$(SOVERSION) $(LIB3) + $(STRIPLIB) $(LIB3) + $(SIZE) $(LIB3) + +# generated using gcc -MM *.c + +pig2vcd.o: pig2vcd.c pigpio.h +pigpiod.o: pigpiod.c pigpio.h +pigs.o: pigs.c pigpio.h command.h pigs.h +x_pigpio.o: x_pigpio.c pigpio.h +x_pigpiod_if.o: x_pigpiod_if.c pigpiod_if.h pigpio.h +x_pigpiod_if2.o: x_pigpiod_if2.c pigpiod_if2.h pigpio.h + diff --git a/pigpio-master/README b/pigpio-master/README new file mode 100644 index 0000000..ed453a9 --- /dev/null +++ b/pigpio-master/README @@ -0,0 +1,174 @@ +NOTE + +The initial part of the make, the compilation of pigpio.c, +takes 100 seconds on early model Pis. Be patient. The overall +install takes just over 3 minutes. + +INSTALL + +Extract the archive to a directory. + +IN THAT DIRECTORY + +Enter the following two commands (in this order) + +make +sudo make install + +This will install + +o the library (libpigpio.so) in /usr/local/lib +o the library (libpigpiod_if.so) in /usr/local/lib +o the library (libpigpiod_if2.so) in /usr/local/lib +o the header file (pigpio.h) in /usr/local/include +o the header file (pigpiod_if.h) in /usr/local/include +o the header file (pigpiod_if2.h) in /usr/local/include +o the header file (pigs.h) in /usr/local/include +o the daemon (pigpiod) in /usr/local/bin +o the socket interface (pigs) in /usr/local/bin +o the utility pig2vcd in /usr/local/bin +o man pages in /usr/local/man/man1 and /usr/local/man/man3 +o the Python module pigpio.py for Python 2 and 3 + +TEST (optional) + +*** WARNING ************************************************ +* * +* All the tests make extensive use of gpio 25 (pin 22). * +* Ensure that either nothing or just a LED is connected to * +* gpio 25 before running any of the tests. * +* * +* Some tests are statistical in nature and so may on * +* occasion fail. Repeated failures on the same test or * +* many failures in a group of tests indicate a problem. * +************************************************************ + +To test the library do + +sudo ./x_pigpio + +To test the pigpio daemon do + +sudo pigpiod + +./x_pigpiod_if # test the C I/F to the pigpio daemon +./x_pigpiod_if2 # test the C I/F to the pigpio daemon +./x_pigpio.py # test the Python I/F to the pigpio daemon +./x_pigs # test the socket I/F to the pigpio daemon +./x_pipe # test the pipe I/F to the pigpio daemon + +EXAMPLE CODE + +x_pigpio.c, pig2vcd.c, and pigpiod.c show examples of interfacing +with the pigpio library. + +pigs.c, pigpio.py, x_pigpiod_if, x_pigpiod_if2.c, x_pigpio.py, +x_pigs, and x_pipe show examples of interfacing with the pigpio +daemon. x_pipe uses the pipe interface, the others use the +socket interface. + +DAEMON + +To launch the daemon do + +sudo pigpiod (pigpiod -? for options) + +Once the daemon is launched the socket and pipe interfaces will be +available. + +When the library starts it locks + +/var/run/pigpio.pid + +The file should be automatically deleted when the library terminates. + +SOCKET INTERFACE + +Use pigs for the socket interface (pigs help for help). + +PIPE INTERFACE + +The pipe interface accepts commands written to /dev/pigpio. + +Results are read from /dev/pigout. + +Errors are output on /dev/pigerr. + +To test the pipe interface perhaps do + +cat /dev/pigout & +cat /dev/pigerr & + +echo "help" >/dev/pigpio + +PYTHON MODULE + +The Python pigpio module is installed to the default Python location +for Python 2 and Python 3. + +You can install it for additional Python versions by + +pythonx.y setup.py install + +where x.y is the Python version. + +STOP DAEMON + +To stop the pigpiod daemon + +sudo killall pigpiod + +RUNNING ON NON Pi's + +You can access the pigpiod daemon running on the Pi from any machine which +is connected to it over the network. This access is via the socket interface. + +In particular this allows you to use the following on non-Pi's. + +o pigs +o the pigpio Python module +o the C socket I/F using libpigpiod_if (header file pigpiod_if.h) +o the C socket I/F using libpigpiod_if2 (header file pigpiod_if2.h) + +On a Linux machine + +make -f MakeRemote clean +make -f MakeRemote +make -f MakeRemote install + +This will install + +o the library (libpigpiod_if.so) in /usr/local/lib +o the library (libpigpiod_if2.so) in /usr/local/lib +o the header file (pigpio.h) in /usr/local/include +o the header file (pigpiod_if.h) in /usr/local/include +o the header file (pigpiod_if2.h) in /usr/local/include +o the socket interface (pigs) in /usr/local/bin +o man pages in /usr/local/man/man1 and /usr/local/man/man3 +o the Python module pigpio.py + +On Windows machines (and possibly Macs) + +The Python module should install with + +python setup.py install + +pigs, pigpiod_if, and pigpiod_if2 will need minor mods to +reflect the Windows/Mac socket interface. + +DOCUMENTATION + +The most up to date should be http://abyz.me.uk/rpi/pigpio/ + +On the Pi try + +man pigs +man pigpiod +man pig2vcd + +man pigpio +man pigpiod_if +man pigpiod_if2 + +pydoc pigpio + diff --git a/pigpio-master/README.md b/pigpio-master/README.md new file mode 100644 index 0000000..e326fca --- /dev/null +++ b/pigpio-master/README.md @@ -0,0 +1,76 @@ +# pigpio + +pigpio is a C library for the Raspberry which allows control of the +General Purpose Input Outputs (GPIO). + +## Features + +* Sampling and time-stamping of GPIO 0-31 between 100,000 and 1,000,000 times per second +* Provision of PWM on any number of the user GPIO simultaneously +* Provision of servo pulses on any number of the user GPIO simultaneously +* Callbacks when any of GPIO 0-31 change state (callbacks receive the time of the event + accurate to a few microseconds) +* Notifications via pipe when any of GPIO 0-31 change state +* Callbacks at timed intervals +* Reading/writing all of the GPIO in a bank (0-31, 32-53) as a single operation +* Individually setting GPIO modes, reading and writing +* Socket and pipe interfaces for the bulk of the functionality in addition to the + underlying C library calls +* Construction of arbitrary waveforms to give precise timing of output GPIO + level changes (accurate to a few microseconds) +* Software serial links, I2C, and SPI using any user GPIO +* Rudimentary permission control through the socket and pipe interfaces so users + can be prevented from "updating" inappropriate GPIO +* Creating and running scripts on the pigpio daemon + +## Interfaces + +The library provides a number of control interfaces +* the C function interface, +* the /dev/pigpio pipe interface, +* the socket interface (used by the pigs utility and the Python module). + +## Utilities + +A number of utility programs are provided: +* the pigpiod daemon, +* the Python module, +* the piscope digital waveform viewer, +* the pigs command line utility, +* the pig2vcd utility which converts notifications into the value change dump (VCD) + format (useful for viewing digital waveforms with GTKWave). + +## Documentation + +See http://abyz.me.uk/rpi/pigpio/ + +## Example programs + +See http://abyz.me.uk/rpi/pigpio/examples.html + +## GPIO + +ALL GPIO are identified by their Broadcom number. See http://elinux.org. + +There are 54 GPIO in total, arranged in two banks. + +Bank 1 contains GPIO 0-31. Bank 2 contains GPIO 32-54. + +A user should only manipulate GPIO in bank 1. + +There are at least three types of board: +* Type 1 + * 26 pin header (P1) + * Hardware revision numbers of 2 and 3 + * User GPIO 0-1, 4, 7-11, 14-15, 17-18, 21-25 +* Type 2 + * 26 pin header (P1) and an additional 8 pin header (P5) + * Hardware revision numbers of 4, 5, 6, and 15 + * User GPIO 2-4, 7-11, 14-15, 17-18, 22-25, 27-31 +* Type 3 + * 40 pin expansion header (J8) + * Hardware revision numbers of 16 or greater + * User GPIO 2-27 (0 and 1 are reserved) + +It is safe to read all the GPIO. If you try to write a system GPIO or change +its mode you can crash the Pi or corrupt the data on the SD card. diff --git a/pigpio-master/SUPPORT.md b/pigpio-master/SUPPORT.md new file mode 100644 index 0000000..c9a5eda --- /dev/null +++ b/pigpio-master/SUPPORT.md @@ -0,0 +1,8 @@ +Questions about the pigpio library are welcome but we ask that you check these resources first: +* [pigpio library web page](http://abyz.me.uk/rpi/pigpio) +Noobs should start with the FAQ. All +APIs are documented extensively. +* Search the repository issues with a 'question' label +For example, to search for information on PWM type in search box: +`label:question pwm` +* Check the repository's Wiki - WIP, help wanted. diff --git a/pigpio-master/UNLICENCE b/pigpio-master/UNLICENCE new file mode 100644 index 0000000..471f09f --- /dev/null +++ b/pigpio-master/UNLICENCE @@ -0,0 +1,25 @@ +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to + diff --git a/pigpio-master/cmake/FindRT.cmake b/pigpio-master/cmake/FindRT.cmake new file mode 100644 index 0000000..db7c4de --- /dev/null +++ b/pigpio-master/cmake/FindRT.cmake @@ -0,0 +1,39 @@ +# FindRT.cmake - Try to find the RT library +# Once done this will define +# +# RT_FOUND - System has rt +# RT_INCLUDE_DIR - The rt include directory +# RT_LIBRARIES - The libraries needed to use rt +# RT_DEFINITIONS - Compiler switches required for using rt +# +# Also creates an import target called RT::RT + +find_path (RT_INCLUDE_DIR NAMES time.h + PATHS + /usr + /usr/local + /opt + PATH_SUFFIXES +) + +find_library(RT_LIBRARIES NAMES rt + PATHS + /usr + /usr/local + /opt +) + +include(FindPackageHandleStandardArgs) + +FIND_PACKAGE_HANDLE_STANDARD_ARGS(rt DEFAULT_MSG RT_LIBRARIES RT_INCLUDE_DIR) + +mark_as_advanced(RT_INCLUDE_DIR RT_LIBRARIES) + +if (NOT TARGET RT::RT) + add_library(RT::RT INTERFACE IMPORTED) + + set_target_properties(RT::RT PROPERTIES + INTERFACE_INCLUDE_DIRECTORIES ${RT_INCLUDE_DIR} + INTERFACE_LINK_LIBRARIES ${RT_LIBRARIES} + ) +endif() \ No newline at end of file diff --git a/pigpio-master/cmake/pigpioConfig.cmake b/pigpio-master/cmake/pigpioConfig.cmake new file mode 100644 index 0000000..7912526 --- /dev/null +++ b/pigpio-master/cmake/pigpioConfig.cmake @@ -0,0 +1 @@ +include (${CMAKE_CURRENT_LIST_DIR}/pigpioTargets.cmake) \ No newline at end of file diff --git a/pigpio-master/cmake/setup.py.in b/pigpio-master/cmake/setup.py.in new file mode 100644 index 0000000..a5913a2 --- /dev/null +++ b/pigpio-master/cmake/setup.py.in @@ -0,0 +1,24 @@ +#!/usr/bin/env python + +from distutils.core import setup + +setup(name='pigpio', + version='1.44', + author='joan', + author_email='joan@abyz.me.uk', + maintainer='joan', + maintainer_email='joan@abyz.me.uk', + url='http://abyz.me.uk/rpi/pigpio/python.html', + description='Raspberry Pi GPIO module', + long_description='Raspberry Pi Python module to access the pigpio daemon', + download_url='http://abyz.me.uk/rpi/pigpio/pigpio.zip', + license='unlicense.org', + py_modules=['pigpio'], + keywords=['raspberrypi', 'gpio',], + classifiers=[ + "Programming Language :: Python :: 2", + "Programming Language :: Python :: 3", + ], + package_dir={ '': '${CMAKE_CURRENT_SOURCE_DIR}'} + ) + diff --git a/pigpio-master/command.c b/pigpio-master/command.c new file mode 100644 index 0000000..ffc3463 --- /dev/null +++ b/pigpio-master/command.c @@ -0,0 +1,1422 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* +This version is for pigpio version 70+ +*/ + +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" +#include "command.h" + +cmdInfo_t cmdInfo[]= +{ + /* num str vfyt retv script*/ + + {PI_CMD_BC1, "BC1", 111, 1, 1}, // gpioWrite_Bits_0_31_Clear + {PI_CMD_BC2, "BC2", 111, 1, 1}, // gpioWrite_Bits_32_53_Clear + + {PI_CMD_BI2CC, "BI2CC", 112, 0, 1}, // bbI2CClose + {PI_CMD_BI2CO, "BI2CO", 131, 0, 1}, // bbI2COpen + {PI_CMD_BI2CZ, "BI2CZ", 193, 6, 0}, // bbI2CZip + + {PI_CMD_BR1, "BR1", 101, 3, 1}, // gpioRead_Bits_0_31 + {PI_CMD_BR2, "BR2", 101, 3, 1}, // gpioRead_Bits_32_53 + + {PI_CMD_BS1, "BS1", 111, 1, 1}, // gpioWrite_Bits_0_31_Set + {PI_CMD_BS2, "BS2", 111, 1, 1}, // gpioWrite_Bits_32_53_Set + + {PI_CMD_BSCX, "BSCX", 193, 8, 0}, // bscXfer + + {PI_CMD_BSPIC, "BSPIC", 112, 0, 1}, // bbSPIClose + {PI_CMD_BSPIO, "BSPIO", 134, 0, 0}, // bbSPIOpen + {PI_CMD_BSPIX, "BSPIX", 193, 6, 0}, // bbSPIXfer + + {PI_CMD_CF1, "CF1", 195, 2, 0}, // gpioCustom1 + {PI_CMD_CF2, "CF2", 195, 6, 0}, // gpioCustom2 + + {PI_CMD_CGI, "CGI", 101, 4, 1}, // gpioCfgGetInternals + {PI_CMD_CSI, "CSI", 111, 1, 1}, // gpioCfgSetInternals + + {PI_CMD_EVM, "EVM", 122, 1, 1}, // eventMonitor + {PI_CMD_EVT, "EVT", 112, 0, 1}, // eventTrigger + + {PI_CMD_FC, "FC", 112, 0, 1}, // fileClose + + {PI_CMD_FG, "FG", 121, 0, 1}, // gpioGlitchFilter + + {PI_CMD_FL, "FL", 127, 6, 0}, // fileList + + {PI_CMD_FN, "FN", 131, 0, 1}, // gpioNoiseFilter + + {PI_CMD_FO, "FO", 127, 2, 0}, // fileOpen + {PI_CMD_FR, "FR", 121, 6, 0}, // fileRead + {PI_CMD_FS, "FS", 133, 2, 1}, // fileSeek + {PI_CMD_FW, "FW", 193, 0, 0}, // fileWrite + + {PI_CMD_GDC, "GDC", 112, 2, 1}, // gpioGetPWMdutycycle + {PI_CMD_GPW, "GPW", 112, 2, 1}, // gpioGetServoPulsewidth + + {PI_CMD_HELP, "H", 101, 5, 0}, // cmdUsage + {PI_CMD_HELP, "HELP", 101, 5, 0}, // cmdUsage + + {PI_CMD_HC, "HC", 121, 0, 1}, // gpioHardwareClock + {PI_CMD_HP, "HP", 131, 0, 1}, // gpioHardwarePWM + + {PI_CMD_HWVER, "HWVER", 101, 4, 1}, // gpioHardwareRevision + + {PI_CMD_I2CC, "I2CC", 112, 0, 1}, // i2cClose + {PI_CMD_I2CO, "I2CO", 131, 2, 1}, // i2cOpen + + {PI_CMD_I2CPC, "I2CPC", 131, 2, 1}, // i2cProcessCall + {PI_CMD_I2CPK, "I2CPK", 194, 6, 0}, // i2cBlockProcessCall + + {PI_CMD_I2CRB, "I2CRB", 121, 2, 1}, // i2cReadByteData + {PI_CMD_I2CRD, "I2CRD", 121, 6, 0}, // i2cReadDevice + {PI_CMD_I2CRI, "I2CRI", 131, 6, 0}, // i2cReadI2CBlockData + {PI_CMD_I2CRK, "I2CRK", 121, 6, 0}, // i2cReadBlockData + {PI_CMD_I2CRS, "I2CRS", 112, 2, 1}, // i2cReadByte + {PI_CMD_I2CRW, "I2CRW", 121, 2, 1}, // i2cReadWordData + + {PI_CMD_I2CWB, "I2CWB", 131, 0, 1}, // i2cWriteByteData + {PI_CMD_I2CWD, "I2CWD", 193, 0, 0}, // i2cWriteDevice + {PI_CMD_I2CWI, "I2CWI", 194, 0, 0}, // i2cWriteI2CBlockData + {PI_CMD_I2CWK, "I2CWK", 194, 0, 0}, // i2cWriteBlockData + {PI_CMD_I2CWQ, "I2CWQ", 121, 0, 1}, // i2cWriteQuick + {PI_CMD_I2CWS, "I2CWS", 121, 0, 1}, // i2cWriteByte + {PI_CMD_I2CWW, "I2CWW", 131, 0, 1}, // i2cWriteWordData + + {PI_CMD_I2CZ, "I2CZ", 193, 6, 0}, // i2cZip + + {PI_CMD_MICS, "MICS", 112, 0, 1}, // gpioDelay + {PI_CMD_MILS, "MILS", 112, 0, 1}, // gpioDelay + + {PI_CMD_MODEG, "MG" , 112, 2, 1}, // gpioGetMode + {PI_CMD_MODEG, "MODEG", 112, 2, 1}, // gpioGetMode + + {PI_CMD_MODES, "M", 125, 0, 1}, // gpioSetMode + {PI_CMD_MODES, "MODES", 125, 0, 1}, // gpioSetMode + + {PI_CMD_NB, "NB", 122, 0, 1}, // gpioNotifyBegin + {PI_CMD_NC, "NC", 112, 0, 1}, // gpioNotifyClose + {PI_CMD_NO, "NO", 101, 2, 1}, // gpioNotifyOpen + {PI_CMD_NP, "NP", 112, 0, 1}, // gpioNotifyPause + + {PI_CMD_PADG, "PADG", 112, 2, 1}, // gpioGetPad + {PI_CMD_PADS, "PADS", 121, 0, 1}, // gpioSetPad + + {PI_CMD_PARSE, "PARSE", 115, 0, 0}, // cmdParseScript + + {PI_CMD_PFG, "PFG", 112, 2, 1}, // gpioGetPWMfrequency + {PI_CMD_PFS, "PFS", 121, 2, 1}, // gpioSetPWMfrequency + + {PI_CMD_PIGPV, "PIGPV", 101, 4, 1}, // gpioVersion + + {PI_CMD_PRG, "PRG", 112, 2, 1}, // gpioGetPWMrange + + {PI_CMD_PROC, "PROC", 115, 2, 0}, // gpioStoreScript + {PI_CMD_PROCD, "PROCD", 112, 0, 0}, // gpioDeleteScript + {PI_CMD_PROCP, "PROCP", 112, 7, 0}, // gpioScriptStatus + {PI_CMD_PROCR, "PROCR", 191, 0, 0}, // gpioRunScript + {PI_CMD_PROCS, "PROCS", 112, 0, 0}, // gpioStopScript + {PI_CMD_PROCU, "PROCU", 191, 0, 0}, // gpioUpdateScript + + {PI_CMD_PRRG, "PRRG", 112, 2, 1}, // gpioGetPWMrealRange + {PI_CMD_PRS, "PRS", 121, 2, 1}, // gpioSetPWMrange + + {PI_CMD_PUD, "PUD", 126, 0, 1}, // gpioSetPullUpDown + + {PI_CMD_PWM, "P", 121, 0, 1}, // gpioPWM + {PI_CMD_PWM, "PWM", 121, 0, 1}, // gpioPWM + + {PI_CMD_READ, "R", 112, 2, 1}, // gpioRead + {PI_CMD_READ, "READ", 112, 2, 1}, // gpioRead + + {PI_CMD_SERC, "SERC", 112, 0, 1}, // serClose + {PI_CMD_SERDA, "SERDA", 112, 2, 1}, // serDataAvailable + {PI_CMD_SERO, "SERO", 132, 2, 0}, // serOpen + {PI_CMD_SERR, "SERR", 121, 6, 0}, // serRead + {PI_CMD_SERRB, "SERRB", 112, 2, 1}, // serReadByte + {PI_CMD_SERW, "SERW", 193, 0, 0}, // serWrite + {PI_CMD_SERWB, "SERWB", 121, 0, 1}, // serWriteByte + + {PI_CMD_SERVO, "S", 121, 0, 1}, // gpioServo + {PI_CMD_SERVO, "SERVO", 121, 0, 1}, // gpioServo + + {PI_CMD_SHELL, "SHELL", 128, 2, 0}, // shell + + {PI_CMD_SLR, "SLR", 121, 6, 0}, // gpioSerialRead + {PI_CMD_SLRC, "SLRC", 112, 0, 1}, // gpioSerialReadClose + {PI_CMD_SLRO, "SLRO", 131, 0, 1}, // gpioSerialReadOpen + {PI_CMD_SLRI, "SLRI", 121, 0, 1}, // gpioSerialReadInvert + + {PI_CMD_SPIC, "SPIC", 112, 0, 1}, // spiClose + {PI_CMD_SPIO, "SPIO", 131, 2, 1}, // spiOpen + {PI_CMD_SPIR, "SPIR", 121, 6, 0}, // spiRead + {PI_CMD_SPIW, "SPIW", 193, 0, 0}, // spiWrite + {PI_CMD_SPIX, "SPIX", 193, 6, 0}, // spiXfer + + {PI_CMD_TICK, "T", 101, 4, 1}, // gpioTick + {PI_CMD_TICK, "TICK", 101, 4, 1}, // gpioTick + + {PI_CMD_TRIG, "TRIG", 131, 0, 1}, // gpioTrigger + + {PI_CMD_WDOG, "WDOG", 121, 0, 1}, // gpioSetWatchdog + + {PI_CMD_WRITE, "W", 121, 0, 1}, // gpioWrite + {PI_CMD_WRITE, "WRITE", 121, 0, 1}, // gpioWrite + + {PI_CMD_WVAG, "WVAG", 192, 2, 0}, // gpioWaveAddGeneric + {PI_CMD_WVAS, "WVAS", 196, 2, 0}, // gpioWaveAddSerial + {PI_CMD_WVBSY, "WVBSY", 101, 2, 1}, // gpioWaveTxBusy + {PI_CMD_WVCHA, "WVCHA", 197, 0, 0}, // gpioWaveChain + {PI_CMD_WVCLR, "WVCLR", 101, 0, 1}, // gpioWaveClear + {PI_CMD_WVCRE, "WVCRE", 101, 2, 1}, // gpioWaveCreate + {PI_CMD_WVCAP, "WVCAP", 112, 2, 1}, // gpioWaveCreatePad + {PI_CMD_WVDEL, "WVDEL", 112, 0, 1}, // gpioWaveDelete + {PI_CMD_WVGO, "WVGO" , 101, 2, 0}, // gpioWaveTxStart + {PI_CMD_WVGOR, "WVGOR", 101, 2, 0}, // gpioWaveTxStart + {PI_CMD_WVHLT, "WVHLT", 101, 0, 1}, // gpioWaveTxStop + {PI_CMD_WVNEW, "WVNEW", 101, 0, 1}, // gpioWaveAddNew + {PI_CMD_WVSC, "WVSC", 112, 2, 1}, // gpioWaveGet*Cbs + {PI_CMD_WVSM, "WVSM", 112, 2, 1}, // gpioWaveGet*Micros + {PI_CMD_WVSP, "WVSP", 112, 2, 1}, // gpioWaveGet*Pulses + {PI_CMD_WVTAT, "WVTAT", 101, 2, 1}, // gpioWaveTxAt + {PI_CMD_WVTX, "WVTX", 112, 2, 1}, // gpioWaveTxSend + {PI_CMD_WVTXM, "WVTXM", 121, 2, 1}, // gpioWaveTxSend + {PI_CMD_WVTXR, "WVTXR", 112, 2, 1}, // gpioWaveTxSend + + {PI_CMD_ADD , "ADD" , 111, 0, 1}, + {PI_CMD_AND , "AND" , 111, 0, 1}, + {PI_CMD_CALL , "CALL" , 114, 0, 1}, + {PI_CMD_CMDR ,"CMDR" , 111, 0, 1}, + {PI_CMD_CMDW , "CMDW" , 111, 0, 1}, + {PI_CMD_CMP , "CMP" , 111, 0, 1}, + {PI_CMD_DCR , "DCR" , 113, 0, 1}, + {PI_CMD_DCRA , "DCRA" , 101, 0, 1}, + {PI_CMD_DIV , "DIV" , 111, 0, 1}, + {PI_CMD_EVTWT, "EVTWT", 111, 0, 1}, + {PI_CMD_HALT , "HALT" , 101, 0, 1}, + {PI_CMD_INR , "INR" , 113, 0, 1}, + {PI_CMD_INRA , "INRA" , 101, 0, 1}, + {PI_CMD_JM , "JM" , 114, 0, 1}, + {PI_CMD_JMP , "JMP" , 114, 0, 1}, + {PI_CMD_JNZ , "JNZ" , 114, 0, 1}, + {PI_CMD_JP , "JP" , 114, 0, 1}, + {PI_CMD_JZ , "JZ" , 114, 0, 1}, + {PI_CMD_LD , "LD" , 123, 0, 1}, + {PI_CMD_LDA , "LDA" , 111, 0, 1}, + {PI_CMD_LDAB , "LDAB" , 111, 0, 1}, + {PI_CMD_MLT , "MLT" , 111, 0, 1}, + {PI_CMD_MOD , "MOD" , 111, 0, 1}, + {PI_CMD_NOP , "NOP" , 101, 0, 1}, + {PI_CMD_OR , "OR" , 111, 0, 1}, + {PI_CMD_POP , "POP" , 113, 0, 1}, + {PI_CMD_POPA , "POPA" , 101, 0, 1}, + {PI_CMD_PUSH , "PUSH" , 113, 0, 1}, + {PI_CMD_PUSHA, "PUSHA", 101, 0, 1}, + {PI_CMD_RET , "RET" , 101, 0, 1}, + {PI_CMD_RL , "RL" , 123, 0, 1}, + {PI_CMD_RLA , "RLA" , 111, 0, 1}, + {PI_CMD_RR , "RR" , 123, 0, 1}, + {PI_CMD_RRA , "RRA" , 111, 0, 1}, + {PI_CMD_STA , "STA" , 113, 0, 1}, + {PI_CMD_STAB , "STAB" , 111, 0, 1}, + {PI_CMD_SUB , "SUB" , 111, 0, 1}, + {PI_CMD_SYS , "SYS" , 116, 0, 1}, + {PI_CMD_TAG , "TAG" , 114, 0, 1}, + {PI_CMD_WAIT , "WAIT" , 111, 0, 1}, + {PI_CMD_X , "X" , 124, 0, 1}, + {PI_CMD_XA , "XA" , 113, 0, 1}, + {PI_CMD_XOR , "XOR" , 111, 0, 1}, + +}; + + +char * cmdUsage = "\n\ +BC1 bits Clear GPIO in bank 1\n\ +BC2 bits Clear GPIO in bank 2\n\ +BI2CC sda Close bit bang I2C\n\ +BI2CO sda scl baud | Open bit bang I2C\n\ +BI2CZ sda ... I2C bit bang multiple transactions\n\ +\n\ +BSPIC cs Close bit bang SPI\n\ +BSPIO cs miso mosi sclk baud flag | Open bit bang SPI\n\ +BSPIX cs ... SPI bit bang transfer\n\ +\n\ +BR1 Read bank 1 GPIO\n\ +BR2 Read bank 2 GPIO\n\ +\n\ +BS1 bits Set GPIO in bank 1\n\ +BS2 bits Set GPIO in bank 2\n\ +\n\ +BSCX bctl bvs BSC I2C/SPI transfer\n\ +\n\ +CF1 ... Custom function 1\n\ +CF2 ... Custom function 2\n\ +\n\ +CGI Configuration get internals\n\ +CSI v Configuration set internals\n\ +\n\ +EVM h bits Set events to monitor\n\ +EVT n Trigger event\n\ +\n\ +FC h Close file handle\n\ +FG g steady Set glitch filter on GPIO\n\ +FL pat n List files which match pattern\n\ +FN g steady active | Set noise filter on GPIO\n\ +FO file mode Open a file in mode\n\ +FR h n Read bytes from file handle\n\ +FS h n from Seek to file handle position\n\ +FW h ... Write bytes to file handle\n\ +\n\ +GDC g Get PWM dutycycle for GPIO\n\ +GPW g Get servo pulsewidth for GPIO\n\ +\n\ +H/HELP Display command help\n\ +HC g f Set hardware clock frequency\n\ +HP g f dc Set hardware PWM frequency and dutycycle\n\ +HWVER Get hardware version\n\ +\n\ +I2CC h Close I2C handle\n\ +I2CO bus device flags | Open I2C bus and device with flags\n\ +I2CPC h r word SMBus Process Call: exchange register with word\n\ +I2CPK h r ... SMBus Block Process Call: exchange data bytes with register\n\ +I2CRB h r SMBus Read Byte Data: read byte from register\n\ +I2CRD h n I2C Read bytes\n\ +I2CRI h r n SMBus Read I2C Block Data: read bytes from register\n\ +I2CRK h r SMBus Read Block Data: read data from register\n\ +I2CRS h SMBus Read Byte: read byte\n\ +I2CRW h r SMBus Read Word Data: read word from register\n\ +I2CWB h r byte SMBus Write Byte Data: write byte to register\n\ +I2CWD h ... I2C Write data\n\ +I2CWI h r ... SMBus Write I2C Block Data\n\ +I2CWK h r ... SMBus Write Block Data: write data to register\n\ +I2CWQ h b SMBus Write Quick: write bit\n\ +I2CWS h b SMBus Write Byte: write byte\n\ +I2CWW h r word SMBus Write Word Data: write word to register\n\ +I2CZ h ... I2C multiple transactions\n\ +\n\ +M/MODES g mode Set GPIO mode\n\ +MG/MODEG g Get GPIO mode\n\ +MICS n Delay for microseconds\n\ +MILS n Delay for milliseconds\n\ +\n\ +NB h bits Start notification\n\ +NC h Close notification\n\ +NO Request a notification\n\ +NP h Pause notification\n\ +\n\ +P/PWM g v Set GPIO PWM value\n\ +PADG pad Get pad drive strength\n\ +PADS pad v Set pad drive strength\n\ +PARSE text Validate script\n\ +PFG g Get GPIO PWM frequency\n\ +PFS g v Set GPIO PWM frequency\n\ +PIGPV Get pigpio library version\n\ +PRG g Get GPIO PWM range\n\ +PROC text Store script\n\ +PROCD sid Delete script\n\ +PROCP sid Get script status and parameters\n\ +PROCR sid ... Run script\n\ +PROCS sid Stop script\n\ +PROCU sid ... Set script parameters\n\ +PRRG g Get GPIO PWM real range\n\ +PRS g v Set GPIO PWM range\n\ +PUD g pud Set GPIO pull up/down\n\ +\n\ +R/READ g Read GPIO level\n\ +\n\ +S/SERVO g v Set GPIO servo pulsewidth\n\ +SERC h Close serial handle\n\ +SERDA h Check for serial data ready to read\n\ +SERO text baud flags | Open serial device at baud with flags\n\ +SERR h n Read bytes from serial handle\n\ +SERRB h Read byte from serial handle\n\ +SERW h ... Write bytes to serial handle\n\ +SERWB h byte Write byte to serial handle\n\ +SHELL name str Execute a shell command\n\ +SLR g v Read bit bang serial data from GPIO\n\ +SLRC g Close GPIO for bit bang serial data\n\ +SLRO g baud bitlen | Open GPIO for bit bang serial data\n\ +SLRI g invert Invert serial logic (1 invert, 0 normal)\n\ +SPIC h SPI close handle\n\ +SPIO channel baud flags | SPI open channel at baud with flags\n\ +SPIR h v SPI read bytes from handle\n\ +SPIW h ... SPI write bytes to handle\n\ +SPIX h ... SPI transfer bytes to handle\n\ +\n\ +T/TICK Get current tick\n\ +TRIG g micros l Trigger level for micros on GPIO\n\ +\n\ +W/WRITE g l Write level to GPIO\n\ +WDOG g millis Set millisecond watchdog on GPIO\n\ +WVAG triplets Wave add generic pulses\n\ +WVAS g baud bitlen stopbits offset ... | Wave add serial data\n\ +WVBSY Check if wave busy\n\ +WVCHA Transmit a chain of waves\n\ +WVCLR Wave clear\n\ +WVCRE Create wave from added pulses\n\ +WVDEL wid Delete waves w and higher\n\ +WVGO Wave transmit (DEPRECATED)\n\ +WVGOR Wave transmit repeatedly (DEPRECATED)\n\ +WVHLT Wave stop\n\ +WVNEW Start a new empty wave\n\ +WVSC 0,1,2 Wave get DMA control block stats\n\ +WVSM 0,1,2 Wave get micros stats\n\ +WVSP 0,1,2 Wave get pulses stats\n\ +WVTAT Returns the current transmitting wave\n\ +WVTX wid Transmit wave as one-shot\n\ +WVTXM wid wmde Transmit wave using mode\n\ +WVTXR wid Transmit wave repeatedly\n\ +\n\ +Numbers may be entered as hex (prefix 0x), octal (prefix 0),\n\ +otherwise they are assumed to be decimal.\n\ +\n\ +Examples\n\ +\n\ +pigs w 4 1 # set GPIO 4 high\n\ +pigs r 5 # read GPIO 5\n\ +pigs t # get current tick\n\ +pigs i2co 1 0x20 0 # get handle to device 0x20 on I2C bus 1\n\ +\n\ +man pigs for full details.\n\ +\n"; + +typedef struct +{ + int error; + char * str; +} errInfo_t; + +static errInfo_t errInfo[]= +{ + {PI_INIT_FAILED , "pigpio initialisation failed"}, + {PI_BAD_USER_GPIO , "GPIO not 0-31"}, + {PI_BAD_GPIO , "GPIO not 0-53"}, + {PI_BAD_MODE , "mode not 0-7"}, + {PI_BAD_LEVEL , "level not 0-1"}, + {PI_BAD_PUD , "pud not 0-2"}, + {PI_BAD_PULSEWIDTH , "pulsewidth not 0 or 500-2500"}, + {PI_BAD_DUTYCYCLE , "dutycycle not 0-range (default 255)"}, + {PI_BAD_TIMER , "timer not 0-9"}, + {PI_BAD_MS , "ms not 10-60000"}, + {PI_BAD_TIMETYPE , "timetype not 0-1"}, + {PI_BAD_SECONDS , "seconds < 0"}, + {PI_BAD_MICROS , "micros not 0-999999"}, + {PI_TIMER_FAILED , "gpioSetTimerFunc failed"}, + {PI_BAD_WDOG_TIMEOUT , "timeout not 0-60000"}, + {PI_NO_ALERT_FUNC , "DEPRECATED"}, + {PI_BAD_CLK_PERIPH , "clock peripheral not 0-1"}, + {PI_BAD_CLK_SOURCE , "DEPRECATED"}, + {PI_BAD_CLK_MICROS , "clock micros not 1, 2, 4, 5, 8, or 10"}, + {PI_BAD_BUF_MILLIS , "buf millis not 100-10000"}, + {PI_BAD_DUTYRANGE , "dutycycle range not 25-40000"}, + {PI_BAD_SIGNUM , "signum not 0-63"}, + {PI_BAD_PATHNAME , "can't open pathname"}, + {PI_NO_HANDLE , "no handle available"}, + {PI_BAD_HANDLE , "unknown handle"}, + {PI_BAD_IF_FLAGS , "ifFlags > 4"}, + {PI_BAD_CHANNEL , "DMA channel not 0-14"}, + {PI_BAD_SOCKET_PORT , "socket port not 1024-30000"}, + {PI_BAD_FIFO_COMMAND , "unknown fifo command"}, + {PI_BAD_SECO_CHANNEL , "DMA secondary channel not 0-14"}, + {PI_NOT_INITIALISED , "function called before gpioInitialise"}, + {PI_INITIALISED , "function called after gpioInitialise"}, + {PI_BAD_WAVE_MODE , "waveform mode not 0-1"}, + {PI_BAD_CFG_INTERNAL , "bad parameter in gpioCfgInternals call"}, + {PI_BAD_WAVE_BAUD , "baud rate not 50-250K(RX)/50-1M(TX)"}, + {PI_TOO_MANY_PULSES , "waveform has too many pulses"}, + {PI_TOO_MANY_CHARS , "waveform has too many chars"}, + {PI_NOT_SERIAL_GPIO , "no bit bang serial read in progress on GPIO"}, + {PI_BAD_SERIAL_STRUC , "bad (null) serial structure parameter"}, + {PI_BAD_SERIAL_BUF , "bad (null) serial buf parameter"}, + {PI_NOT_PERMITTED , "no permission to update GPIO"}, + {PI_SOME_PERMITTED , "no permission to update one or more GPIO"}, + {PI_BAD_WVSC_COMMND , "bad WVSC subcommand"}, + {PI_BAD_WVSM_COMMND , "bad WVSM subcommand"}, + {PI_BAD_WVSP_COMMND , "bad WVSP subcommand"}, + {PI_BAD_PULSELEN , "trigger pulse length not 1-100"}, + {PI_BAD_SCRIPT , "invalid script"}, + {PI_BAD_SCRIPT_ID , "unknown script id"}, + {PI_BAD_SER_OFFSET , "add serial data offset > 30 minute"}, + {PI_GPIO_IN_USE , "GPIO already in use"}, + {PI_BAD_SERIAL_COUNT , "must read at least a byte at a time"}, + {PI_BAD_PARAM_NUM , "script parameter id not 0-9"}, + {PI_DUP_TAG , "script has duplicate tag"}, + {PI_TOO_MANY_TAGS , "script has too many tags"}, + {PI_BAD_SCRIPT_CMD , "illegal script command"}, + {PI_BAD_VAR_NUM , "script variable id not 0-149"}, + {PI_NO_SCRIPT_ROOM , "no more room for scripts"}, + {PI_NO_MEMORY , "can't allocate temporary memory"}, + {PI_SOCK_READ_FAILED , "socket read failed"}, + {PI_SOCK_WRIT_FAILED , "socket write failed"}, + {PI_TOO_MANY_PARAM , "too many script parameters (> 10)"}, + {PI_SCRIPT_NOT_READY , "script initialising"}, + {PI_BAD_TAG , "script has unresolved tag"}, + {PI_BAD_MICS_DELAY , "bad MICS delay (too large)"}, + {PI_BAD_MILS_DELAY , "bad MILS delay (too large)"}, + {PI_BAD_WAVE_ID , "non existent wave id"}, + {PI_TOO_MANY_CBS , "No more CBs for waveform"}, + {PI_TOO_MANY_OOL , "No more OOL for waveform"}, + {PI_EMPTY_WAVEFORM , "attempt to create an empty waveform"}, + {PI_NO_WAVEFORM_ID , "no more waveform ids"}, + {PI_I2C_OPEN_FAILED , "can't open I2C device"}, + {PI_SER_OPEN_FAILED , "can't open serial device"}, + {PI_SPI_OPEN_FAILED , "can't open SPI device"}, + {PI_BAD_I2C_BUS , "bad I2C bus"}, + {PI_BAD_I2C_ADDR , "bad I2C address"}, + {PI_BAD_SPI_CHANNEL , "bad SPI channel"}, + {PI_BAD_FLAGS , "bad i2c/spi/ser open flags"}, + {PI_BAD_SPI_SPEED , "bad SPI speed"}, + {PI_BAD_SER_DEVICE , "bad serial device name"}, + {PI_BAD_SER_SPEED , "bad serial baud rate"}, + {PI_BAD_PARAM , "bad i2c/spi/ser parameter"}, + {PI_I2C_WRITE_FAILED , "I2C write failed"}, + {PI_I2C_READ_FAILED , "I2C read failed"}, + {PI_BAD_SPI_COUNT , "bad SPI count"}, + {PI_SER_WRITE_FAILED , "ser write failed"}, + {PI_SER_READ_FAILED , "ser read failed"}, + {PI_SER_READ_NO_DATA , "ser read no data available"}, + {PI_UNKNOWN_COMMAND , "unknown command"}, + {PI_SPI_XFER_FAILED , "spi xfer/read/write failed"}, + {PI_BAD_POINTER , "bad (NULL) pointer"}, + {PI_NO_AUX_SPI , "no auxiliary SPI on Pi A or B"}, + {PI_NOT_PWM_GPIO , "GPIO is not in use for PWM"}, + {PI_NOT_SERVO_GPIO , "GPIO is not in use for servo pulses"}, + {PI_NOT_HCLK_GPIO , "GPIO has no hardware clock"}, + {PI_NOT_HPWM_GPIO , "GPIO has no hardware PWM"}, + {PI_BAD_HPWM_FREQ , "invalid hardware PWM frequency"}, + {PI_BAD_HPWM_DUTY , "hardware PWM dutycycle not 0-1M"}, + {PI_BAD_HCLK_FREQ , "invalid hardware clock frequency"}, + {PI_BAD_HCLK_PASS , "need password to use hardware clock 1"}, + {PI_HPWM_ILLEGAL , "illegal, PWM in use for main clock"}, + {PI_BAD_DATABITS , "serial data bits not 1-32"}, + {PI_BAD_STOPBITS , "serial (half) stop bits not 2-8"}, + {PI_MSG_TOOBIG , "socket/pipe message too big"}, + {PI_BAD_MALLOC_MODE , "bad memory allocation mode"}, + {PI_TOO_MANY_SEGS , "too many I2C transaction segments"}, + {PI_BAD_I2C_SEG , "an I2C transaction segment failed"}, + {PI_BAD_SMBUS_CMD , "SMBus command not supported by driver"}, + {PI_NOT_I2C_GPIO , "no bit bang I2C in progress on GPIO"}, + {PI_BAD_I2C_WLEN , "bad I2C write length"}, + {PI_BAD_I2C_RLEN , "bad I2C read length"}, + {PI_BAD_I2C_CMD , "bad I2C command"}, + {PI_BAD_I2C_BAUD , "bad I2C baud rate, not 50-500k"}, + {PI_CHAIN_LOOP_CNT , "bad chain loop count"}, + {PI_BAD_CHAIN_LOOP , "empty chain loop"}, + {PI_CHAIN_COUNTER , "too many chain counters"}, + {PI_BAD_CHAIN_CMD , "bad chain command"}, + {PI_BAD_CHAIN_DELAY , "bad chain delay micros"}, + {PI_CHAIN_NESTING , "chain counters nested too deeply"}, + {PI_CHAIN_TOO_BIG , "chain is too long"}, + {PI_DEPRECATED , "deprecated function removed"}, + {PI_BAD_SER_INVERT , "bit bang serial invert not 0 or 1"}, + {PI_BAD_EDGE , "bad ISR edge, not 1, 1, or 2"}, + {PI_BAD_ISR_INIT , "bad ISR initialisation"}, + {PI_BAD_FOREVER , "loop forever must be last chain command"}, + {PI_BAD_FILTER , "bad filter parameter"}, + {PI_BAD_PAD , "bad pad number"}, + {PI_BAD_STRENGTH , "bad pad drive strength"}, + {PI_FIL_OPEN_FAILED , "file open failed"}, + {PI_BAD_FILE_MODE , "bad file mode"}, + {PI_BAD_FILE_FLAG , "bad file flag"}, + {PI_BAD_FILE_READ , "bad file read"}, + {PI_BAD_FILE_WRITE , "bad file write"}, + {PI_FILE_NOT_ROPEN , "file not open for read"}, + {PI_FILE_NOT_WOPEN , "file not open for write"}, + {PI_BAD_FILE_SEEK , "bad file seek"}, + {PI_NO_FILE_MATCH , "no files match pattern"}, + {PI_NO_FILE_ACCESS , "no permission to access file"}, + {PI_FILE_IS_A_DIR , "file is a directory"}, + {PI_BAD_SHELL_STATUS , "bad shell return status"}, + {PI_BAD_SCRIPT_NAME , "bad script name"}, + {PI_BAD_SPI_BAUD , "bad SPI baud rate, not 50-500k"}, + {PI_NOT_SPI_GPIO , "no bit bang SPI in progress on GPIO"}, + {PI_BAD_EVENT_ID , "bad event id"}, + {PI_CMD_INTERRUPTED , "command interrupted, Python"}, + {PI_NOT_ON_BCM2711 , "not available on BCM2711"}, + {PI_ONLY_ON_BCM2711 , "only available on BCM2711"}, + +}; + +static char * fmtMdeStr="RW540123"; +static char * fmtPudStr="ODU"; + +static int cmdMatch(char *str) +{ + int i; + + for (i=0; i<(sizeof(cmdInfo)/sizeof(cmdInfo_t)); i++) + { + if (strcasecmp(str, cmdInfo[i].name) == 0) return i; + } + return CMD_UNKNOWN_CMD; +} + +static int getNum(char *str, uintptr_t *val, int8_t *opt) +{ + int f, n; + intmax_t v; + + *opt = 0; + + f = sscanf(str, " %ji %n", &v, &n); + + if (f == 1) + { + *val = v; + *opt = CMD_NUMERIC; + return n; + } + + f = sscanf(str, " v%ji %n", &v, &n); + + if (f == 1) + { + *val = v; + if (v < PI_MAX_SCRIPT_VARS) *opt = CMD_VAR; + else *opt = -CMD_VAR; + return n; + } + + f = sscanf(str, " p%ji %n", &v, &n); + + if (f == 1) + { + *val = v; + if (v < PI_MAX_SCRIPT_PARAMS) *opt = CMD_PAR; + else *opt = -CMD_PAR; + return n; + } + + return 0; +} + +static char intCmdStr[32]; +static int intCmdIdx; + +char *cmdStr(void) +{ + return intCmdStr; +} + +int cmdParse( + char *buf, uintptr_t *p, unsigned ext_len, char *ext, cmdCtlParse_t *ctl) +{ + int f, valid, idx, val, pp, pars, n, n2; + char *p8; + int32_t *p32; + char c; + uintptr_t tp1=0, tp2=0, tp3=0, tp4=0, tp5=0; + int8_t to1, to2, to3, to4, to5; + int eaten; + + /* Check that ext is big enough for the largest message. */ + if (ext_len < (4 * CMD_MAX_PARAM)) return CMD_EXT_TOO_SMALL; + + bzero(&ctl->opt, sizeof(ctl->opt)); + + sscanf(buf+ctl->eaten, " %31s %n", intCmdStr, &pp); + + ctl->eaten += pp; + + p[0] = -1; + + idx = cmdMatch(intCmdStr); + + intCmdIdx = idx; + + if (idx < 0) return idx; + + valid = 0; + + p[0] = cmdInfo[idx].cmd; + p[1] = 0; + p[2] = 0; + p[3] = 0; + + switch (cmdInfo[idx].vt) + { + case 101: /* BR1 BR2 CGI H HELP HWVER + DCRA HALT INRA NO + PIGPV POPA PUSHA RET T TICK WVBSY WVCLR + WVCRE WVGO WVGOR WVHLT WVNEW + + No parameters, always valid. + */ + valid = 1; + + break; + + case 111: /* ADD AND BC1 BC2 BS1 BS2 + CMP CSI DIV LDA LDAB MLT + MOD OR RLA RRA STAB SUB WAIT XOR + + One parameter, any value. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if (ctl->opt[1] > 0) valid = 1; + + break; + + case 112: /* BI2CC FC GDC GPW I2CC I2CRB + MG MICS MILS MODEG NC NP PADG PFG PRG + PROCD PROCP PROCS PRRG R READ SLRC SPIC + WVCAP WVDEL WVSC WVSM WVSP WVTX WVTXR BSPIC + + One positive parameter. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0)) valid = 1; + + break; + + case 113: /* DCR INR POP PUSH STA XA + + One register parameter. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if ((ctl->opt[1] > 0) && (p[1] < PI_MAX_SCRIPT_VARS)) valid = 1; + + break; + + case 114: /* CALL JM JMP JNZ JP JZ TAG + + One numeric parameter, any value. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + if (ctl->opt[1] == CMD_NUMERIC) valid = 1; + + break; + + case 115: /* PARSE PROC + + One parameter, string (rest of input). + */ + p[3] = strlen(buf+ctl->eaten); + memcpy(ext, buf+ctl->eaten, p[3]); + ctl->eaten += p[3]; + valid = 1; + + break; + + case 116: /* SYS + + One parameter, a string. + */ + f = sscanf(buf+ctl->eaten, " %*s%n %n", &n, &n2); + if ((f >= 0) && n) + { + p[3] = n; + ctl->opt[3] = CMD_NUMERIC; + memcpy(ext, buf+ctl->eaten, n); + ctl->eaten += n2; + valid = 1; + } + + break; + + case 121: /* HC FR I2CRD I2CRR I2CRW I2CWB I2CWQ P + PADS PFS PRS PWM S SERVO SLR SLRI W + WDOG WRITE WVTXM + + Two positive parameters. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (ctl->opt[2] > 0) && ((int)p[2] >= 0)) valid = 1; + + break; + + case 122: /* NB + + Two parameters, first positive, second any value. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (ctl->opt[2] > 0)) valid = 1; + + break; + + case 123: /* LD RL RR + + Two parameters, first register, second any value. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] > 0) && + (p[1] < PI_MAX_SCRIPT_VARS) && + (ctl->opt[2] > 0)) valid = 1; + + break; + + case 124: /* X + + Two register parameters. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] > 0) && (p[1] < PI_MAX_SCRIPT_VARS) && + (ctl->opt[2] > 0) && (p[2] < PI_MAX_SCRIPT_VARS)) valid = 1; + + break; + + case 125: /* M MODES + + Two parameters, first positive, second in 'RW540123'. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + f = sscanf(buf+ctl->eaten, " %c %n", &c, &n); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && (f >= 1)) + { + ctl->eaten += n; + val = toupper(c); + p8 = strchr(fmtMdeStr, val); + + if (p8 != NULL) + { + val = p8 - fmtMdeStr; + p[2] = val; + valid = 1; + } + } + + break; + + case 126: /* PUD + + Two parameters, first positive, second in 'ODU'. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + f = sscanf(buf+ctl->eaten, " %c %n", &c, &n); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && (f >= 1)) + { + ctl->eaten += n; + val = toupper(c); + p8 = strchr(fmtPudStr, val); + if (p8 != NULL) + { + val = p8 - fmtPudStr; + p[2] = val; + valid = 1; + } + } + + break; + + case 127: /* FL FO + + Two parameters, first a string, other positive. + */ + f = sscanf(buf+ctl->eaten, " %*s%n %n", &n, &n2); + if ((f >= 0) && n) + { + p[3] = n; + ctl->opt[2] = CMD_NUMERIC; + memcpy(ext, buf+ctl->eaten, n); + ctl->eaten += n2; + + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0)) + valid = 1; + } + + break; + + case 128: /* SHELL + + Two string parameters, the first space teminated. + The second arbitrary. + */ + f = sscanf(buf+ctl->eaten, " %*s%n %n", &n, &n2); + + if ((f >= 0) && n) + { + valid = 1; + + p[1] = n; + memcpy(ext, buf+ctl->eaten, n); + ctl->eaten += n; + ext[n] = 0; /* terminate first string */ + + n2 = strlen(buf+ctl->eaten+1); + memcpy(ext+n+1, buf+ctl->eaten+1, n2); + ctl->eaten += n2; + ctl->eaten ++; + p[3] = p[1] + n2 + 1; + } + + break; + + case 131: /* BI2CO HP I2CO I2CPC I2CRI I2CWB I2CWW + SLRO SPIO TRIG + + Three positive parameters. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &ctl->opt[3]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (ctl->opt[2] > 0) && ((int)p[2] >= 0) && + (ctl->opt[3] > 0) && ((int)tp1 >= 0)) + { + p[3] = 4; + memcpy(ext, &tp1, 4); + valid = 1; + } + + break; + + case 132: /* SERO + + Three parameters, first a string, rest >=0 + */ + f = sscanf(buf+ctl->eaten, " %*s%n %n", &n, &n2); + if ((f >= 0) && n) + { + p[3] = n; + ctl->opt[2] = CMD_NUMERIC; + memcpy(ext, buf+ctl->eaten, n); + ctl->eaten += n2; + + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (ctl->opt[2] > 0) && ((int)p[2] >= 0)) + valid = 1; + } + + break; + + case 133: /* FS + + Three parameters. First and third positive. + Second may be negative when interpreted as an int. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &to1); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (ctl->opt[2] > 0) && + (to1 == CMD_NUMERIC) && ((int)tp1 >= 0)) + { + p[3] = 4; + memcpy(ext, &tp1, 4); + valid = 1; + } + + break; + + case 134: /* BSPIO + + Six parameters. First to Fifth positive. + Sixth may be negative when interpreted as an int. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &to1); + ctl->eaten += getNum(buf+ctl->eaten, &tp2, &to2); + ctl->eaten += getNum(buf+ctl->eaten, &tp3, &to3); + ctl->eaten += getNum(buf+ctl->eaten, &tp4, &to4); + ctl->eaten += getNum(buf+ctl->eaten, &tp5, &to5); + + if ((ctl->opt[1] > 0) && ((int)p[1] >= 0) && + (to1 == CMD_NUMERIC) && ((int)tp1 >= 0) && + (to2 == CMD_NUMERIC) && ((int)tp2 >= 0) && + (to3 == CMD_NUMERIC) && ((int)tp3 >= 0) && + (to4 == CMD_NUMERIC) && ((int)tp4 >= 0) && + (to5 == CMD_NUMERIC)) + { + p[3] = 5 * 4; + memcpy(ext+ 0, &tp1, 4); + memcpy(ext+ 4, &tp2, 4); + memcpy(ext+ 8, &tp3, 4); + memcpy(ext+12, &tp4, 4); + memcpy(ext+16, &tp5, 4); + valid = 1; + } + + break; + + case 191: /* PROCR PROCU + + One to 11 parameters, first positive, + optional remainder, any value. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if ((ctl->opt[1] == CMD_NUMERIC) && ((int)p[1] >= 0)) + { + pars = 0; + p32 = (int32_t *)ext; + + while (pars < PI_MAX_SCRIPT_PARAMS) + { + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + pars++; + *p32++ = tp1; + } + else break; + } + + p[3] = pars * 4; + + valid = 1; + } + + break; + + case 192: /* WVAG + + One or more triplets (gpios on, gpios off, delay), + any value. + */ + + pars = 0; + p32 = (int32_t *)ext; + + while (pars < CMD_MAX_PARAM) + { + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + pars++; + *p32++ = tp1; + } + else break; + } + + p[3] = pars * 4; + + if (pars && ((pars % 3) == 0)) valid = 1; + + break; + + case 193: /* BI2CZ BSCX BSPIX FW I2CWD I2CZ SERW + SPIW SPIX + + Two or more parameters, first >=0, rest 0-255. + + BSCX is special case one or more. + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if ((ctl->opt[1] == CMD_NUMERIC) && ((int)p[1] >= 0)) + { + pars = 0; + p8 = ext; + + while (pars < CMD_MAX_PARAM) + { + eaten = getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + if (((int)tp1>=0) && ((int)tp1<=255)) + { + pars++; + *p8++ = tp1; + ctl->eaten += eaten; + } + else break; /* invalid number, end of command */ + } + else break; + } + + p[3] = pars; + + if (pars || (p[0]==PI_CMD_BSCX)) valid = 1; + } + + break; + + case 194: /* I2CPK I2CWI I2CWK + + Three to 34 parameters, all 0-255. + */ + + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if ((ctl->opt[1] == CMD_NUMERIC) && + (ctl->opt[2] == CMD_NUMERIC) && + ((int)p[1]>=0) && ((int)p[2]>=0) && ((int)p[2]<=255)) + { + pars = 0; + p8 = ext; + + while (pars < 32) + { + eaten = getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + if (((int)tp1>=0) && ((int)tp1<=255)) + { + pars++; + *p8++ = tp1; + ctl->eaten += eaten; + } + else break; /* invalid number, end of command */ + } + else break; + } + + p[3] = pars; + + if (pars > 0) valid = 1; + } + + break; + + case 195: /* CF1 CF2 + + Zero or more parameters, first two >=0, rest 0-255. + */ + valid = 1; + + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + + if (ctl->opt[1] == CMD_NUMERIC) + { + if ((int)p[1] >= 0) + { + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + + if (ctl->opt[2] == CMD_NUMERIC) + { + if ((int)p[2] >= 0) + { + pars = 0; + p8 = ext; + + while (pars < CMD_MAX_PARAM) + { + eaten = getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + if (((int)tp1>=0) && ((int)tp1<=255)) + { + pars++; + *p8++ = tp1; + ctl->eaten += eaten; + } + else break; + } + else break; + } + + p[3] = pars; + } + else valid = 0; + } + } + else valid = 0; + } + + break; + + case 196: /* WVAS + + gpio baud offset char... + + p1 gpio + p2 baud + p3 len + 4 + --------- + uint32_t databits + uint32_t stophalfbits + uint32_t offset + uint8_t[len] + */ + ctl->eaten += getNum(buf+ctl->eaten, &p[1], &ctl->opt[1]); + ctl->eaten += getNum(buf+ctl->eaten, &p[2], &ctl->opt[2]); + ctl->eaten += getNum(buf+ctl->eaten, &tp1, &to1); + ctl->eaten += getNum(buf+ctl->eaten, &tp2, &to2); + ctl->eaten += getNum(buf+ctl->eaten, &tp3, &to3); + + if ((ctl->opt[1] == CMD_NUMERIC) && ((int)p[1] >= 0) && + (ctl->opt[2] == CMD_NUMERIC) && ((int)p[2] > 0) && + (to1 == CMD_NUMERIC) && + (to2 == CMD_NUMERIC) && + (to3 == CMD_NUMERIC)) + { + pars = 0; + + memcpy(ext, &tp1, 4); + memcpy(ext+4, &tp2, 4); + memcpy(ext+8, &tp3, 4); + p8 = ext + 12; + while (pars < CMD_MAX_PARAM) + { + eaten = getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + if (((int)tp1>=0) && ((int)tp1<=255)) + { + *p8++ = tp1; + pars++; + ctl->eaten += eaten; + } + else break; /* invalid number, end of command */ + } + else break; + } + + p[3] = pars + 12; + + if (pars > 0) valid = 1; + } + + break; + + case 197: /* WVCHA + + One or more parameters, all 0-255. + */ + pars = 0; + p8 = ext; + + while (pars < CMD_MAX_PARAM) + { + eaten = getNum(buf+ctl->eaten, &tp1, &to1); + if (to1 == CMD_NUMERIC) + { + if (((int)tp1>=0) && ((int)tp1<=255)) + { + pars++; + *p8++ = tp1; + ctl->eaten += eaten; + } + else break; /* invalid number, end of command */ + } + else break; + } + + p[3] = pars; + + if (pars) valid = 1; + + break; + + + } + + if (valid) return idx; else return CMD_BAD_PARAMETER; +} + +char * cmdErrStr(int error) +{ + int i; + + for (i=0; i<(sizeof(errInfo)/sizeof(errInfo_t)); i++) + { + if (errInfo[i].error == error) return errInfo[i].str; + } + return "unknown error"; +} + +int cmdParseScript(char *script, cmdScript_t *s, int diags) +{ + int idx, len, b, i, j, tags, resolved; + int status; + uintptr_t p[10]; + cmdInstr_t instr; + cmdCtlParse_t ctl; + char v[CMD_MAX_EXTENSION]; + + ctl.eaten = 0; + + status = 0; + + cmdTagStep_t tag_step[PI_MAX_SCRIPT_TAGS]; + + len = strlen(script); + + /* calloc space for PARAMS, VARS, CMDS, and STRINGS */ + + b = (sizeof(int) * (PI_MAX_SCRIPT_PARAMS + PI_MAX_SCRIPT_VARS)) + + (sizeof(cmdInstr_t) * (len + 2) / 2) + len; + + s->par = calloc(1, b); + + if (s->par == NULL) return -1; + + s->var = s->par + PI_MAX_SCRIPT_PARAMS; + + s->instr = (cmdInstr_t *)(s->var + PI_MAX_SCRIPT_VARS); + + s->str_area = (char *)(s->instr + ((len + 2) / 2)); + + s->str_area_len = len; + s->str_area_pos = 0; + + s->instrs = 0; + + tags = 0; + + idx = 0; + + while (ctl.eaten= 0) || (idx != CMD_UNKNOWN_CMD)) + { + if (!cmdInfo[intCmdIdx].cvis) idx = CMD_NOT_IN_SCRIPT; + } + + if (idx >= 0) + { + if (p[3]) + { + memcpy(s->str_area + s->str_area_pos, v, p[3]); + s->str_area[s->str_area_pos + p[3]] = 0; + p[4] = (intptr_t) s->str_area + s->str_area_pos; + s->str_area_pos += (p[3] + 1); + } + + memcpy(&instr.p, p, sizeof(instr.p)); + + if (instr.p[0] == PI_CMD_TAG) + { + if (tags < PI_MAX_SCRIPT_TAGS) + { + /* check tag not already used */ + for (j=0; jinstrs; + tags++; + } + else + { + if (diags) + { + fprintf(stderr, "Too many tags: %"PRIdPTR"\n", instr.p[1]); + } + if (!status) status = PI_TOO_MANY_TAGS; + idx = -1; + } + } + } + else + { + if (diags) + { + if (idx == CMD_UNKNOWN_CMD) + fprintf(stderr, "Unknown command: %s\n", cmdStr()); + else if (idx == CMD_NOT_IN_SCRIPT) + fprintf(stderr, "Command illegal in script: %s\n", cmdStr()); + else + fprintf(stderr, "Bad parameter to %s\n", cmdStr()); + } + if (!status) status = PI_BAD_SCRIPT_CMD; + } + + if (idx >= 0) + { + if (instr.p[0] != PI_CMD_TAG) + { + memcpy(instr.opt, &ctl.opt, sizeof(instr.opt)); + s->instr[s->instrs++] = instr; + } + } + } + + for (i=0; iinstrs; i++) + { + instr = s->instr[i]; + + /* resolve jumps */ + + if ((instr.p[0] == PI_CMD_JMP) || (instr.p[0] == PI_CMD_CALL) || + (instr.p[0] == PI_CMD_JZ) || (instr.p[0] == PI_CMD_JNZ) || + (instr.p[0] == PI_CMD_JM) || (instr.p[0] == PI_CMD_JP)) + { + resolved = 0; + + for (j=0; jinstr[i].p[1] = tag_step[j].step; + resolved = 1; + break; + } + } + + if (!resolved) + { + if (diags) + { + fprintf(stderr, "Can't resolve tag %"PRIdPTR"\n", instr.p[1]); + } + if (!status) status = PI_BAD_TAG; + } + } + } + return status; +} + diff --git a/pigpio-master/command.h b/pigpio-master/command.h new file mode 100644 index 0000000..3e5c336 --- /dev/null +++ b/pigpio-master/command.h @@ -0,0 +1,124 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* +This version is for pigpio version 70+ +*/ + +#ifndef COMMAND_H +#define COMMAND_H + +#include +#include + +#include "pigpio.h" + +#define CMD_MAX_PARAM 512 +#define CMD_MAX_EXTENSION (1<<16) + +#define CMD_UNKNOWN_CMD -1 +#define CMD_BAD_PARAMETER -2 +#define CMD_EXT_TOO_SMALL -3 +#define CMD_NOT_IN_SCRIPT -4 + +#define CMD_P_ARR 10 +#define CMD_V_ARR 10 + +#define CMD_NUMERIC 1 +#define CMD_VAR 2 +#define CMD_PAR 3 + +typedef struct +{ + uint32_t cmd; + uint32_t p1; + uint32_t p2; + union + { + uint32_t p3; + uint32_t ext_len; + uint32_t res; + }; +} cmdCmd_t; + +typedef struct +{ + int eaten; + int8_t opt[4]; +} cmdCtlParse_t; + +typedef struct +{ + int cmd; /* command number */ + char *name; /* command name */ + int vt; /* command verification type */ + int rv; /* command return value type */ + int cvis; /* command valid in a script */ +} cmdInfo_t; + +typedef struct +{ + uint32_t tag; + int step; +} cmdTagStep_t; + +typedef struct +{ + uintptr_t p[5]; //these are sometimes converted to pointers, so presumablly they sometimes have pointers stored in them, I haven't figured out where though. --plugwash + int8_t opt[4]; +} cmdInstr_t; + +typedef struct +{ + /* + +-----------+---------+---------+----------------+ + | PARAMS... | VARS... | CMDS... | STRING AREA... | + +-----------+---------+---------+----------------+ + */ + int *par; + int *var; + cmdInstr_t *instr; + int instrs; + char *str_area; + int str_area_len; + int str_area_pos; +} cmdScript_t; + +extern cmdInfo_t cmdInfo[]; + +extern char *cmdUsage; + +int cmdParse(char *buf, uintptr_t *p, unsigned ext_len, char *ext, cmdCtlParse_t *ctl); + +int cmdParseScript(char *script, cmdScript_t *s, int diags); + +char *cmdErrStr(int error); + +char *cmdStr(void); + +#endif + diff --git a/pigpio-master/custom.cext b/pigpio-master/custom.cext new file mode 100644 index 0000000..905884d --- /dev/null +++ b/pigpio-master/custom.cext @@ -0,0 +1,54 @@ +/* +This version is for pigpio version 26+ + +If you want customised functions replace this file with your own +definitions for gpioCustom1 and gpioCustom2. +*/ + +#include "pigpio.h" + +int gpioCustom1(unsigned arg1, unsigned arg2, char *argx, unsigned count) +{ + int i; + unsigned max; + + DBG(DBG_USER, "arg1=%d arg2=%d count=%d [%s]", + arg1, arg2, count, myBuf2Str(count, argx)); + + CHECK_INITED; + + /* for dummy just return max parameter */ + + if (arg1 > arg2) max = arg1; else max = arg2; + + for (i=0; i max) max = argx[i]; + + return max; +} + + +int gpioCustom2(unsigned arg1, char *argx, unsigned count, + char *retBuf, unsigned retMax) +{ + int i, j, t; + + DBG(DBG_USER, "arg1=%d count=%d [%s] retMax=%d", + arg1, count, myBuf2Str(count, argx), retMax); + + CHECK_INITED; + + /* for dummy just return argx reversed */ + + if (count > retMax) count = retMax; + + for (i=0, j=count-1; i<=j; i++, j--) + { + /* t used as argx and retBuf may be the same buffer */ + t = argx[i]; + retBuf[i] = argx[j]; + retBuf[j] = t; + } + + return count; +} + diff --git a/pigpio-master/pig2vcd.1 b/pigpio-master/pig2vcd.1 new file mode 100644 index 0000000..eacce19 --- /dev/null +++ b/pigpio-master/pig2vcd.1 @@ -0,0 +1,246 @@ + +." Process this file with +." groff -man -Tascii pig2vcd.1 +." +.TH pig2vcd 1 2012-2020 Linux "pigpio archive" +.SH NAME +pig2vd - A utility to convert pigpio notifications to VCD. + +.SH SYNOPSIS + +pig2vcd file.VCD +.SH DESCRIPTION + + +.ad l + +.nh +pig2vcd is a utility which reads notifications on stdin and writes the +output as a Value Change Dump (VCD) file on stdout. + +.br + +.br +The VCD file can be viewed using GTKWave. + +.br + +.br +.SS Notifications +.br + +.br +Notifications consist of 12 bytes with the following binary format. + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint16_t seqno; +.br + uint16_t flags; +.br + uint32_t tick; +.br + uint32_t level; +.br +} gpioReport_t; +.br + +.EE + +.br + +.br +seqno: starts at 0 each time the handle is opened and then increments by one for each report. + +.br + +.br +flags: two flags are defined, PI_NTFY_FLAGS_WDOG and PI_NTFY_FLAGS_ALIVE. If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags indicate a gpio which has had a watchdog timeout; if bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive signal on the pipe/socket and is sent once a minute in the absence of other notification activity. + +.br + +.br +tick: the number of microseconds since system boot. It wraps around after 1h12m. + +.br + +.br +level: indicates the level of each gpio. If bit 1< +*/ + +/* +This version is for pigpio version 3+ +*/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" + +/* +This software converts pigpio notification reports +into a VCD format understood by GTKWave. +*/ + +#define RS (sizeof(gpioReport_t)) + +static char * timeStamp() +{ + static char buf[32]; + + struct timeval now; + struct tm tmp; + + gettimeofday(&now, NULL); + + localtime_r(&now.tv_sec, &tmp); + strftime(buf, sizeof(buf), "%F %T", &tmp); + + return buf; +} + +int symbol(int bit) +{ + if (bit < 26) return ('A' + bit); + else return ('a' + bit - 26); +} + +int main(int argc, char * argv[]) +{ + int b, r, v; + uint32_t t0; + uint32_t lastLevel, changed; + + gpioReport_t report; + + r=read(STDIN_FILENO, &report, RS); + + if (r != RS) exit(-1); + + printf("$date %s $end\n", timeStamp()); + printf("$version pig2vcd V1 $end\n"); + printf("$timescale 1 us $end\n"); + printf("$scope module top $end\n"); + + for (b=0; b<32; b++) + printf("$var wire 1 %c %d $end\n", symbol(b), b); + + printf("$upscope $end\n"); + printf("$enddefinitions $end\n"); + + t0 = report.tick; + lastLevel =0; + + while ((r=read(STDIN_FILENO, &report, RS)) == RS) + { + if (report.level != lastLevel) + { + printf("#%u\n", report.tick - t0); + + changed = report.level ^ lastLevel; + + lastLevel = report.level; + + for (b=0; b<32; b++) + { + if (changed & (1< + + +gcc -Wall -pthread -o prog prog.c -lpigpio -lrt + +sudo ./prog +.SH DESCRIPTION + + +.ad l + +.nh + +.br + +.br +pigpio is a C library for the Raspberry which allows control of the GPIO. + +.br + +.br +.SS Features +.br + +.br +o hardware timed PWM on any of GPIO 0-31 + +.br + +.br +o hardware timed servo pulses on any of GPIO 0-31 + +.br + +.br +o callbacks when any of GPIO 0-31 change state + +.br + +.br +o callbacks at timed intervals + +.br + +.br +o reading/writing all of the GPIO in a bank as one operation + +.br + +.br +o individually setting GPIO modes, reading and writing + +.br + +.br +o notifications when any of GPIO 0-31 change state + +.br + +.br +o the construction of output waveforms with microsecond timing + +.br + +.br +o rudimentary permission control over GPIO + +.br + +.br +o a simple interface to start and stop new threads + +.br + +.br +o I2C, SPI, and serial link wrappers + +.br + +.br +o creating and running scripts + +.br + +.br +.SS GPIO +.br + +.br +ALL GPIO are identified by their Broadcom number. + +.br + +.br +.SS Credits +.br + +.br +The PWM and servo pulses are timed using the DMA and PWM peripherals. + +.br + +.br +This use was inspired by Richard Hirst's servoblaster kernel module. + +.br + +.br +.SS Usage +.br + +.br +Include in your source files. + +.br + +.br +Assuming your source is in prog.c use the following command to build and +run the executable. + +.br + +.br + +.EX +gcc -Wall -pthread -o prog prog.c -lpigpio -lrt +.br +sudo ./prog +.br + +.EE + +.br + +.br +For examples of usage see the C programs within the pigpio archive file. + +.br + +.br +.SS Notes +.br + +.br +All the functions which return an int return < 0 on error. + +.br + +.br +\fBgpioInitialise\fP must be called before all other library functions +with the following exceptions: + +.br + +.br + +.EX +\fBgpioCfg*\fP +.br +\fBgpioVersion\fP +.br +\fBgpioHardwareRevision\fP +.br + +.EE + +.br + +.br +If the library is not initialised all but the \fBgpioCfg*\fP, +\fBgpioVersion\fP, and \fBgpioHardwareRevision\fP functions will +return error PI_NOT_INITIALISED. + +.br + +.br +If the library is initialised the \fBgpioCfg*\fP functions will return +error PI_INITIALISED. + +.br + +.br +If you intend to rely on signals sent to your application, you should +turn off the internal signal handling as shown in this example: + +.br + +.br + +.EX +int cfg = gpioCfgGetInternals(); +.br +cfg |= PI_CFG_NOSIGHANDLER; // (1<<10) +.br +gpioCfgSetInternals(cfg); +.br +int status = gpioInitialise(); +.br + +.EE + +.br + +.br + +.SH OVERVIEW + +.br +.SS ESSENTIAL +.br + +.br +gpioInitialise Initialise library +.br +gpioTerminate Stop library +.br +.SS BASIC +.br + +.br +gpioSetMode Set a GPIO mode +.br +gpioGetMode Get a GPIO mode +.br + +.br +gpioSetPullUpDown Set/clear GPIO pull up/down resistor +.br + +.br +gpioRead Read a GPIO +.br +gpioWrite Write a GPIO +.br +.SS PWM (overrides servo commands on same GPIO) +.br + +.br +gpioPWM Start/stop PWM pulses on a GPIO +.br +gpioSetPWMfrequency Configure PWM frequency for a GPIO +.br +gpioSetPWMrange Configure PWM range for a GPIO +.br + +.br +gpioGetPWMdutycycle Get dutycycle setting on a GPIO +.br +gpioGetPWMfrequency Get configured PWM frequency for a GPIO +.br +gpioGetPWMrange Get configured PWM range for a GPIO +.br + +.br +gpioGetPWMrealRange Get underlying PWM range for a GPIO +.br +.SS Servo (overrides PWM commands on same GPIO) +.br + +.br +gpioServo Start/stop servo pulses on a GPIO +.br + +.br +gpioGetServoPulsewidth Get pulsewidth setting on a GPIO +.br +.SS INTERMEDIATE +.br + +.br +gpioTrigger Send a trigger pulse to a GPIO +.br + +.br +gpioSetWatchdog Set a watchdog on a GPIO +.br + +.br +gpioRead_Bits_0_31 Read all GPIO in bank 1 +.br +gpioRead_Bits_32_53 Read all GPIO in bank 2 +.br + +.br +gpioWrite_Bits_0_31_Clear Clear selected GPIO in bank 1 +.br +gpioWrite_Bits_32_53_Clear Clear selected GPIO in bank 2 +.br + +.br +gpioWrite_Bits_0_31_Set Set selected GPIO in bank 1 +.br +gpioWrite_Bits_32_53_Set Set selected GPIO in bank 2 +.br + +.br +gpioSetAlertFunc Request a GPIO level change callback +.br +gpioSetAlertFuncEx Request a GPIO change callback, extended +.br + +.br +gpioSetTimerFunc Request a regular timed callback +.br +gpioSetTimerFuncEx Request a regular timed callback, extended +.br + +.br +gpioStartThread Start a new thread +.br +gpioStopThread Stop a previously started thread +.br +.SS ADVANCED +.br + +.br +gpioNotifyOpen Request a notification handle +.br +gpioNotifyClose Close a notification +.br +gpioNotifyOpenWithSize Request a notification with sized pipe +.br +gpioNotifyBegin Start notifications for selected GPIO +.br +gpioNotifyPause Pause notifications +.br + +.br +gpioHardwareClock Start hardware clock on supported GPIO +.br + +.br +gpioHardwarePWM Start hardware PWM on supported GPIO +.br + +.br +gpioGlitchFilter Set a glitch filter on a GPIO +.br +gpioNoiseFilter Set a noise filter on a GPIO +.br + +.br +gpioSetPad Sets a pads drive strength +.br +gpioGetPad Gets a pads drive strength +.br + +.br +shell Executes a shell command +.br + +.br +gpioSetISRFunc Request a GPIO interrupt callback +.br +gpioSetISRFuncEx Request a GPIO interrupt callback, extended +.br + +.br +gpioSetSignalFunc Request a signal callback +.br +gpioSetSignalFuncEx Request a signal callback, extended +.br + +.br +gpioSetGetSamplesFunc Requests a GPIO samples callback +.br +gpioSetGetSamplesFuncEx Requests a GPIO samples callback, extended +.br +.SS Custom +.br + +.br +gpioCustom1 User custom function 1 +.br +gpioCustom2 User custom function 2 +.br +.SS Events +.br + +.br +eventMonitor Sets the events to monitor +.br +eventSetFunc Request an event callback +.br +eventSetFuncEx Request an event callback, extended +.br + +.br +eventTrigger Trigger an event +.br +.SS Scripts +.br + +.br +gpioStoreScript Store a script +.br +gpioRunScript Run a stored script +.br +gpioUpdateScript Set a scripts parameters +.br +gpioScriptStatus Get script status and parameters +.br +gpioStopScript Stop a running script +.br +gpioDeleteScript Delete a stored script +.br +.SS I2C +.br + +.br +i2cOpen Opens an I2C device +.br +i2cClose Closes an I2C device +.br + +.br +i2cWriteQuick SMBus write quick +.br + +.br +i2cReadByte SMBus read byte +.br +i2cWriteByte SMBus write byte +.br + +.br +i2cReadByteData SMBus read byte data +.br +i2cWriteByteData SMBus write byte data +.br + +.br +i2cReadWordData SMBus read word data +.br +i2cWriteWordData SMBus write word data +.br + +.br +i2cReadBlockData SMBus read block data +.br +i2cWriteBlockData SMBus write block data +.br + +.br +i2cReadI2CBlockData SMBus read I2C block data +.br +i2cWriteI2CBlockData SMBus write I2C block data +.br + +.br +i2cReadDevice Reads the raw I2C device +.br +i2cWriteDevice Writes the raw I2C device +.br + +.br +i2cProcessCall SMBus process call +.br +i2cBlockProcessCall SMBus block process call +.br + +.br +i2cSwitchCombined Sets or clears the combined flag +.br + +.br +i2cSegments Performs multiple I2C transactions +.br + +.br +i2cZip Performs multiple I2C transactions +.br +.SS I2C BIT BANG +.br + +.br +bbI2COpen Opens GPIO for bit banging I2C +.br +bbI2CClose Closes GPIO for bit banging I2C +.br + +.br +bbI2CZip Performs bit banged I2C transactions +.br +.SS I2C/SPI SLAVE +.br + +.br +bscXfer I2C/SPI as slave transfer +.br +.SS SERIAL +.br + +.br +serOpen Opens a serial device +.br +serClose Closes a serial device +.br + +.br +serReadByte Reads a byte from a serial device +.br +serWriteByte Writes a byte to a serial device +.br + +.br +serRead Reads bytes from a serial device +.br +serWrite Writes bytes to a serial device +.br + +.br +serDataAvailable Returns number of bytes ready to be read +.br +.SS SERIAL BIT BANG (read only) +.br + +.br +gpioSerialReadOpen Opens a GPIO for bit bang serial reads +.br +gpioSerialReadClose Closes a GPIO for bit bang serial reads +.br + +.br +gpioSerialReadInvert Configures normal/inverted for serial reads +.br + +.br +gpioSerialRead Reads bit bang serial data from a GPIO +.br +.SS SPI +.br + +.br +spiOpen Opens a SPI device +.br +spiClose Closes a SPI device +.br + +.br +spiRead Reads bytes from a SPI device +.br +spiWrite Writes bytes to a SPI device +.br +spiXfer Transfers bytes with a SPI device +.br +.SS SPI BIT BANG +.br + +.br +bbSPIOpen Opens GPIO for bit banging SPI +.br +bbSPIClose Closes GPIO for bit banging SPI +.br + +.br +bbSPIXfer Performs bit banged SPI transactions +.br +.SS FILES +.br + +.br +fileOpen Opens a file +.br +fileClose Closes a file +.br + +.br +fileRead Reads bytes from a file +.br +fileWrite Writes bytes to a file +.br + +.br +fileSeek Seeks to a position within a file +.br + +.br +fileList List files which match a pattern +.br +.SS WAVES +.br + +.br +gpioWaveClear Deletes all waveforms +.br + +.br +gpioWaveAddNew Starts a new waveform +.br +gpioWaveAddGeneric Adds a series of pulses to the waveform +.br +gpioWaveAddSerial Adds serial data to the waveform +.br + +.br +gpioWaveCreate Creates a waveform from added data +.br +gpioWaveCreatePad Creates a waveform of fixed size from added data +.br +gpioWaveDelete Deletes a waveform +.br + +.br +gpioWaveTxSend Transmits a waveform +.br + +.br +gpioWaveChain Transmits a chain of waveforms +.br + +.br +gpioWaveTxAt Returns the current transmitting waveform +.br + +.br +gpioWaveTxBusy Checks to see if the waveform has ended +.br + +.br +gpioWaveTxStop Aborts the current waveform +.br + +.br +gpioWaveGetCbs Length in CBs of the current waveform +.br +gpioWaveGetHighCbs Length of longest waveform so far +.br +gpioWaveGetMaxCbs Absolute maximum allowed CBs +.br + +.br +gpioWaveGetMicros Length in micros of the current waveform +.br +gpioWaveGetHighMicros Length of longest waveform so far +.br +gpioWaveGetMaxMicros Absolute maximum allowed micros +.br + +.br +gpioWaveGetPulses Length in pulses of the current waveform +.br +gpioWaveGetHighPulses Length of longest waveform so far +.br +gpioWaveGetMaxPulses Absolute maximum allowed pulses +.br +.SS UTILITIES +.br + +.br +gpioDelay Delay for a number of microseconds +.br + +.br +gpioTick Get current tick (microseconds) +.br + +.br +gpioHardwareRevision Get hardware revision +.br +gpioVersion Get the pigpio version +.br + +.br +getBitInBytes Get the value of a bit +.br +putBitInBytes Set the value of a bit +.br + +.br +gpioTime Get current time +.br +gpioSleep Sleep for specified time +.br + +.br +time_sleep Sleeps for a float number of seconds +.br +time_time Float number of seconds since the epoch +.br +.SS CONFIGURATION +.br + +.br +gpioCfgBufferSize Configure the GPIO sample buffer size +.br +gpioCfgClock Configure the GPIO sample rate +.br +gpioCfgDMAchannel Configure the DMA channel (DEPRECATED) +.br +gpioCfgDMAchannels Configure the DMA channels +.br +gpioCfgPermissions Configure the GPIO access permissions +.br +gpioCfgInterfaces Configure user interfaces +.br +gpioCfgSocketPort Configure socket port +.br +gpioCfgMemAlloc Configure DMA memory allocation mode +.br +gpioCfgNetAddr Configure allowed network addresses +.br + +.br +gpioCfgGetInternals Get internal configuration settings +.br +gpioCfgSetInternals Set internal configuration settings +.br +.SS EXPERT +.br + +.br +rawWaveAddSPI Not intended for general use +.br +rawWaveAddGeneric Not intended for general use +.br +rawWaveCB Not intended for general use +.br +rawWaveCBAdr Not intended for general use +.br +rawWaveGetOOL Not intended for general use +.br +rawWaveSetOOL Not intended for general use +.br +rawWaveGetOut Not intended for general use +.br +rawWaveSetOut Not intended for general use +.br +rawWaveGetIn Not intended for general use +.br +rawWaveSetIn Not intended for general use +.br +rawWaveInfo Not intended for general use +.br +rawDumpWave Not intended for general use +.br +rawDumpScript Not intended for general use +.br +.SH FUNCTIONS + +.IP "\fBint gpioInitialise(void)\fP" +.IP "" 4 +Initialises the library. + +.br + +.br +Returns the pigpio version number if OK, otherwise PI_INIT_FAILED. + +.br + +.br +gpioInitialise must be called before using the other library functions +with the following exceptions: + +.br + +.br + +.EX +\fBgpioCfg*\fP +.br +\fBgpioVersion\fP +.br +\fBgpioHardwareRevision\fP +.br + +.EE + +.br + +.br +\fBExample\fP +.br + +.EX +if (gpioInitialise() < 0) +.br +{ +.br + // pigpio initialisation failed. +.br +} +.br +else +.br +{ +.br + // pigpio initialised okay. +.br +} +.br + +.EE + +.IP "\fBvoid gpioTerminate(void)\fP" +.IP "" 4 +Terminates the library. + +.br + +.br +Returns nothing. + +.br + +.br +Call before program exit. + +.br + +.br +This function resets the used DMA channels, releases memory, and +terminates any running threads. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioTerminate(); +.br + +.EE + +.IP "\fBint gpioSetMode(unsigned gpio, unsigned mode)\fP" +.IP "" 4 +Sets the GPIO mode, typically input or output. + +.br + +.br + +.EX +gpio: 0-53 +.br +mode: 0-7 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_MODE. + +.br + +.br +Arduino style: pinMode. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSetMode(17, PI_INPUT); // Set GPIO17 as input. +.br + +.br +gpioSetMode(18, PI_OUTPUT); // Set GPIO18 as output. +.br + +.br +gpioSetMode(22,PI_ALT0); // Set GPIO22 to alternative mode 0. +.br + +.EE + +.br + +.br +See \fBhttp://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2835/BCM2835-ARM-Peripherals.pdf\fP page 102 for an overview of the modes. + +.IP "\fBint gpioGetMode(unsigned gpio)\fP" +.IP "" 4 +Gets the GPIO mode. + +.br + +.br + +.EX +gpio: 0-53 +.br + +.EE + +.br + +.br +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. + +.br + +.br +\fBExample\fP +.br + +.EX +if (gpioGetMode(17) != PI_ALT0) +.br +{ +.br + gpioSetMode(17, PI_ALT0); // set GPIO17 to ALT0 +.br +} +.br + +.EE + +.IP "\fBint gpioSetPullUpDown(unsigned gpio, unsigned pud)\fP" +.IP "" 4 +Sets or clears resistor pull ups or downs on the GPIO. + +.br + +.br + +.EX +gpio: 0-53 +.br + pud: 0-2 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_PUD. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSetPullUpDown(17, PI_PUD_UP); // Sets a pull-up. +.br + +.br +gpioSetPullUpDown(18, PI_PUD_DOWN); // Sets a pull-down. +.br + +.br +gpioSetPullUpDown(23, PI_PUD_OFF); // Clear any pull-ups/downs. +.br + +.EE + +.IP "\fBint gpioRead(unsigned gpio)\fP" +.IP "" 4 +Reads the GPIO level, on or off. + +.br + +.br + +.EX +gpio: 0-53 +.br + +.EE + +.br + +.br +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. + +.br + +.br +Arduino style: digitalRead. + +.br + +.br +\fBExample\fP +.br + +.EX +printf("GPIO24 is level %d", gpioRead(24)); +.br + +.EE + +.IP "\fBint gpioWrite(unsigned gpio, unsigned level)\fP" +.IP "" 4 +Sets the GPIO level, on or off. + +.br + +.br + +.EX + gpio: 0-53 +.br +level: 0-1 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_LEVEL. + +.br + +.br +If PWM or servo pulses are active on the GPIO they are switched off. + +.br + +.br +Arduino style: digitalWrite + +.br + +.br +\fBExample\fP +.br + +.EX +gpioWrite(24, 1); // Set GPIO24 high. +.br + +.EE + +.IP "\fBint gpioPWM(unsigned user_gpio, unsigned dutycycle)\fP" +.IP "" 4 +Starts PWM on the GPIO, dutycycle between 0 (off) and range (fully on). +Range defaults to 255. + +.br + +.br + +.EX +user_gpio: 0-31 +.br +dutycycle: 0-range +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_DUTYCYCLE. + +.br + +.br +Arduino style: analogWrite + +.br + +.br +This and the servo functionality use the DMA and PWM or PCM peripherals +to control and schedule the pulse lengths and dutycycles. + +.br + +.br +The \fBgpioSetPWMrange\fP function may be used to change the default +range of 255. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioPWM(17, 255); // Sets GPIO17 full on. +.br + +.br +gpioPWM(18, 128); // Sets GPIO18 half on. +.br + +.br +gpioPWM(23, 0); // Sets GPIO23 full off. +.br + +.EE + +.IP "\fBint gpioGetPWMdutycycle(unsigned user_gpio)\fP" +.IP "" 4 +Returns the PWM dutycycle setting for the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + +.EE + +.br + +.br +Returns between 0 (off) and range (fully on) if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +.br + +.br +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see \fBgpioGetPWMrange\fP). + +.br + +.br +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +.br + +.br +Normal PWM range defaults to 255. + +.IP "\fBint gpioSetPWMrange(unsigned user_gpio, unsigned range)\fP" +.IP "" 4 +Selects the dutycycle range to be used for the GPIO. Subsequent calls +to gpioPWM will use a dutycycle between 0 (off) and range (fully on). + +.br + +.br + +.EX +user_gpio: 0-31 +.br + range: 25-40000 +.br + +.EE + +.br + +.br +Returns the real range for the given GPIO's frequency if OK, +otherwise PI_BAD_USER_GPIO or PI_BAD_DUTYRANGE. + +.br + +.br +If PWM is currently active on the GPIO its dutycycle will be scaled +to reflect the new range. + +.br + +.br +The real range, the number of steps between fully off and fully +on for each frequency, is given in the following table. + +.br + +.br + +.EX + 25, 50, 100, 125, 200, 250, 400, 500, 625, +.br + 800, 1000, 1250, 2000, 2500, 4000, 5000, 10000, 20000 +.br + +.EE + +.br + +.br +The real value set by \fBgpioPWM\fP is (dutycycle * real range) / range. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSetPWMrange(24, 2000); // Now 2000 is fully on +.br + // 1000 is half on +.br + // 500 is quarter on, etc. +.br + +.EE + +.IP "\fBint gpioGetPWMrange(unsigned user_gpio)\fP" +.IP "" 4 +Returns the dutycycle range used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + +.EE + +.br + +.br +If a hardware clock or hardware PWM is active on the GPIO +the reported range will be 1000000 (1M). + +.br + +.br +\fBExample\fP +.br + +.EX +r = gpioGetPWMrange(23); +.br + +.EE + +.IP "\fBint gpioGetPWMrealRange(unsigned user_gpio)\fP" +.IP "" 4 +Returns the real range used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + +.EE + +.br + +.br +If a hardware clock is active on the GPIO the reported real +range will be 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +.br + +.br +\fBExample\fP +.br + +.EX +rr = gpioGetPWMrealRange(17); +.br + +.EE + +.IP "\fBint gpioSetPWMfrequency(unsigned user_gpio, unsigned frequency)\fP" +.IP "" 4 +Sets the frequency in hertz to be used for the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br +frequency: >=0 +.br + +.EE + +.br + +.br +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO. + +.br + +.br +If PWM is currently active on the GPIO it will be +switched off and then back on at the new frequency. + +.br + +.br +Each GPIO can be independently set to one of 18 different PWM +frequencies. + +.br + +.br +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). + +.br + +.br +The frequencies for each sample rate are: + +.br + +.br + +.EX + Hertz +.br + +.br + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 +.br + 1250 1000 800 500 400 250 200 100 50 +.br + +.br + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 +.br + 625 500 400 250 200 125 100 50 25 +.br + +.br + 4: 10000 5000 2500 2000 1250 1000 625 500 400 +.br + 313 250 200 125 100 63 50 25 13 +.br +sample +.br + rate +.br + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 +.br + 250 200 160 100 80 50 40 20 10 +.br + +.br + 8: 5000 2500 1250 1000 625 500 313 250 200 +.br + 156 125 100 63 50 31 25 13 6 +.br + +.br + 10: 4000 2000 1000 800 500 400 250 200 160 +.br + 125 100 80 50 40 25 20 10 5 +.br + +.EE + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSetPWMfrequency(23, 0); // Set GPIO23 to lowest frequency. +.br + +.br +gpioSetPWMfrequency(24, 500); // Set GPIO24 to 500Hz. +.br + +.br +gpioSetPWMfrequency(25, 100000); // Set GPIO25 to highest frequency. +.br + +.EE + +.IP "\fBint gpioGetPWMfrequency(unsigned user_gpio)\fP" +.IP "" 4 +Returns the frequency (in hertz) used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + +.EE + +.br + +.br +For normal PWM the frequency will be that defined for the GPIO by +\fBgpioSetPWMfrequency\fP. + +.br + +.br +If a hardware clock is active on the GPIO the reported frequency +will be that set by \fBgpioHardwareClock\fP. + +.br + +.br +If hardware PWM is active on the GPIO the reported frequency +will be that set by \fBgpioHardwarePWM\fP. + +.br + +.br +\fBExample\fP +.br + +.EX +f = gpioGetPWMfrequency(23); // Get frequency used for GPIO23. +.br + +.EE + +.IP "\fBint gpioServo(unsigned user_gpio, unsigned pulsewidth)\fP" +.IP "" 4 +Starts servo pulses on the GPIO, 0 (off), 500 (most anti-clockwise) to +2500 (most clockwise). + +.br + +.br + +.EX + user_gpio: 0-31 +.br +pulsewidth: 0, 500-2500 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_PULSEWIDTH. + +.br + +.br +The range supported by servos varies and should probably be determined +by experiment. A value of 1500 should always be safe and represents +the mid-point of rotation. You can DAMAGE a servo if you command it +to move beyond its limits. + +.br + +.br +The following causes an on pulse of 1500 microseconds duration to be +transmitted on GPIO 17 at a rate of 50 times per second. This will +command a servo connected to GPIO 17 to rotate to its mid-point. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioServo(17, 1000); // Move servo to safe position anti-clockwise. +.br + +.br +gpioServo(23, 1500); // Move servo to centre position. +.br + +.br +gpioServo(25, 2000); // Move servo to safe position clockwise. +.br + +.EE + +.br + +.br +OTHER UPDATE RATES: + +.br + +.br +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +.br + +.br + +.EX +PWM Hz 50 100 200 400 500 +.br +1E6/Hz 20000 10000 5000 2500 2000 +.br + +.EE + +.br + +.br +Firstly set the desired PWM frequency using \fBgpioSetPWMfrequency\fP. + +.br + +.br +Then set the PWM range using \fBgpioSetPWMrange\fP to 1E6/frequency. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +.br + +.br +E.g. If you want to update a servo connected to GPIO25 at 400Hz + +.br + +.br + +.EX +gpioSetPWMfrequency(25, 400); +.br + +.br +gpioSetPWMrange(25, 2500); +.br + +.EE + +.br + +.br +Thereafter use the PWM command to move the servo, +e.g. gpioPWM(25, 1500) will set a 1500 us pulse. + +.IP "\fBint gpioGetServoPulsewidth(unsigned user_gpio)\fP" +.IP "" 4 +Returns the servo pulsewidth setting for the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + +.EE + +.br + +.br +Returns 0 (off), 500 (most anti-clockwise) to 2500 (most clockwise) +if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. + +.IP "\fBint gpioSetAlertFunc(unsigned user_gpio, gpioAlertFunc_t f)\fP" +.IP "" 4 +Registers a function to be called (a callback) when the specified +GPIO changes state. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + f: the callback function +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO. + +.br + +.br +One callback may be registered per GPIO. + +.br + +.br +The callback is passed the GPIO, the new level, and the tick. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +level 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.EE + +.br + +.br +The alert may be cancelled by passing NULL as the function. + +.br + +.br +The GPIO are sampled at a rate set when the library is started. + +.br + +.br +If a value isn't specifically set the default of 5 us is used. + +.br + +.br +The number of samples per second is given in the following table. + +.br + +.br + +.EX + samples +.br + per sec +.br + +.br + 1 1,000,000 +.br + 2 500,000 +.br +sample 4 250,000 +.br +rate 5 200,000 +.br +(us) 8 125,000 +.br + 10 100,000 +.br + +.EE + +.br + +.br +Level changes shorter than the sample rate may be missed. + +.br + +.br +The thread which calls the alert functions is triggered nominally +1000 times per second. The active alert functions will be called +once per level change since the last time the thread was activated. +i.e. The active alert functions will get all level changes but there +will be a latency. + +.br + +.br +If you want to track the level of more than one GPIO do so by +maintaining the state in the callback. Do not use \fBgpioRead\fP. +Remember the event that triggered the callback may have +happened several milliseconds before and the GPIO may have +changed level many times since then. + +.br + +.br +The tick value is the time stamp of the sample in microseconds, see +\fBgpioTick\fP for more details. + +.br + +.br +\fBExample\fP +.br + +.EX +void aFunction(int gpio, int level, uint32_t tick) +.br +{ +.br + printf("GPIO %d became %d at %d", gpio, level, tick); +.br +} +.br + +.br +// call aFunction whenever GPIO 4 changes state +.br + +.br +gpioSetAlertFunc(4, aFunction); +.br + +.EE + +.IP "\fBint gpioSetAlertFuncEx(unsigned user_gpio, gpioAlertFuncEx_t f, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) when the specified +GPIO changes state. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + f: the callback function +.br + userdata: pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO. + +.br + +.br +One callback may be registered per GPIO. + +.br + +.br +The callback is passed the GPIO, the new level, the tick, and +the userdata pointer. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +level 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.br +userdata pointer Pointer to an arbitrary object +.br + +.EE + +.br + +.br +See \fBgpioSetAlertFunc\fP for further details. + +.br + +.br +Only one of \fBgpioSetAlertFunc\fP or \fBgpioSetAlertFuncEx\fP can be +registered per GPIO. + +.IP "\fBint gpioSetISRFunc(unsigned gpio, unsigned edge, int timeout, gpioISRFunc_t f)\fP" +.IP "" 4 +Registers a function to be called (a callback) whenever the specified +GPIO interrupt occurs. + +.br + +.br + +.EX + gpio: 0-53 +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE +.br +timeout: interrupt timeout in milliseconds (<=0 to cancel) +.br + f: the callback function +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_EDGE, +or PI_BAD_ISR_INIT. + +.br + +.br +One function may be registered per GPIO. + +.br + +.br +The function is passed the GPIO, the current level, and the +current tick. The level will be PI_TIMEOUT if the optional +interrupt timeout expires. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-53 The GPIO which has changed state +.br + +.br +level 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (interrupt timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.EE + +.br + +.br +The underlying Linux sysfs GPIO interface is used to provide +the interrupt services. + +.br + +.br +The first time the function is called, with a non-NULL f, the +GPIO is exported, set to be an input, and set to interrupt +on the given edge and timeout. + +.br + +.br +Subsequent calls, with a non-NULL f, can vary one or more of the +edge, timeout, or function. + +.br + +.br +The ISR may be cancelled by passing a NULL f, in which case the +GPIO is unexported. + +.br + +.br +The tick is that read at the time the process was informed of +the interrupt. This will be a variable number of microseconds +after the interrupt occurred. Typically the latency will be of +the order of 50 microseconds. The latency is not guaranteed +and will vary with system load. + +.br + +.br +The level is that read at the time the process was informed of +the interrupt, or PI_TIMEOUT if the optional interrupt timeout +expired. It may not be the same as the expected edge as +interrupts happening in rapid succession may be missed by the +kernel (i.e. this mechanism can not be used to capture several +interrupts only a few microseconds apart). + +.IP "\fBint gpioSetISRFuncEx(unsigned gpio, unsigned edge, int timeout, gpioISRFuncEx_t f, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) whenever the specified +GPIO interrupt occurs. + +.br + +.br + +.EX + gpio: 0-53 +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE +.br + timeout: interrupt timeout in milliseconds (<=0 to cancel) +.br + f: the callback function +.br +userdata: pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_EDGE, +or PI_BAD_ISR_INIT. + +.br + +.br +The function is passed the GPIO, the current level, the +current tick, and the userdata pointer. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-53 The GPIO which has changed state +.br + +.br +level 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (interrupt timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.br +userdata pointer Pointer to an arbitrary object +.br + +.EE + +.br + +.br +Only one of \fBgpioSetISRFunc\fP or \fBgpioSetISRFuncEx\fP can be +registered per GPIO. + +.br + +.br +See \fBgpioSetISRFunc\fP for further details. + +.IP "\fBint gpioNotifyOpen(void)\fP" +.IP "" 4 +This function requests a free notification handle. + +.br + +.br +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +.br + +.br +A notification is a method for being notified of GPIO state changes +via a pipe or socket. + +.br + +.br +Pipe notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). E.g. if the +function returns 15 then the notifications must be read +from /dev/pigpio15. + +.br + +.br +Socket notifications are returned to the socket which requested the +handle. + +.br + +.br +\fBExample\fP +.br + +.EX +h = gpioNotifyOpen(); +.br + +.br +if (h >= 0) +.br +{ +.br + sprintf(str, "/dev/pigpio%d", h); +.br + +.br + fd = open(str, O_RDONLY); +.br + +.br + if (fd >= 0) +.br + { +.br + // Okay. +.br + } +.br + else +.br + { +.br + // Error. +.br + } +.br +} +.br +else +.br +{ +.br + // Error. +.br +} +.br + +.EE + +.IP "\fBint gpioNotifyOpenWithSize(int bufSize)\fP" +.IP "" 4 +This function requests a free notification handle. + +.br + +.br +It differs from \fBgpioNotifyOpen\fP in that the pipe size may be +specified, whereas \fBgpioNotifyOpen\fP uses the default pipe size. + +.br + +.br +See \fBgpioNotifyOpen\fP for further details. + +.IP "\fBint gpioNotifyBegin(unsigned handle, uint32_t bits)\fP" +.IP "" 4 +This function starts notifications on a previously opened handle. + +.br + +.br + +.EX +handle: >=0, as returned by \fBgpioNotifyOpen\fP +.br + bits: a bit mask indicating the GPIO of interest +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +The notification sends state changes for each GPIO whose corresponding +bit in bits is set. + +.br + +.br +Each notification occupies 12 bytes in the fifo and has the +following structure. + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint16_t seqno; +.br + uint16_t flags; +.br + uint32_t tick; +.br + uint32_t level; +.br +} gpioReport_t; +.br + +.EE + +.br + +.br +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +.br + +.br +flags: three flags are defined, PI_NTFY_FLAGS_WDOG, +PI_NTFY_FLAGS_ALIVE, and PI_NTFY_FLAGS_EVENT. + +.br + +.br +If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +.br + +.br +If bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +.br + +.br +If bit 7 is set (PI_NTFY_FLAGS_EVENT) then bits 0-4 of the flags +indicate an event which has been triggered. + +.br + +.br +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +.br + +.br +level: indicates the level of each GPIO. If bit 1<=0, as returned by \fBgpioNotifyOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +Notifications for the handle are suspended until \fBgpioNotifyBegin\fP +is called again. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioNotifyPause(h); +.br + +.EE + +.IP "\fBint gpioNotifyClose(unsigned handle)\fP" +.IP "" 4 +This function stops notifications on a previously opened handle +and releases the handle for reuse. + +.br + +.br + +.EX +handle: >=0, as returned by \fBgpioNotifyOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioNotifyClose(h); +.br + +.EE + +.IP "\fBint gpioWaveClear(void)\fP" +.IP "" 4 +This function clears all waveforms and any data added by calls to the +\fBgpioWaveAdd*\fP functions. + +.br + +.br +Returns 0 if OK. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioWaveClear(); +.br + +.EE + +.IP "\fBint gpioWaveAddNew(void)\fP" +.IP "" 4 +This function starts a new empty waveform. + +.br + +.br +You wouldn't normally need to call this function as it is automatically +called after a waveform is created with the \fBgpioWaveCreate\fP function. + +.br + +.br +Returns 0 if OK. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioWaveAddNew(); +.br + +.EE + +.IP "\fBint gpioWaveAddGeneric(unsigned numPulses, gpioPulse_t *pulses)\fP" +.IP "" 4 +This function adds a number of pulses to the current waveform. + +.br + +.br + +.EX +numPulses: the number of pulses +.br + pulses: an array of pulses +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +.br + +.br +The pulses are interleaved in time order within the existing waveform +(if any). + +.br + +.br +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +.br + +.br +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist of a delay. + +.br + +.br +\fBExample\fP +.br + +.EX +// Construct and send a 30 microsecond square wave. +.br + +.br +gpioSetMode(gpio, PI_OUTPUT); +.br + +.br +pulse[0].gpioOn = (1<= 0) +.br +{ +.br + gpioWaveTxSend(wave_id, PI_WAVE_MODE_REPEAT); +.br + +.br + // Transmit for 30 seconds. +.br + +.br + sleep(30); +.br + +.br + gpioWaveTxStop(); +.br +} +.br +else +.br +{ +.br + // Wave create failed. +.br +} +.br + +.EE + +.IP "\fBint gpioWaveAddSerial(unsigned user_gpio, unsigned baud, unsigned data_bits, unsigned stop_bits, unsigned offset, unsigned numBytes, char *str)\fP" +.IP "" 4 +This function adds a waveform representing serial data to the +existing waveform (if any). The serial data starts offset +microseconds from the start of the waveform. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + baud: 50-1000000 +.br +data_bits: 1-32 +.br +stop_bits: 2-8 +.br + offset: >=0 +.br + numBytes: >=1 +.br + str: an array of chars (which may contain nulls) +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOPBITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +.br + +.br +NOTES: + +.br + +.br +The serial data is formatted as one start bit, data_bits data bits, and +stop_bits/2 stop bits. + +.br + +.br +It is legal to add serial data streams with different baud rates to +the same waveform. + +.br + +.br +numBytes is the number of bytes of data in str. + +.br + +.br +The bytes required for each character depend upon data_bits. + +.br + +.br +For data_bits 1-8 there will be one byte per character. +.br +For data_bits 9-16 there will be two bytes per character. +.br +For data_bits 17-32 there will be four bytes per character. + +.br + +.br +\fBExample\fP +.br + +.EX +#define MSG_LEN 8 +.br + +.br +int i; +.br +char *str; +.br +char data[MSG_LEN]; +.br + +.br +str = "Hello world!"; +.br + +.br +gpioWaveAddSerial(4, 9600, 8, 2, 0, strlen(str), str); +.br + +.br +for (i=0; i=0, as returned by \fBgpioWaveCreate\fP +.br + +.EE + +.br + +.br +Wave ids are allocated in order, 0, 1, 2, etc. + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. + +.IP "\fBint gpioWaveTxSend(unsigned wave_id, unsigned wave_mode)\fP" +.IP "" 4 +This function transmits the waveform with id wave_id. The mode +determines whether the waveform is sent once or cycles endlessly. +The SYNC variants wait for the current waveform to reach the +end of a cycle or finish before starting the new waveform. + +.br + +.br +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +.br + +.br +NOTE: Any hardware PWM started by \fBgpioHardwarePWM\fP will be cancelled. + +.br + +.br + +.EX + wave_id: >=0, as returned by \fBgpioWaveCreate\fP +.br +wave_mode: PI_WAVE_MODE_ONE_SHOT, PI_WAVE_MODE_REPEAT, +.br + PI_WAVE_MODE_ONE_SHOT_SYNC, PI_WAVE_MODE_REPEAT_SYNC +.br + +.EE + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint gpioWaveChain(char *buf, unsigned bufSize)\fP" +.IP "" 4 +This function transmits a chain of waveforms. + +.br + +.br +NOTE: Any hardware PWM started by \fBgpioHardwarePWM\fP will be cancelled. + +.br + +.br +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of \fBwave_id\fPs and optional command +codes and related data. + +.br + +.br + +.EX + buf: pointer to the wave_ids and optional command codes +.br +bufSize: the number of bytes in buf +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +.br + +.br +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +.br + +.br +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +.br + +.br +Delays between waves may be added with the delay command. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +Loop Start 255 0 Identify start of a wave block +.br +Loop Repeat 255 1 x y loop x + y*256 times +.br +Delay 255 2 x y delay x + y*256 microseconds +.br +Loop Forever 255 3 loop forever +.br + +.br + +.br +If present Loop Forever must be the last entry in the chain. + +.br + +.br +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +#define WAVES 5 +.br +#define GPIO 4 +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int i, wid[WAVES]; +.br + +.br + if (gpioInitialise()<0) return -1; +.br + +.br + gpioSetMode(GPIO, PI_OUTPUT); +.br + +.br + printf("start piscope, press return"); getchar(); +.br + +.br + for (i=0; i=0 +.br + +.EE + +.br + +.br +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +.br + +.br +The bytes returned for each character depend upon the number of +data bits \fBdata_bits\fP specified in the \fBgpioSerialReadOpen\fP command. + +.br + +.br +For \fBdata_bits\fP 1-8 there will be one byte per character. +.br +For \fBdata_bits\fP 9-16 there will be two bytes per character. +.br +For \fBdata_bits\fP 17-32 there will be four bytes per character. + +.IP "\fBint gpioSerialReadClose(unsigned user_gpio)\fP" +.IP "" 4 +This function closes a GPIO for bit bang reading of serial data. + +.br + +.br + +.EX +user_gpio: 0-31, previously opened with \fBgpioSerialReadOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. + +.IP "\fBint i2cOpen(unsigned i2cBus, unsigned i2cAddr, unsigned i2cFlags)\fP" +.IP "" 4 +This returns a handle for the device at the address on the I2C bus. + +.br + +.br + +.EX + i2cBus: >=0 +.br + i2cAddr: 0-0x7F +.br +i2cFlags: 0 +.br + +.EE + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.br + +.br +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + SDA SCL +.br +I2C 0 0 1 +.br +I2C 1 2 3 +.br + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +.br + +.br +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +.br + +.br + +.EX +S (1 bit) : Start bit +.br +P (1 bit) : Stop bit +.br +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +.br +A, NA (1 bit) : Accept and not accept bit. +.br +.br +.br +Addr (7 bits): I2C 7 bit address. +.br +i2cReg (8 bits): Command byte, a byte which often selects a register. +.br +Data (8 bits): A data byte. +.br +Count (8 bits): A byte defining the length of a block operation. +.br + +.br +[..]: Data sent by the device. +.br + +.EE + +.IP "\fBint i2cClose(unsigned handle)\fP" +.IP "" 4 +This closes the I2C device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint i2cWriteQuick(unsigned handle, unsigned bit)\fP" +.IP "" 4 +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + bit: 0-1, the value to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Quick command. SMBus 2.0 5.5.1 + +.EX +S Addr bit [A] P +.br + +.EE + +.IP "\fBint i2cWriteByte(unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This sends a single byte to the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + bVal: 0-0xFF, the value to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Send byte. SMBus 2.0 5.5.2 + +.EX +S Addr Wr [A] bVal [A] P +.br + +.EE + +.IP "\fBint i2cReadByte(unsigned handle)\fP" +.IP "" 4 +This reads a single byte from the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +.br + +.br +Receive byte. SMBus 2.0 5.5.3 + +.EX +S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2cWriteByteData(unsigned handle, unsigned i2cReg, unsigned bVal)\fP" +.IP "" 4 +This writes a single byte to the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write +.br + bVal: 0-0xFF, the value to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write byte. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] i2cReg [A] bVal [A] P +.br + +.EE + +.IP "\fBint i2cWriteWordData(unsigned handle, unsigned i2cReg, unsigned wVal)\fP" +.IP "" 4 +This writes a single 16 bit word to the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write +.br + wVal: 0-0xFFFF, the value to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write word. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] i2cReg [A] wValLow [A] wValHigh [A] P +.br + +.EE + +.IP "\fBint i2cReadByteData(unsigned handle, unsigned i2cReg)\fP" +.IP "" 4 +This reads a single byte from the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to read +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read byte. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] i2cReg [A] S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2cReadWordData(unsigned handle, unsigned i2cReg)\fP" +.IP "" 4 +This reads a single 16 bit word from the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to read +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read word. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] i2cReg [A] S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2cProcessCall(unsigned handle, unsigned i2cReg, unsigned wVal)\fP" +.IP "" 4 +This writes 16 bits of data to the specified register of the device +associated with handle and reads 16 bits of data in return. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write/read +.br + wVal: 0-0xFFFF, the value to write +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Process call. SMBus 2.0 5.5.6 + +.EX +S Addr Wr [A] i2cReg [A] wValLow [A] wValHigh [A] +.br + S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2cWriteBlockData(unsigned handle, unsigned i2cReg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes up to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write +.br + buf: an array with the data to send +.br + count: 1-32, the number of bytes to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Block write. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] i2cReg [A] count [A] +.br + buf0 [A] buf1 [A] ... [A] bufn [A] P +.br + +.EE + +.IP "\fBint i2cReadBlockData(unsigned handle, unsigned i2cReg, char *buf)\fP" +.IP "" 4 +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to read +.br + buf: an array to receive the read data +.br + +.EE + +.br + +.br +The amount of returned data is set by the device. + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Block read. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] i2cReg [A] +.br + S Addr Rd [A] [Count] A [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2cBlockProcessCall(unsigned handle, unsigned i2cReg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write/read +.br + buf: an array with the data to send and to receive the read data +.br + count: 1-32, the number of bytes to write +.br + +.EE + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +The SMBus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +.br + +.br +Block write-block read. SMBus 2.0 5.5.8 + +.EX +S Addr Wr [A] i2cReg [A] count [A] buf0 [A] ... bufn [A] +.br + S Addr Rd [A] [Count] A [buf0] A ... [bufn] A P +.br + +.EE + +.IP "\fBint i2cReadI2CBlockData(unsigned handle, unsigned i2cReg, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to read +.br + buf: an array to receive the read data +.br + count: 1-32, the number of bytes to read +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] i2cReg [A] +.br + S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2cWriteI2CBlockData(unsigned handle, unsigned i2cReg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br +i2cReg: 0-255, the register to write +.br + buf: the data to write +.br + count: 1-32, the number of bytes to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] i2cReg [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +.br + +.EE + +.IP "\fBint i2cReadDevice(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the raw device into buf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + buf: an array to receive the read data bytes +.br + count: >0, the number of bytes to read +.br + +.EE + +.br + +.br +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. + +.br + +.br + +.EX +S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2cWriteDevice(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This writes count bytes from buf to the raw device. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + buf: an array containing the data bytes to write +.br + count: >0, the number of bytes to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +.br + +.EE + +.IP "\fBvoid i2cSwitchCombined(int setting)\fP" +.IP "" 4 +This sets the I2C (i2c-bcm2708) module "use combined transactions" +parameter on or off. + +.br + +.br + +.EX +setting: 0 to set the parameter off, non-zero to set it on +.br + +.EE + +.br + +.br + +.br + +.br +NOTE: when the flag is on a write followed by a read to the same +slave address will use a repeated start (rather than a stop/start). + +.IP "\fBint i2cSegments(unsigned handle, pi_i2c_msg_t *segs, unsigned numSegs)\fP" +.IP "" 4 +This function executes multiple I2C segments in one transaction by +calling the I2C_RDWR ioctl. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + segs: an array of I2C segments +.br +numSegs: >0, the number of I2C segments +.br + +.EE + +.br + +.br +Returns the number of segments if OK, otherwise PI_BAD_I2C_SEG. + +.IP "\fBint i2cZip(unsigned handle, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +On 2 Switch combined flag on +.br +Off 3 Switch combined flag off +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53, write 0x32, read 6 bytes +.br +Set address 0x1E, write 0x03, read 6 bytes +.br +Set address 0x68, write 0x1B, read 8 bytes +.br +End +.br + +.br +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +.br +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +.br +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +.br +0x00 +.br + +.EE + +.IP "\fBint bbI2COpen(unsigned SDA, unsigned SCL, unsigned baud)\fP" +.IP "" 4 +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +.br + +.br +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +.br + +.br +o baud rates as low as 50 +.br +o repeated starts +.br +o clock stretching +.br +o I2C on any pair of spare GPIO + +.br + +.br + +.EX + SDA: 0-31 +.br + SCL: 0-31 +.br +baud: 50-500000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +.br + +.br +NOTE: + +.br + +.br +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + +.IP "\fBint bbI2CClose(unsigned SDA)\fP" +.IP "" 4 +This function stops bit banging I2C on a pair of GPIO previously +opened with \fBbbI2COpen\fP. + +.br + +.br + +.EX +SDA: 0-31, the SDA GPIO used in a prior call to \fBbbI2COpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. + +.IP "\fBint bbI2CZip(unsigned SDA, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX + SDA: 0-31 (as used in a prior call to \fBbbI2COpen\fP) +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +Start 2 Start condition +.br +Stop 3 Stop condition +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +.br + +.br +No flags are currently defined. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53 +.br +start, write 0x32, (re)start, read 6 bytes, stop +.br +Set address 0x1E +.br +start, write 0x03, (re)start, read 6 bytes, stop +.br +Set address 0x68 +.br +start, write 0x1B, (re)start, read 8 bytes, stop +.br +End +.br + +.br +0x04 0x53 +.br +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x1E +.br +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x68 +.br +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 +.br + +.br +0x00 +.br + +.EE + +.IP "\fBint bscXfer(bsc_xfer_t *bsc_xfer)\fP" +.IP "" 4 +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +.br + +.br +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +.br + +.br +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +.br + +.br +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +.br + +.br +The function sets the BSC mode, writes any data in +the transmit buffer to the BSC transmit FIFO, and +copies any data in the BSC receive FIFO to the +receive buffer. + +.br + +.br + +.EX +bsc_xfer:= a structure defining the transfer +.br + +.br +typedef struct +.br +{ +.br + uint32_t control; // Write +.br + int rxCnt; // Read only +.br + char rxBuf[BSC_FIFO_SIZE]; // Read only +.br + int txCnt; // Write +.br + char txBuf[BSC_FIFO_SIZE]; // Write +.br +} bsc_xfer_t; +.br + +.EE + +.br + +.br +To start a transfer set control (see below), copy the bytes to +be added to the transmit FIFO (if any) to txBuf and set txCnt to +the number of copied bytes. + +.br + +.br +Upon return rxCnt will be set to the number of received bytes placed +in rxBuf. + +.br + +.br +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +.br + +.br +GPIO used for models other than those based on the BCM2711. + +.br + +.br + SDA SCL MOSI SCLK MISO CE +.br +I2C 18 19 - - - - +.br +SPI - - 20 19 18 21 +.br + +.br + +.br +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + +.br + +.br + SDA SCL MOSI SCLK MISO CE +.br +I2C 10 11 - - - - +.br +SPI - - 9 11 10 8 +.br + +.br + +.br +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +.br + +.br +The returned function value is the status of the transfer (see below). + +.br + +.br +If there was an error the status will be less than zero +(and will contain the error code). + +.br + +.br +The most significant word of the returned status contains the number +of bytes actually copied from txBuf to the BSC transmit FIFO (may be +less than requested if the FIFO already contained untransmitted data). + +.br + +.br +control consists of the following bits. + +.br + +.br + +.EX +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +.br + +.EE + +.br + +.br +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +.br + +.br +aaaaaaa defines the I2C slave address (only relevant in I2C mode) +.br +IT invert transmit status flags +.br +HC enable host control +.br +TF enable test FIFO +.br +IR invert receive status flags +.br +RE enable receive +.br +TE enable transmit +.br +BK abort operation and clear FIFOs +.br +EC send control register as first I2C byte +.br +ES send status register as first I2C byte +.br +PL set SPI polarity high +.br +PH set SPI phase high +.br +I2 enable I2C mode +.br +SP enable SPI mode +.br +EN enable BSC peripheral +.br + +.br + +.br +The returned status has the following format + +.br + +.br + +.EX +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + S S S S S R R R R R T T T T T RB TE RF TF RE TB +.br + +.EE + +.br + +.br +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +.br + +.br +SSSSS number of bytes successfully copied to transmit FIFO +.br +RRRRR number of bytes in receive FIFO +.br +TTTTT number of bytes in transmit FIFO +.br +RB receive busy +.br +TE transmit FIFO empty +.br +RF receive FIFO full +.br +TF transmit FIFO full +.br +RE receive FIFO empty +.br +TB transmit busy +.br + +.br + +.br +The following example shows how to configure the BSC peripheral as +an I2C slave with address 0x13 and send four bytes. + +.br + +.br +\fBExample\fP +.br + +.EX +bsc_xfer_t xfer; +.br + +.br +xfer.control = (0x13<<16) | 0x305; +.br + +.br +memcpy(xfer.txBuf, "ABCD", 4); +.br +xfer.txCnt = 4; +.br + +.br +status = bscXfer(&xfer); +.br + +.br +if (status >= 0) +.br +{ +.br + // process transfer +.br +} +.br + +.EE + +.br + +.br +The BSC slave in SPI mode deserializes data from the MOSI pin into its +receiver/FIFO when the LSB of the first byte is a 0. No data is output on +the MISO pin. When the LSB of the first byte on MOSI is a 1, the +transmitter/FIFO data is serialized onto the MISO pin while all other data +on the MOSI pin is ignored. + +.br + +.br +The BK bit of the BSC control register is non-functional when in the SPI +mode. The transmitter along with its FIFO can be dequeued by successively +disabling and re-enabling the TE bit on the BSC control register while in +SPI mode. + +.IP "\fBint bbSPIOpen(unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, unsigned baud, unsigned spiFlags)\fP" +.IP "" 4 +This function selects a set of GPIO for bit banging SPI with +a specified baud rate and mode. + +.br + +.br + +.EX + CS: 0-31 +.br + MISO: 0-31 +.br + MOSI: 0-31 +.br + SCLK: 0-31 +.br + baud: 50-250000 +.br +spiFlags: see below +.br + +.EE + +.br + +.br +spiFlags consists of the least significant 22 bits. + +.br + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +.br + +.EE + +.br + +.br +mm defines the SPI mode, defaults to 0 + +.br + +.br + +.EX +Mode CPOL CPHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br + +.br +p is 0 if CS is active low (default) and 1 for active high. + +.br + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +.br + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +.br + +.br +The other bits in flags should be set to zero. + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_SPI_BAUD, or +PI_GPIO_IN_USE. + +.br + +.br +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +.br + +.br +\fBExample\fP +.br + +.EX +bbSPIOpen(10, MISO, MOSI, SCLK, 10000, 0); // device 1 +.br +bbSPIOpen(11, MISO, MOSI, SCLK, 20000, 3); // device 2 +.br + +.EE + +.IP "\fBint bbSPIClose(unsigned CS)\fP" +.IP "" 4 +This function stops bit banging SPI on a set of GPIO +opened with \fBbbSPIOpen\fP. + +.br + +.br + +.EX +CS: 0-31, the CS GPIO used in a prior call to \fBbbSPIOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SPI_GPIO. + +.IP "\fBint bbSPIXfer(unsigned CS, char *inBuf, char *outBuf, unsigned count)\fP" +.IP "" 4 +This function executes a bit banged SPI transfer. + +.br + +.br + +.EX + CS: 0-31 (as used in a prior call to \fBbbSPIOpen\fP) +.br + inBuf: pointer to buffer to hold data to be sent +.br +outBuf: pointer to buffer to hold returned data +.br + count: size of data transfer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_SPI_GPIO or PI_BAD_POINTER. + +.br + +.br +\fBExample\fP +.br + +.EX +// gcc -Wall -pthread -o bbSPIx_test bbSPIx_test.c -lpigpio +.br +// sudo ./bbSPIx_test +.br + +.br + +.br +#include +.br + +.br +#include "pigpio.h" +.br + +.br +#define CE0 5 +.br +#define CE1 6 +.br +#define MISO 13 +.br +#define MOSI 19 +.br +#define SCLK 12 +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int i, count, set_val, read_val; +.br + unsigned char inBuf[3]; +.br + char cmd1[] = {0, 0}; +.br + char cmd2[] = {12, 0}; +.br + char cmd3[] = {1, 128, 0}; +.br + +.br + if (gpioInitialise() < 0) +.br + { +.br + fprintf(stderr, "pigpio initialisation failed.\n"); +.br + return 1; +.br + } +.br + +.br + bbSPIOpen(CE0, MISO, MOSI, SCLK, 10000, 0); // MCP4251 DAC +.br + bbSPIOpen(CE1, MISO, MOSI, SCLK, 20000, 3); // MCP3008 ADC +.br + +.br + for (i=0; i<256; i++) +.br + { +.br + cmd1[1] = i; +.br + +.br + count = bbSPIXfer(CE0, cmd1, (char *)inBuf, 2); // > DAC +.br + +.br + if (count == 2) +.br + { +.br + count = bbSPIXfer(CE0, cmd2, (char *)inBuf, 2); // < DAC +.br + +.br + if (count == 2) +.br + { +.br + set_val = inBuf[1]; +.br + +.br + count = bbSPIXfer(CE1, cmd3, (char *)inBuf, 3); // < ADC +.br + +.br + if (count == 3) +.br + { +.br + read_val = ((inBuf[1]&3)<<8) | inBuf[2]; +.br + printf("%d %d\n", set_val, read_val); +.br + } +.br + } +.br + } +.br + } +.br + +.br + bbSPIClose(CE0); +.br + bbSPIClose(CE1); +.br + +.br + gpioTerminate(); +.br + +.br + return 0; +.br +} +.br + +.EE + +.IP "\fBint spiOpen(unsigned spiChan, unsigned baud, unsigned spiFlags)\fP" +.IP "" 4 +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +.br + +.br +The Pi has two SPI peripherals: main and auxiliary. + +.br + +.br +The main SPI has two chip selects (channels), the auxiliary has +three. + +.br + +.br +The auxiliary SPI is available on all models but the A and B. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + MISO MOSI SCLK CE0 CE1 CE2 +.br +Main SPI 9 10 11 8 7 - +.br +Aux SPI 19 20 21 18 17 16 +.br + +.br + +.br + +.EX + spiChan: 0-1 (0-2 for the auxiliary SPI) +.br + baud: 32K-125M (values above 30M are unlikely to work) +.br +spiFlags: see below +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +.br + +.br +spiFlags consists of the least significant 22 bits. + +.br + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +.br + +.EE + +.br + +.br +mm defines the SPI mode. + +.br + +.br +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +.br + +.br + +.EX +Mode POL PHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br + +.br +px is 0 if CEx is active low (default) and 1 for active high. + +.br + +.br +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +.br + +.br +A is 0 for the main SPI, 1 for the auxiliary SPI. + +.br + +.br +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +.br + +.br +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +.br + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +.br + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +.br + +.br +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +.br + +.br +The \fBspiRead\fP, \fBspiWrite\fP, and \fBspiXfer\fP functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +.br + +.br +For bits 1-8 there will be one byte per word. +.br +For bits 9-16 there will be two bytes per word. +.br +For bits 17-32 there will be four bytes per word. + +.br + +.br +Multi-byte transfers are made in least significant byte first order. + +.br + +.br +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +.br + +.br +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +.br + +.br +The other bits in flags should be set to zero. + +.IP "\fBint spiClose(unsigned handle)\fP" +.IP "" 4 +This functions closes the SPI device identified by the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspiOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint spiRead(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads count bytes of data from the SPI +device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspiOpen\fP +.br + buf: an array to receive the read data bytes +.br + count: the number of bytes to read +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spiWrite(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspiOpen\fP +.br + buf: the data bytes to write +.br + count: the number of bytes to write +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spiXfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count)\fP" +.IP "" 4 +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspiOpen\fP +.br + txBuf: the data bytes to write +.br + rxBuf: the received data bytes +.br + count: the number of bytes to transfer +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint serOpen(char *sertty, unsigned baud, unsigned serFlags)\fP" +.IP "" 4 +This function opens a serial device at a specified baud rate +and with specified flags. The device name must start with +/dev/tty or /dev/serial. + +.br + +.br + +.EX + sertty: the serial device to open +.br + baud: the baud rate in bits per second, see below +.br +serFlags: 0 +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +.br + +.br +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.IP "\fBint serClose(unsigned handle)\fP" +.IP "" 4 +This function closes the serial device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint serWriteByte(unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This function writes bVal to the serial port associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serReadByte(unsigned handle)\fP" +.IP "" 4 +This function reads a byte from the serial port associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + +.EE + +.br + +.br +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +.br + +.br +If no data is ready PI_SER_READ_NO_DATA is returned. + +.IP "\fBint serWrite(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes from buf to the the serial port +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + buf: the array of bytes to write +.br + count: the number of bytes to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serRead(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads up count bytes from the the serial port +associated with handle and writes them to buf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + buf: an array to receive the read data +.br + count: the maximum number of bytes to read +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0=) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_SER_READ_NO_DATA. + +.br + +.br +If no data is ready zero is returned. + +.IP "\fBint serDataAvailable(unsigned handle)\fP" +.IP "" 4 +This function returns the number of bytes available +to be read from the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserOpen\fP +.br + +.EE + +.br + +.br +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. + +.IP "\fBint gpioTrigger(unsigned user_gpio, unsigned pulseLen, unsigned level)\fP" +.IP "" 4 +This function sends a trigger pulse to a GPIO. The GPIO is set to +level for pulseLen microseconds and then reset to not level. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + pulseLen: 1-100 +.br + level: 0,1 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_LEVEL, +or PI_BAD_PULSELEN. + +.IP "\fBint gpioSetWatchdog(unsigned user_gpio, unsigned timeout)\fP" +.IP "" 4 +Sets a watchdog for a GPIO. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + timeout: 0-60000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_WDOG_TIMEOUT. + +.br + +.br +The watchdog is nominally in milliseconds. + +.br + +.br +One watchdog may be registered per GPIO. + +.br + +.br +The watchdog may be cancelled by setting timeout to 0. + +.br + +.br +Until cancelled a timeout will be reported every timeout milliseconds +after the last GPIO activity. + +.br + +.br +In particular: + +.br + +.br +1) any registered alert function for the GPIO will be called with + the level set to PI_TIMEOUT. + +.br + +.br +2) any notification for the GPIO will have a report written to the + fifo with the flags set to indicate a watchdog timeout. + +.br + +.br +\fBExample\fP +.br + +.EX +void aFunction(int gpio, int level, uint32_t tick) +.br +{ +.br + printf("GPIO %d became %d at %d", gpio, level, tick); +.br +} +.br + +.br +// call aFunction whenever GPIO 4 changes state +.br +gpioSetAlertFunc(4, aFunction); +.br + +.br +// or approximately every 5 millis +.br +gpioSetWatchdog(4, 5); +.br + +.EE + +.IP "\fBint gpioNoiseFilter(unsigned user_gpio, unsigned steady, unsigned active)\fP" +.IP "" 4 +Sets a noise filter on a GPIO. + +.br + +.br +Level changes on the GPIO are ignored until a level which has +been stable for \fBsteady\fP microseconds is detected. Level changes +on the GPIO are then reported for \fBactive\fP microseconds after +which the process repeats. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + steady: 0-300000 +.br + active: 0-1000000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +.br + +.br +This filter affects the GPIO samples returned to callbacks set up +with \fBgpioSetAlertFunc\fP, \fBgpioSetAlertFuncEx\fP, \fBgpioSetGetSamplesFunc\fP, +and \fBgpioSetGetSamplesFuncEx\fP. + +.br + +.br +It does not affect interrupts set up with \fBgpioSetISRFunc\fP, +\fBgpioSetISRFuncEx\fP, or levels read by \fBgpioRead\fP, +\fBgpioRead_Bits_0_31\fP, or \fBgpioRead_Bits_32_53\fP. + +.br + +.br +Level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. + +.IP "\fBint gpioGlitchFilter(unsigned user_gpio, unsigned steady)\fP" +.IP "" 4 +Sets a glitch filter on a GPIO. + +.br + +.br +Level changes on the GPIO are not reported unless the level +has been stable for at least \fBsteady\fP microseconds. The +level is then reported. Level changes of less than \fBsteady\fP +microseconds are ignored. + +.br + +.br + +.EX +user_gpio: 0-31 +.br + steady: 0-300000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +.br + +.br +This filter affects the GPIO samples returned to callbacks set up +with \fBgpioSetAlertFunc\fP, \fBgpioSetAlertFuncEx\fP, \fBgpioSetGetSamplesFunc\fP, +and \fBgpioSetGetSamplesFuncEx\fP. + +.br + +.br +It does not affect interrupts set up with \fBgpioSetISRFunc\fP, +\fBgpioSetISRFuncEx\fP, or levels read by \fBgpioRead\fP, +\fBgpioRead_Bits_0_31\fP, or \fBgpioRead_Bits_32_53\fP. + +.br + +.br +Each (stable) edge will be timestamped \fBsteady\fP microseconds +after it was first detected. + +.IP "\fBint gpioSetGetSamplesFunc(gpioGetSamplesFunc_t f, uint32_t bits)\fP" +.IP "" 4 +Registers a function to be called (a callback) every millisecond +with the latest GPIO samples. + +.br + +.br + +.EX + f: the function to call +.br +bits: the GPIO of interest +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.br + +.br +The function is passed a pointer to the samples (an array of +\fBgpioSample_t\fP), and the number of samples. + +.br + +.br +Only one function can be registered. + +.br + +.br +The callback may be cancelled by passing NULL as the function. + +.br + +.br +The samples returned will be the union of bits, plus any active alerts, +plus any active notifications. + +.br + +.br +e.g. if there are alerts for GPIO 7, 8, and 9, notifications for GPIO +8, 10, 23, 24, and bits is (1<<23)|(1<<17) then samples for GPIO +7, 8, 9, 10, 17, 23, and 24 will be reported. + +.IP "\fBint gpioSetGetSamplesFuncEx(gpioGetSamplesFuncEx_t f, uint32_t bits, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) every millisecond +with the latest GPIO samples. + +.br + +.br + +.EX + f: the function to call +.br + bits: the GPIO of interest +.br +userdata: a pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.br + +.br +The function is passed a pointer to the samples (an array of +\fBgpioSample_t\fP), the number of samples, and the userdata pointer. + +.br + +.br +Only one of \fBgpioGetSamplesFunc\fP or \fBgpioGetSamplesFuncEx\fP can be +registered. + +.br + +.br +See \fBgpioSetGetSamplesFunc\fP for further details. + +.IP "\fBint gpioSetTimerFunc(unsigned timer, unsigned millis, gpioTimerFunc_t f)\fP" +.IP "" 4 +Registers a function to be called (a callback) every millis milliseconds. + +.br + +.br + +.EX + timer: 0-9 +.br +millis: 10-60000 +.br + f: the function to call +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_TIMER, PI_BAD_MS, or PI_TIMER_FAILED. + +.br + +.br +10 timers are supported numbered 0 to 9. + +.br + +.br +One function may be registered per timer. + +.br + +.br +The timer may be cancelled by passing NULL as the function. + +.br + +.br +\fBExample\fP +.br + +.EX +void bFunction(void) +.br +{ +.br + printf("two seconds have elapsed"); +.br +} +.br + +.br +// call bFunction every 2000 milliseconds +.br +gpioSetTimerFunc(0, 2000, bFunction); +.br + +.EE + +.IP "\fBint gpioSetTimerFuncEx(unsigned timer, unsigned millis, gpioTimerFuncEx_t f, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) every millis milliseconds. + +.br + +.br + +.EX + timer: 0-9. +.br + millis: 10-60000 +.br + f: the function to call +.br +userdata: a pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_TIMER, PI_BAD_MS, or PI_TIMER_FAILED. + +.br + +.br +The function is passed the userdata pointer. + +.br + +.br +Only one of \fBgpioSetTimerFunc\fP or \fBgpioSetTimerFuncEx\fP can be +registered per timer. + +.br + +.br +See \fBgpioSetTimerFunc\fP for further details. + +.IP "\fBpthread_t *gpioStartThread(gpioThreadFunc_t f, void *userdata)\fP" +.IP "" 4 +Starts a new thread of execution with f as the main routine. + +.br + +.br + +.EX + f: the main function for the new thread +.br +userdata: a pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns a pointer to pthread_t if OK, otherwise NULL. + +.br + +.br +The function is passed the single argument arg. + +.br + +.br +The thread can be cancelled by passing the pointer to pthread_t to +\fBgpioStopThread\fP. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +void *myfunc(void *arg) +.br +{ +.br + while (1) +.br + { +.br + printf("%s", arg); +.br + sleep(1); +.br + } +.br +} +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + pthread_t *p1, *p2, *p3; +.br + +.br + if (gpioInitialise() < 0) return 1; +.br + +.br + p1 = gpioStartThread(myfunc, "thread 1"); sleep(3); +.br + +.br + p2 = gpioStartThread(myfunc, "thread 2"); sleep(3); +.br + +.br + p3 = gpioStartThread(myfunc, "thread 3"); sleep(3); +.br + +.br + gpioStopThread(p3); sleep(3); +.br + +.br + gpioStopThread(p2); sleep(3); +.br + +.br + gpioStopThread(p1); sleep(3); +.br + +.br + gpioTerminate(); +.br +} +.br + +.EE + +.IP "\fBvoid gpioStopThread(pthread_t *pth)\fP" +.IP "" 4 +Cancels the thread pointed at by pth. + +.br + +.br + +.EX +pth: a thread pointer returned by \fBgpioStartThread\fP +.br + +.EE + +.br + +.br +No value is returned. + +.br + +.br +The thread to be stopped should have been started with \fBgpioStartThread\fP. + +.IP "\fBint gpioStoreScript(char *script)\fP" +.IP "" 4 +This function stores a null terminated script for later execution. + +.br + +.br +See \fBhttp://abyz.me.uk/rpi/pigpio/pigs.html#Scripts\fP for details. + +.br + +.br + +.EX +script: the text of the script +.br + +.EE + +.br + +.br +The function returns a script id if the script is valid, +otherwise PI_BAD_SCRIPT. + +.IP "\fBint gpioRunScript(unsigned script_id, unsigned numPar, uint32_t *param)\fP" +.IP "" 4 +This function runs a stored script. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBgpioStoreScript\fP +.br + numPar: 0-10, the number of parameters +.br + param: an array of parameters +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +.br + +.br +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. + +.IP "\fBint gpioUpdateScript(unsigned script_id, unsigned numPar, uint32_t *param)\fP" +.IP "" 4 +This function sets the parameters of a script. The script may or +may not be running. The first numPar parameters of the script are +overwritten with the new values. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBgpioStoreScript\fP +.br + numPar: 0-10, the number of parameters +.br + param: an array of parameters +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +.br + +.br +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. + +.IP "\fBint gpioScriptStatus(unsigned script_id, uint32_t *param)\fP" +.IP "" 4 +This function returns the run status of a stored script as well as +the current values of parameters 0 to 9. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBgpioStoreScript\fP +.br + param: an array to hold the returned 10 parameters +.br + +.EE + +.br + +.br +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +.br + +.br +The run status may be + +.br + +.br + +.EX +PI_SCRIPT_INITING +.br +PI_SCRIPT_HALTED +.br +PI_SCRIPT_RUNNING +.br +PI_SCRIPT_WAITING +.br +PI_SCRIPT_FAILED +.br + +.EE + +.br + +.br +The current value of script parameters 0 to 9 are returned in param. + +.IP "\fBint gpioStopScript(unsigned script_id)\fP" +.IP "" 4 +This function stops a running script. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBgpioStoreScript\fP +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint gpioDeleteScript(unsigned script_id)\fP" +.IP "" 4 +This function deletes a stored script. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBgpioStoreScript\fP +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint gpioSetSignalFunc(unsigned signum, gpioSignalFunc_t f)\fP" +.IP "" 4 +Registers a function to be called (a callback) when a signal occurs. + +.br + +.br + +.EX +signum: 0-63 +.br + f: the callback function +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_SIGNUM. + +.br + +.br +The function is passed the signal number. + +.br + +.br +One function may be registered per signal. + +.br + +.br +The callback may be cancelled by passing NULL. + +.br + +.br +By default all signals are treated as fatal and cause the library +to call gpioTerminate and then exit. + +.IP "\fBint gpioSetSignalFuncEx(unsigned signum, gpioSignalFuncEx_t f, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) when a signal occurs. + +.br + +.br + +.EX + signum: 0-63 +.br + f: the callback function +.br +userdata: a pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_SIGNUM. + +.br + +.br +The function is passed the signal number and the userdata pointer. + +.br + +.br +Only one of gpioSetSignalFunc or gpioSetSignalFuncEx can be +registered per signal. + +.br + +.br +See gpioSetSignalFunc for further details. + +.IP "\fBuint32_t gpioRead_Bits_0_31(void)\fP" +.IP "" 4 +Returns the current level of GPIO 0-31. + +.IP "\fBuint32_t gpioRead_Bits_32_53(void)\fP" +.IP "" 4 +Returns the current level of GPIO 32-53. + +.IP "\fBint gpioWrite_Bits_0_31_Clear(uint32_t bits)\fP" +.IP "" 4 +Clears GPIO 0-31 if the corresponding bit in bits is set. + +.br + +.br + +.EX +bits: a bit mask of GPIO to clear +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.br + +.br +\fBExample\fP +.br + +.EX +// To clear (set to 0) GPIO 4, 7, and 15 +.br +gpioWrite_Bits_0_31_Clear( (1<<4) | (1<<7) | (1<<15) ); +.br + +.EE + +.IP "\fBint gpioWrite_Bits_32_53_Clear(uint32_t bits)\fP" +.IP "" 4 +Clears GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +.br + +.br + +.EX +bits: a bit mask of GPIO to clear +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.IP "\fBint gpioWrite_Bits_0_31_Set(uint32_t bits)\fP" +.IP "" 4 +Sets GPIO 0-31 if the corresponding bit in bits is set. + +.br + +.br + +.EX +bits: a bit mask of GPIO to set +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.IP "\fBint gpioWrite_Bits_32_53_Set(uint32_t bits)\fP" +.IP "" 4 +Sets GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +.br + +.br + +.EX +bits: a bit mask of GPIO to set +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.br + +.br +\fBExample\fP +.br + +.EX +// To set (set to 1) GPIO 32, 40, and 53 +.br +gpioWrite_Bits_32_53_Set((1<<(32-32)) | (1<<(40-32)) | (1<<(53-32))); +.br + +.EE + +.IP "\fBint gpioHardwareClock(unsigned gpio, unsigned clkfreq)\fP" +.IP "" 4 +Starts a hardware clock on a GPIO at the specified frequency. +Frequencies above 30MHz are unlikely to work. + +.br + +.br + +.EX + gpio: see description +.br +clkfreq: 0 (off) or 4689-250M (13184-375M for the BCM2711) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_NOT_HCLK_GPIO, +PI_BAD_HCLK_FREQ,or PI_BAD_HCLK_PASS. + +.br + +.br +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +.br + +.br +The GPIO must be one of the following. + +.br + +.br + +.EX +4 clock 0 All models +.br +5 clock 1 All models but A and B (reserved for system use) +.br +6 clock 2 All models but A and B +.br +20 clock 0 All models but A and B +.br +21 clock 1 All models but A and Rev.2 B (reserved for system use) +.br + +.br +32 clock 0 Compute module only +.br +34 clock 0 Compute module only +.br +42 clock 1 Compute module only (reserved for system use) +.br +43 clock 2 Compute module only +.br +44 clock 1 Compute module only (reserved for system use) +.br + +.EE + +.br + +.br +Access to clock 1 is protected by a password as its use will likely +crash the Pi. The password is given by or'ing 0x5A000000 with the +GPIO number. + +.IP "\fBint gpioHardwarePWM(unsigned gpio, unsigned PWMfreq, unsigned PWMduty)\fP" +.IP "" 4 +Starts hardware PWM on a GPIO at the specified frequency and dutycycle. +Frequencies above 30MHz are unlikely to work. + +.br + +.br +NOTE: Any waveform started by \fBgpioWaveTxSend\fP, or +\fBgpioWaveChain\fP will be cancelled. + +.br + +.br +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden by a call to +\fBgpioCfgClock\fP. + +.br + +.br + +.EX + gpio: see description +.br +PWMfreq: 0 (off) or 1-125M (1-187.5M for the BCM2711) +.br +PWMduty: 0 (off) to 1000000 (1M)(fully on) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_NOT_HPWM_GPIO, +PI_BAD_HPWM_DUTY, PI_BAD_HPWM_FREQ, or PI_HPWM_ILLEGAL. + +.br + +.br +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +.br + +.br +The GPIO must be one of the following. + +.br + +.br + +.EX +12 PWM channel 0 All models but A and B +.br +13 PWM channel 1 All models but A and B +.br +18 PWM channel 0 All models +.br +19 PWM channel 1 All models but A and B +.br + +.br +40 PWM channel 0 Compute module only +.br +41 PWM channel 1 Compute module only +.br +45 PWM channel 1 Compute module only +.br +52 PWM channel 0 Compute module only +.br +53 PWM channel 1 Compute module only +.br + +.EE + +.br + +.br +The actual number of steps beween off and fully on is the +integral part of 250M/PWMfreq (375M/PWMfreq for the BCM2711). + +.br + +.br +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +.br + +.br +There will only be a million steps for a PWMfreq of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. PWMduty is +automatically scaled to take this into account. + +.IP "\fBint gpioTime(unsigned timetype, int *seconds, int *micros)\fP" +.IP "" 4 +Updates the seconds and micros variables with the current time. + +.br + +.br + +.EX +timetype: 0 (relative), 1 (absolute) +.br + seconds: a pointer to an int to hold seconds +.br + micros: a pointer to an int to hold microseconds +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_TIMETYPE. + +.br + +.br +If timetype is PI_TIME_ABSOLUTE updates seconds and micros with the +number of seconds and microseconds since the epoch (1st January 1970). + +.br + +.br +If timetype is PI_TIME_RELATIVE updates seconds and micros with the +number of seconds and microseconds since the library was initialised. + +.br + +.br +\fBExample\fP +.br + +.EX +int secs, mics; +.br + +.br +// print the number of seconds since the library was started +.br +gpioTime(PI_TIME_RELATIVE, &secs, &mics); +.br +printf("library started %d.%03d seconds ago", secs, mics/1000); +.br + +.EE + +.IP "\fBint gpioSleep(unsigned timetype, int seconds, int micros)\fP" +.IP "" 4 +Sleeps for the number of seconds and microseconds specified by seconds +and micros. + +.br + +.br + +.EX +timetype: 0 (relative), 1 (absolute) +.br + seconds: seconds to sleep +.br + micros: microseconds to sleep +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_TIMETYPE, PI_BAD_SECONDS, +or PI_BAD_MICROS. + +.br + +.br +If timetype is PI_TIME_ABSOLUTE the sleep ends when the number of seconds +and microseconds since the epoch (1st January 1970) has elapsed. System +clock changes are taken into account. + +.br + +.br +If timetype is PI_TIME_RELATIVE the sleep is for the specified number +of seconds and microseconds. System clock changes do not effect the +sleep length. + +.br + +.br +For short delays (say, 50 microseonds or less) use \fBgpioDelay\fP. + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSleep(PI_TIME_RELATIVE, 2, 500000); // sleep for 2.5 seconds +.br + +.br +gpioSleep(PI_TIME_RELATIVE, 0, 100000); // sleep for 0.1 seconds +.br + +.br +gpioSleep(PI_TIME_RELATIVE, 60, 0); // sleep for one minute +.br + +.EE + +.IP "\fBuint32_t gpioDelay(uint32_t micros)\fP" +.IP "" 4 +Delays for at least the number of microseconds specified by micros. + +.br + +.br + +.EX +micros: the number of microseconds to sleep +.br + +.EE + +.br + +.br +Returns the actual length of the delay in microseconds. + +.br + +.br +Delays of 100 microseconds or less use busy waits. + +.IP "\fBuint32_t gpioTick(void)\fP" +.IP "" 4 +Returns the current system tick. + +.br + +.br +Tick is the number of microseconds since system boot. + +.br + +.br +As tick is an unsigned 32 bit quantity it wraps around after +2^32 microseconds, which is approximately 1 hour 12 minutes. + +.br + +.br +You don't need to worry about the wrap around as long as you +take a tick (uint32_t) from another tick, i.e. the following +code will always provide the correct difference. + +.br + +.br +\fBExample\fP +.br + +.EX +uint32_t startTick, endTick; +.br +int diffTick; +.br + +.br +startTick = gpioTick(); +.br + +.br +// do some processing +.br + +.br +endTick = gpioTick(); +.br + +.br +diffTick = endTick - startTick; +.br + +.br +printf("some processing took %d microseconds", diffTick); +.br + +.EE + +.IP "\fBunsigned gpioHardwareRevision(void)\fP" +.IP "" 4 +Returns the hardware revision. + +.br + +.br +If the hardware revision can not be found or is not a valid hexadecimal +number the function returns 0. + +.br + +.br +The hardware revision is the last few characters on the Revision line of +/proc/cpuinfo. + +.br + +.br +The revision number can be used to determine the assignment of GPIO +to pins (see \fBgpio\fP). + +.br + +.br +There are at least three types of board. + +.br + +.br +Type 1 boards have hardware revision numbers of 2 and 3. + +.br + +.br +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +.br + +.br +Type 3 boards have hardware revision numbers of 16 or greater. + +.br + +.br +for "Revision : 0002" the function returns 2. +.br +for "Revision : 000f" the function returns 15. +.br +for "Revision : 000g" the function returns 0. + +.IP "\fBunsigned gpioVersion(void)\fP" +.IP "" 4 +Returns the pigpio version. + +.IP "\fBint gpioGetPad(unsigned pad)\fP" +.IP "" 4 +This function returns the pad drive strength in mA. + +.br + +.br + +.EX +pad: 0-2, the pad to get +.br + +.EE + +.br + +.br +Returns the pad drive strength if OK, otherwise PI_BAD_PAD. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +strength = gpioGetPad(1); // get pad 1 strength +.br + +.EE + +.IP "\fBint gpioSetPad(unsigned pad, unsigned padStrength)\fP" +.IP "" 4 +This function sets the pad drive strength in mA. + +.br + +.br + +.EX + pad: 0-2, the pad to set +.br +padStrength: 1-16 mA +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_PAD, or PI_BAD_STRENGTH. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +gpioSetPad(0, 16); // set pad 0 strength to 16 mA +.br + +.EE + +.IP "\fBint eventMonitor(unsigned handle, uint32_t bits)\fP" +.IP "" 4 +This function selects the events to be reported on a previously +opened handle. + +.br + +.br + +.EX +handle: >=0, as returned by \fBgpioNotifyOpen\fP +.br + bits: a bit mask indicating the events of interest +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +A report is sent each time an event is triggered providing the +corresponding bit in bits is set. + +.br + +.br +See \fBgpioNotifyBegin\fP for the notification format. + +.br + +.br +\fBExample\fP +.br + +.EX +// Start reporting events 3, 6, and 7. +.br + +.br +// bit 76543210 +.br +// (0xC8 = 0b11001000) +.br + +.br +eventMonitor(h, 0xC8); +.br + +.EE + +.br + +.br + +.IP "\fBint eventSetFunc(unsigned event, eventFunc_t f)\fP" +.IP "" 4 +Registers a function to be called (a callback) when the specified +event occurs. + +.br + +.br + +.EX +event: 0-31 +.br + f: the callback function +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +.br + +.br +One function may be registered per event. + +.br + +.br +The function is passed the event, and the tick. + +.br + +.br +The callback may be cancelled by passing NULL as the function. + +.IP "\fBint eventSetFuncEx(unsigned event, eventFuncEx_t f, void *userdata)\fP" +.IP "" 4 +Registers a function to be called (a callback) when the specified +event occurs. + +.br + +.br + +.EX + event: 0-31 +.br + f: the callback function +.br +userdata: pointer to arbitrary user data +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +.br + +.br +One function may be registered per event. + +.br + +.br +The function is passed the event, the tick, and the ueserdata pointer. + +.br + +.br +The callback may be cancelled by passing NULL as the function. + +.br + +.br +Only one of \fBeventSetFunc\fP or \fBeventSetFuncEx\fP can be +registered per event. + +.IP "\fBint eventTrigger(unsigned event)\fP" +.IP "" 4 +This function signals the occurrence of an event. + +.br + +.br + +.EX +event: 0-31, the event +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +.br + +.br +An event is a signal used to inform one or more consumers +to start an action. Each consumer which has registered an interest +in the event (e.g. by calling \fBeventSetFunc\fP) will be informed by +a callback. + +.br + +.br +One event, PI_EVENT_BSC (31) is predefined. This event is +auto generated on BSC slave activity. + +.br + +.br +The meaning of other events is arbitrary. + +.br + +.br +Note that other than its id and its tick there is no data associated +with an event. + +.IP "\fBint shell(char *scriptName, char *scriptString)\fP" +.IP "" 4 +This function uses the system call to execute a shell script +with the given string as its parameter. + +.br + +.br + +.EX + scriptName: the name of the script, only alphanumeric characters, +.br + '-' and '_' are allowed in the name +.br +scriptString: the string to pass to the script +.br + +.EE + +.br + +.br +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +.br + +.br +scriptName must exist in /opt/pigpio/cgi and must be executable. + +.br + +.br +The returned exit status is normally 256 times that set by the +shell script exit function. If the script can't be found 32512 will +be returned. + +.br + +.br +The following table gives some example returned statuses. + +.br + +.br +Script exit status Returned system call status +.br +1 256 +.br +5 1280 +.br +10 2560 +.br +200 51200 +.br +script not found 32512 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +// pass two parameters, hello and world +.br +status = shell("scr1", "hello world"); +.br + +.br +// pass three parameters, hello, string with spaces, and world +.br +status = shell("scr1", "hello 'string with spaces' world"); +.br + +.br +// pass one parameter, hello string with spaces world +.br +status = shell("scr1", "\"hello string with spaces world\""); +.br + +.EE + +.IP "\fBint fileOpen(char *file, unsigned mode)\fP" +.IP "" 4 +This function returns a handle to a file opened in a specified mode. + +.br + +.br + +.EX +file: the file to open +.br +mode: the file open mode +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, PI_NO_FILE_ACCESS, +PI_BAD_FILE_MODE, PI_FILE_OPEN_FAILED, or PI_FILE_IS_A_DIR. + +.br + +.br +File + +.br + +.br +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +.br + +.br +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +.br + +.br +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +.br + +.br +Suppose /opt/pigpio/access contains the following entries + +.br + +.br + +.EX +/home/* n +.br +/home/pi/shared/dir_1/* w +.br +/home/pi/shared/dir_2/* r +.br +/home/pi/shared/dir_3/* u +.br +/home/pi/shared/dir_1/file.txt n +.br + +.EE + +.br + +.br +Files may be written in directory dir_1 with the exception +of file.txt. + +.br + +.br +Files may be read in directory dir_2. + +.br + +.br +Files may be read and written in directory dir_3. + +.br + +.br +If a directory allows read, write, or read/write access then files may +be created in that directory. + +.br + +.br +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +.br + +.br + +.EX +a path containing .. +.br +a path containing only wildcards (*?) +.br +a path containing less than two non-wildcard parts +.br + +.EE + +.br + +.br +Mode + +.br + +.br +The mode may have the following values. + +.br + +.br +Macro Value Meaning +.br +PI_FILE_READ 1 open file for reading +.br +PI_FILE_WRITE 2 open file for writing +.br +PI_FILE_RW 3 open file for reading and writing +.br + +.br + +.br +The following values may be or'd into the mode. + +.br + +.br +Macro Value Meaning +.br +PI_FILE_APPEND 4 Writes append data to the end of the file +.br +PI_FILE_CREATE 8 The file is created if it doesn't exist +.br +PI_FILE_TRUNC 16 The file is truncated +.br + +.br + +.br +Newly created files are owned by root with permissions owner read and write. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int handle, c; +.br + char buf[60000]; +.br + +.br + if (gpioInitialise() < 0) return 1; +.br + +.br + // assumes /opt/pigpio/access contains the following line +.br + // /ram/*.c r +.br + +.br + handle = fileOpen("/ram/pigpio.c", PI_FILE_READ); +.br + +.br + if (handle >= 0) +.br + { +.br + while ((c=fileRead(handle, buf, sizeof(buf)-1))) +.br + { +.br + buf[c] = 0; +.br + printf("%s", buf); +.br + } +.br + +.br + fileClose(handle); +.br + } +.br + +.br + gpioTerminate(); +.br +} +.br + +.EE + +.IP "\fBint fileClose(unsigned handle)\fP" +.IP "" 4 +This function closes the file associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBfileOpen\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +\fBExample\fP +.br + +.EX +fileClose(h); +.br + +.EE + +.IP "\fBint fileWrite(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes from buf to the the file +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBfileOpen\fP +.br + buf: the array of bytes to write +.br + count: the number of bytes to write +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, +PI_FILE_NOT_WOPEN, or PI_BAD_FILE_WRITE. + +.br + +.br +\fBExample\fP +.br + +.EX +status = fileWrite(h, buf, count); +.br +if (status == 0) +.br +{ +.br + // okay +.br +} +.br +else +.br +{ +.br + // error +.br +} +.br + +.EE + +.IP "\fBint fileRead(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads up to count bytes from the the file +associated with handle and writes them to buf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBfileOpen\fP +.br + buf: an array to receive the read data +.br + count: the maximum number of bytes to read +.br + +.EE + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, PI_FILE_NOT_ROPEN, or PI_BAD_FILE_WRITE. + +.br + +.br +\fBExample\fP +.br + +.EX +if (fileRead(h, buf, sizeof(buf)) > 0) +.br +{ +.br + // process read data +.br +} +.br + +.EE + +.IP "\fBint fileSeek(unsigned handle, int32_t seekOffset, int seekFrom)\fP" +.IP "" 4 +This function seeks to a position within the file associated +with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBfileOpen\fP +.br +seekOffset: the number of bytes to move. Positive offsets +.br + move forward, negative offsets backwards. +.br + seekFrom: one of PI_FROM_START (0), PI_FROM_CURRENT (1), +.br + or PI_FROM_END (2) +.br + +.EE + +.br + +.br +Returns the new byte position within the file (>=0) if OK, otherwise PI_BAD_HANDLE, or PI_BAD_FILE_SEEK. + +.br + +.br +\fBExample\fP +.br + +.EX +fileSeek(0, 20, PI_FROM_START); // Seek to start plus 20 +.br + +.br +size = fileSeek(0, 0, PI_FROM_END); // Seek to end, return size +.br + +.br +pos = fileSeek(0, 0, PI_FROM_CURRENT); // Return current position +.br + +.EE + +.IP "\fBint fileList(char *fpat, char *buf, unsigned count)\fP" +.IP "" 4 +This function returns a list of files which match a pattern. The +pattern may contain wildcards. + +.br + +.br + +.EX + fpat: file pattern to match +.br + buf: an array to receive the matching file names +.br +count: the maximum number of bytes to read +.br + +.EE + +.br + +.br +Returns the number of returned bytes if OK, otherwise PI_NO_FILE_ACCESS, +or PI_NO_FILE_MATCH. + +.br + +.br +The pattern must match an entry in /opt/pigpio/access. The pattern +may contain wildcards. See \fBfileOpen\fP. + +.br + +.br +NOTE + +.br + +.br +The returned value is not the number of files, it is the number +of bytes in the buffer. The file names are separated by newline +characters. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int c; +.br + char buf[1000]; +.br + +.br + if (gpioInitialise() < 0) return 1; +.br + +.br + // assumes /opt/pigpio/access contains the following line +.br + // /ram/*.c r +.br + +.br + c = fileList("/ram/p*.c", buf, sizeof(buf)); +.br + +.br + if (c >= 0) +.br + { +.br + // terminate string +.br + buf[c] = 0; +.br + printf("%s", buf); +.br + } +.br + +.br + gpioTerminate(); +.br +} +.br + +.EE + +.IP "\fBint gpioCfgBufferSize(unsigned cfgMillis)\fP" +.IP "" 4 +Configures pigpio to buffer cfgMillis milliseconds of GPIO samples. + +.br + +.br +This function is only effective if called before \fBgpioInitialise\fP. + +.br + +.br + +.EX +cfgMillis: 100-10000 +.br + +.EE + +.br + +.br +The default setting is 120 milliseconds. + +.br + +.br +The intention is to allow for bursts of data and protection against +other processes hogging cpu time. + +.br + +.br +I haven't seen a process locked out for more than 100 milliseconds. + +.br + +.br +Making the buffer bigger uses a LOT of memory at the more frequent +sampling rates as shown in the following table in MBs. + +.br + +.br + +.EX + buffer milliseconds +.br + 120 250 500 1sec 2sec 4sec 8sec +.br + +.br + 1 16 31 55 107 --- --- --- +.br + 2 10 18 31 55 107 --- --- +.br +sample 4 8 12 18 31 55 107 --- +.br + rate 5 8 10 14 24 45 87 --- +.br + (us) 8 6 8 12 18 31 55 107 +.br + 10 6 8 10 14 24 45 87 +.br + +.EE + +.IP "\fBint gpioCfgClock(unsigned cfgMicros, unsigned cfgPeripheral, unsigned cfgSource)\fP" +.IP "" 4 +Configures pigpio to use a particular sample rate timed by a specified +peripheral. + +.br + +.br +This function is only effective if called before \fBgpioInitialise\fP. + +.br + +.br + +.EX + cfgMicros: 1, 2, 4, 5, 8, 10 +.br +cfgPeripheral: 0 (PWM), 1 (PCM) +.br + cfgSource: deprecated, value is ignored +.br + +.EE + +.br + +.br +The timings are provided by the specified peripheral (PWM or PCM). + +.br + +.br +The default setting is 5 microseconds using the PCM peripheral. + +.br + +.br +The approximate CPU percentage used for each sample rate is: + +.br + +.br + +.EX +sample cpu +.br + rate % +.br + +.br + 1 25 +.br + 2 16 +.br + 4 11 +.br + 5 10 +.br + 8 15 +.br + 10 14 +.br + +.EE + +.br + +.br +A sample rate of 5 microseconds seeems to be the sweet spot. + +.IP "\fBint gpioCfgDMAchannel(unsigned DMAchannel)\fP" +.IP "" 4 +Configures pigpio to use the specified DMA channel. + +.br + +.br +This function is only effective if called before \fBgpioInitialise\fP. + +.br + +.br + +.EX +DMAchannel: 0-14 +.br + +.EE + +.br + +.br +The default setting is to use channel 14. + +.IP "\fBint gpioCfgDMAchannels(unsigned primaryChannel, unsigned secondaryChannel)\fP" +.IP "" 4 +Configures pigpio to use the specified DMA channels. + +.br + +.br +This function is only effective if called before \fBgpioInitialise\fP. + +.br + +.br + +.EX + primaryChannel: 0-14 +.br +secondaryChannel: 0-14 +.br + +.EE + +.br + +.br +The default setting depends on whether the Pi has a BCM2711 chip or +not (currently only the Pi4B has a BCM2711). + +.br + +.br +The default setting for a non-BCM2711 is to use channel 14 for the +primary channel and channel 6 for the secondary channel. + +.br + +.br +The default setting for a BCM2711 is to use channel 7 for the +primary channel and channel 6 for the secondary channel. + +.br + +.br +The secondary channel is only used for the transmission of waves. + +.br + +.br +If possible use one of channels 0 to 6 for the secondary channel +(a full channel). + +.br + +.br +A full channel only requires one DMA control block regardless of the +length of a pulse delay. Channels 7 to 14 (lite channels) require +one DMA control block for each 16383 microseconds of delay. I.e. +a 10 second pulse delay requires one control block on a full channel +and 611 control blocks on a lite channel. + +.IP "\fBint gpioCfgPermissions(uint64_t updateMask)\fP" +.IP "" 4 +Configures pigpio to restrict GPIO updates via the socket or pipe +interfaces to the GPIO specified by the mask. Programs directly +calling the pigpio library (i.e. linked with -lpigpio are not +affected). A GPIO update is a write to a GPIO or a GPIO mode +change or any function which would force such an action. + +.br + +.br +This function is only effective if called before \fBgpioInitialise\fP. + +.br + +.br + +.EX +updateMask: bit (1<=0 +.br +arg2: >=0 +.br +argx: extra (byte) arguments +.br +argc: number of extra arguments +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.IP "\fBint gpioCustom2(unsigned arg1, char *argx, unsigned argc, char *retBuf, unsigned retMax)\fP" +.IP "" 4 +This function is available for user customisation. + +.br + +.br +It differs from gpioCustom1 in that it returns an array of bytes +rather than just an integer. + +.br + +.br +The returned value is an integer indicating the number of returned bytes. + +.EX + arg1: >=0 +.br + argx: extra (byte) arguments +.br + argc: number of extra arguments +.br +retBuf: buffer for returned bytes +.br +retMax: maximum number of bytes to return +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.br + +.br +The number of returned bytes must be retMax or less. + +.IP "\fBint rawWaveAddSPI(rawSPI_t *spi, unsigned offset, unsigned spiSS, char *buf, unsigned spiTxBits, unsigned spiBitFirst, unsigned spiBitLast, unsigned spiBits)\fP" +.IP "" 4 +This function adds a waveform representing SPI data to the +existing waveform (if any). + +.br + +.br + +.EX + spi: a pointer to a spi object +.br + offset: microseconds from the start of the waveform +.br + spiSS: the slave select GPIO +.br + buf: the bits to transmit, most significant bit first +.br + spiTxBits: the number of bits to write +.br +spiBitFirst: the first bit to read +.br + spiBitLast: the last bit to read +.br + spiBits: the number of bits to transfer +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_SER_OFFSET, or PI_TOO_MANY_PULSES. + +.br + +.br +Not intended for general use. + +.IP "\fBint rawWaveAddGeneric(unsigned numPulses, rawWave_t *pulses)\fP" +.IP "" 4 +This function adds a number of pulses to the current waveform. + +.br + +.br + +.EX +numPulses: the number of pulses +.br + pulses: the array containing the pulses +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +.br + +.br +The advantage of this function over gpioWaveAddGeneric is that it +allows the setting of the flags field. + +.br + +.br +The pulses are interleaved in time order within the existing waveform +(if any). + +.br + +.br +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +.br + +.br +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist of a delay. + +.br + +.br +Not intended for general use. + +.IP "\fBunsigned rawWaveCB(void)\fP" +.IP "" 4 +Returns the number of the cb being currently output. + +.br + +.br +Not intended for general use. + +.IP "\fBrawCbs_t *rawWaveCBAdr(int cbNum)\fP" +.IP "" 4 +Return the (Linux) address of contol block cbNum. + +.br + +.br + +.EX +cbNum: the cb of interest +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBuint32_t rawWaveGetOOL(int pos)\fP" +.IP "" 4 +Gets the OOL parameter stored at pos. + +.br + +.br + +.EX +pos: the position of interest. +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBvoid rawWaveSetOOL(int pos, uint32_t lVal)\fP" +.IP "" 4 +Sets the OOL parameter stored at pos to value. + +.br + +.br + +.EX + pos: the position of interest +.br +lVal: the value to write +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBuint32_t rawWaveGetOut(int pos)\fP" +.IP "" 4 +Gets the wave output parameter stored at pos. + +.br + +.br +DEPRECATED: use rawWaveGetOOL instead. + +.br + +.br + +.EX +pos: the position of interest. +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBvoid rawWaveSetOut(int pos, uint32_t lVal)\fP" +.IP "" 4 +Sets the wave output parameter stored at pos to value. + +.br + +.br +DEPRECATED: use rawWaveSetOOL instead. + +.br + +.br + +.EX + pos: the position of interest +.br +lVal: the value to write +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBuint32_t rawWaveGetIn(int pos)\fP" +.IP "" 4 +Gets the wave input value parameter stored at pos. + +.br + +.br +DEPRECATED: use rawWaveGetOOL instead. + +.br + +.br + +.EX +pos: the position of interest +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBvoid rawWaveSetIn(int pos, uint32_t lVal)\fP" +.IP "" 4 +Sets the wave input value stored at pos to value. + +.br + +.br +DEPRECATED: use rawWaveSetOOL instead. + +.br + +.br + +.EX + pos: the position of interest +.br +lVal: the value to write +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBrawWaveInfo_t rawWaveInfo(int wave_id)\fP" +.IP "" 4 +Gets details about the wave with id wave_id. + +.br + +.br + +.EX +wave_id: the wave of interest +.br + +.EE + +.br + +.br +Not intended for general use. + +.IP "\fBint getBitInBytes(int bitPos, char *buf, int numBits)\fP" +.IP "" 4 +Returns the value of the bit bitPos bits from the start of buf. Returns +0 if bitPos is greater than or equal to numBits. + +.br + +.br + +.EX + bitPos: bit index from the start of buf +.br + buf: array of bits +.br +numBits: number of valid bits in buf +.br + +.EE + +.br + +.br + +.IP "\fBvoid putBitInBytes(int bitPos, char *buf, int bit)\fP" +.IP "" 4 +Sets the bit bitPos bits from the start of buf to bit. + +.br + +.br + +.EX +bitPos: bit index from the start of buf +.br + buf: array of bits +.br + bit: 0-1, value to set +.br + +.EE + +.br + +.br + +.IP "\fBdouble time_time(void)\fP" +.IP "" 4 +Return the current time in seconds since the Epoch. + +.IP "\fBvoid time_sleep(double seconds)\fP" +.IP "" 4 +Delay execution for a given number of seconds + +.br + +.br + +.EX +seconds: the number of seconds to sleep +.br + +.EE + +.IP "\fBvoid rawDumpWave(void)\fP" +.IP "" 4 +Used to print a readable version of the current waveform to stderr. + +.br + +.br +Not intended for general use. + +.IP "\fBvoid rawDumpScript(unsigned script_id)\fP" +.IP "" 4 +Used to print a readable version of a script to stderr. + +.br + +.br + +.EX +script_id: >=0, a script_id returned by \fBgpioStoreScript\fP +.br + +.EE + +.br + +.br +Not intended for general use. +.SH PARAMETERS + +.br + +.br + +.IP "\fBactive\fP: 0-1000000" 0 + +.br + +.br +The number of microseconds level changes are reported for once +a noise filter has been triggered (by \fBsteady\fP microseconds of +a stable level). + +.br + +.br + +.IP "\fBarg1\fP" 0 + +.br + +.br +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBarg2\fP" 0 + +.br + +.br +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBargc\fP" 0 +The count of bytes passed to a user customised function. + +.br + +.br + +.IP "\fB*argx\fP" 0 +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +.br + +.br + +.IP "\fBbaud\fP" 0 +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +.br + +.br + +.IP "\fBbit\fP" 0 +A value of 0 or 1. + +.br + +.br + +.IP "\fBbitPos\fP" 0 +A bit position within a byte or word. The least significant bit is +position 0. + +.br + +.br + +.IP "\fBbits\fP" 0 +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +.br + +.br +A convenient way to set bit n is to or in (1<=0" 0 + +.br + +.br +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + +.br + +.br + +.IP "\fBgpio\fP" 0 + +.br + +.br +A Broadcom numbered GPIO, in the range 0-53. + +.br + +.br +There are 54 General Purpose Input Outputs (GPIO) named GPIO0 through +GPIO53. + +.br + +.br +They are split into two banks. Bank 1 consists of GPIO0 through +GPIO31. Bank 2 consists of GPIO32 through GPIO53. + +.br + +.br +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +.br + +.br +See \fBgpioHardwareRevision\fP. + +.br + +.br +The user GPIO are marked with an X in the following table. + +.br + +.br + +.EX + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +.br +Type 1 X X - - X - - X X X X X - - X X +.br +Type 2 - - X X X - - X X X X X - - X X +.br +Type 3 X X X X X X X X X X X X X X +.br + +.br + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +.br +Type 1 - X X - - X X X X X - - - - - - +.br +Type 2 - X X - - - X X X X - X X X X X +.br +Type 3 X X X X X X X X X X X X - - - - +.br + +.EE + +.br + +.br + +.IP "\fBgpioAlertFunc_t\fP" 0 + +.EX +typedef void (*gpioAlertFunc_t) (int gpio, int level, uint32_t tick); +.br + +.EE + +.br + +.br + +.IP "\fBgpioAlertFuncEx_t\fP" 0 + +.EX +typedef void (*eventFuncEx_t) +.br + (int event, int level, uint32_t tick, void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBgpioCfg*\fP" 0 + +.br + +.br +These functions are only effective if called before \fBgpioInitialise\fP. + +.br + +.br +\fBgpioCfgBufferSize\fP +.br +\fBgpioCfgClock\fP +.br +\fBgpioCfgDMAchannel\fP +.br +\fBgpioCfgDMAchannels\fP +.br +\fBgpioCfgPermissions\fP +.br +\fBgpioCfgInterfaces\fP +.br +\fBgpioCfgSocketPort\fP +.br +\fBgpioCfgMemAlloc\fP + +.br + +.br + +.IP "\fBgpioGetSamplesFunc_t\fP" 0 + +.EX +typedef void (*gpioGetSamplesFunc_t) +.br + (const gpioSample_t *samples, int numSamples); +.br + +.EE + +.br + +.br + +.IP "\fBgpioGetSamplesFuncEx_t\fP" 0 + +.EX +typedef void (*gpioGetSamplesFuncEx_t) +.br + (const gpioSample_t *samples, int numSamples, void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBgpioISRFunc_t\fP" 0 + +.EX +typedef void (*gpioISRFunc_t) +.br + (int gpio, int level, uint32_t tick); +.br + +.EE + +.br + +.br + +.IP "\fBgpioISRFuncEx_t\fP" 0 + +.EX +typedef void (*gpioISRFuncEx_t) +.br + (int gpio, int level, uint32_t tick, void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBgpioPulse_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint32_t gpioOn; +.br + uint32_t gpioOff; +.br + uint32_t usDelay; +.br +} gpioPulse_t; +.br + +.EE + +.br + +.br + +.IP "\fBgpioSample_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint32_t tick; +.br + uint32_t level; +.br +} gpioSample_t; +.br + +.EE + +.br + +.br + +.IP "\fBgpioSignalFunc_t\fP" 0 + +.EX +typedef void (*gpioSignalFunc_t) (int signum); +.br + +.EE + +.br + +.br + +.IP "\fBgpioSignalFuncEx_t\fP" 0 + +.EX +typedef void (*gpioSignalFuncEx_t) (int signum, void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBgpioThreadFunc_t\fP" 0 + +.EX +typedef void *(gpioThreadFunc_t) (void *); +.br + +.EE + +.br + +.br + +.IP "\fBgpioTimerFunc_t\fP" 0 + +.EX +typedef void (*gpioTimerFunc_t) (void); +.br + +.EE + +.br + +.br + +.IP "\fBgpioTimerFuncEx_t\fP" 0 + +.EX +typedef void (*gpioTimerFuncEx_t) (void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBgpioWaveAdd*\fP" 0 + +.br + +.br +One of + +.br + +.br +\fBgpioWaveAddNew\fP +.br +\fBgpioWaveAddGeneric\fP +.br +\fBgpioWaveAddSerial\fP + +.br + +.br + +.IP "\fBhandle\fP: >=0" 0 + +.br + +.br +A number referencing an object opened by one of + +.br + +.br +\fBfileOpen\fP +.br +\fBgpioNotifyOpen\fP +.br +\fBi2cOpen\fP +.br +\fBserOpen\fP +.br +\fBspiOpen\fP + +.br + +.br + +.IP "\fBi2cAddr\fP: 0-0x7F" 0 +The address of a device on the I2C bus. + +.br + +.br + +.IP "\fBi2cBus\fP: >=0" 0 + +.br + +.br +An I2C bus number. + +.br + +.br + +.IP "\fBi2cFlags\fP: 0" 0 + +.br + +.br +Flags which modify an I2C open command. None are currently defined. + +.br + +.br + +.IP "\fBi2cReg\fP: 0-255" 0 + +.br + +.br +A register of an I2C device. + +.br + +.br + +.IP "\fBifFlags\fP: 0-3" 0 + +.EX +PI_DISABLE_FIFO_IF 1 +.br +PI_DISABLE_SOCK_IF 2 +.br + +.EE + +.br + +.br + +.IP "\fB*inBuf\fP" 0 +A buffer used to pass data to a function. + +.br + +.br + +.IP "\fBinLen\fP" 0 +The number of bytes of data in a buffer. + +.br + +.br + +.IP "\fBint\fP" 0 +A whole number, negative or positive. + +.br + +.br + +.IP "\fBint32_t\fP" 0 +A 32-bit signed value. + +.br + +.br + +.IP "\fBinvert\fP" 0 +A flag used to set normal or inverted bit bang serial data level logic. + +.br + +.br + +.IP "\fBlevel\fP" 0 +The level of a GPIO. Low or High. + +.br + +.br + +.EX +PI_OFF 0 +.br +PI_ON 1 +.br + +.br +PI_CLEAR 0 +.br +PI_SET 1 +.br + +.br +PI_LOW 0 +.br +PI_HIGH 1 +.br + +.EE + +.br + +.br +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See \fBgpioSetWatchdog\fP. + +.br + +.br + +.EX +PI_TIMEOUT 2 +.br + +.EE + +.br + +.br + +.br + +.br + +.IP "\fBlVal\fP: 0-4294967295 (Hex 0x0-0xFFFFFFFF, Octal 0-37777777777)" 0 + +.br + +.br +A 32-bit word value. + +.br + +.br + +.IP "\fBmemAllocMode\fP: 0-2" 0 + +.br + +.br +The DMA memory allocation mode. + +.br + +.br + +.EX +PI_MEM_ALLOC_AUTO 0 +.br +PI_MEM_ALLOC_PAGEMAP 1 +.br +PI_MEM_ALLOC_MAILBOX 2 +.br + +.EE + +.br + +.br + +.IP "\fB*micros\fP" 0 + +.br + +.br +A value representing microseconds. + +.br + +.br + +.IP "\fBmicros\fP" 0 + +.br + +.br +A value representing microseconds. + +.br + +.br + +.IP "\fBmillis\fP" 0 + +.br + +.br +A value representing milliseconds. + +.br + +.br + +.IP "\fBMISO\fP" 0 +The GPIO used for the MISO signal when bit banging SPI. + +.br + +.br + +.IP "\fBmode\fP" 0 + +.br + +.br +1. The operational mode of a GPIO, normally INPUT or OUTPUT. + +.br + +.br + +.EX +PI_INPUT 0 +.br +PI_OUTPUT 1 +.br +PI_ALT0 4 +.br +PI_ALT1 5 +.br +PI_ALT2 6 +.br +PI_ALT3 7 +.br +PI_ALT4 3 +.br +PI_ALT5 2 +.br + +.EE + +.br + +.br +2. A file open mode. + +.br + +.br + +.EX +PI_FILE_READ 1 +.br +PI_FILE_WRITE 2 +.br +PI_FILE_RW 3 +.br + +.EE + +.br + +.br +The following values can be or'd into the mode. + +.br + +.br + +.EX +PI_FILE_APPEND 4 +.br +PI_FILE_CREATE 8 +.br +PI_FILE_TRUNC 16 +.br + +.EE + +.br + +.br + +.IP "\fBMOSI\fP" 0 +The GPIO used for the MOSI signal when bit banging SPI. + +.br + +.br + +.IP "\fBnumBits\fP" 0 + +.br + +.br +The number of bits stored in a buffer. + +.br + +.br + +.IP "\fBnumBytes\fP" 0 +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +.br + +.br + +.IP "\fBnumPar\fP: 0-10" 0 +The number of parameters passed to a script. + +.br + +.br + +.IP "\fBnumPulses\fP" 0 +The number of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBnumSegs\fP" 0 +The number of segments in a combined I2C transaction. + +.br + +.br + +.IP "\fBnumSockAddr\fP" 0 +The number of network addresses allowed to use the socket interface. + +.br + +.br +0 means all addresses allowed. + +.br + +.br + +.IP "\fBoffset\fP" 0 +The associated data starts this number of microseconds from the start of +the waveform. + +.br + +.br + +.IP "\fB*outBuf\fP" 0 +A buffer used to return data from a function. + +.br + +.br + +.IP "\fBoutLen\fP" 0 +The size in bytes of an output buffer. + +.br + +.br + +.IP "\fBpad\fP: 0-2" 0 +A set of GPIO which share common drivers. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br + +.IP "\fBpadStrength\fP: 1-16" 0 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +.br + +.br + +.IP "\fB*param\fP" 0 +An array of script parameters. + +.br + +.br + +.IP "\fBpctBOOL\fP: 0-100" 0 +percent On-Off-Level (OOL) buffer to consume for wave output. + +.br + +.br + +.IP "\fBpctCB\fP: 0-100" 0 +the percent of all DMA control blocks to consume. + +.br + +.br + +.IP "\fBpctTOOL\fP: 0-100" 0 +the percent of OOL buffer to consume for wave input (flags). + +.br + +.br + +.IP "\fBpi_i2c_msg_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint16_t addr; // slave address +.br + uint16_t flags; +.br + uint16_t len; // msg length +.br + uint8_t *buf; // pointer to msg data +.br +} pi_i2c_msg_t; +.br + +.EE + +.br + +.br + +.IP "\fBport\fP: 1024-32000" 0 +The port used to bind to the pigpio socket. Defaults to 8888. + +.br + +.br + +.IP "\fBpos\fP" 0 +The position of an item. + +.br + +.br + +.IP "\fBprimaryChannel\fP: 0-15" 0 +The DMA channel used to time the sampling of GPIO and to time servo and +PWM pulses. + +.br + +.br + +.IP "\fB*pth\fP" 0 + +.br + +.br +A thread identifier, returned by \fBgpioStartThread\fP. + +.br + +.br + +.IP "\fBpthread_t\fP" 0 + +.br + +.br +A thread identifier. + +.br + +.br + +.IP "\fBpud\fP: 0-2" 0 + +.br + +.br +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. + +.br + +.br + +.EX +PI_PUD_OFF 0 +.br +PI_PUD_DOWN 1 +.br +PI_PUD_UP 2 +.br + +.EE + +.br + +.br + +.IP "\fBpulseLen\fP" 0 + +.br + +.br +1-100, the length of a trigger pulse in microseconds. + +.br + +.br + +.IP "\fB*pulses\fP" 0 + +.br + +.br +An array of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBpulsewidth\fP: 0, 500-2500" 0 + +.EX +PI_SERVO_OFF 0 +.br +PI_MIN_SERVO_PULSEWIDTH 500 +.br +PI_MAX_SERVO_PULSEWIDTH 2500 +.br + +.EE + +.br + +.br + +.IP "\fBPWMduty\fP: 0-1000000 (1M)" 0 +The hardware PWM dutycycle. + +.br + +.br + +.EX +PI_HW_PWM_RANGE 1000000 +.br + +.EE + +.br + +.br + +.IP "\fBPWMfreq\fP: 1-125M (1-187.5M for the BCM2711)" 0 +The hardware PWM frequency. + +.br + +.br + +.EX +PI_HW_PWM_MIN_FREQ 1 +.br +PI_HW_PWM_MAX_FREQ 125000000 +.br +PI_HW_PWM_MAX_FREQ_2711 187500000 +.br + +.EE + +.br + +.br + +.IP "\fBrange\fP: 25-40000" 0 + +.EX +PI_MIN_DUTYCYCLE_RANGE 25 +.br +PI_MAX_DUTYCYCLE_RANGE 40000 +.br + +.EE + +.br + +.br + +.IP "\fBrawCbs_t\fP" 0 + +.EX +typedef struct // linux/arch/arm/mach-bcm2708/include/mach/dma.h +.br +{ +.br + unsigned long info; +.br + unsigned long src; +.br + unsigned long dst; +.br + unsigned long length; +.br + unsigned long stride; +.br + unsigned long next; +.br + unsigned long pad[2]; +.br +} rawCbs_t; +.br + +.EE + +.br + +.br + +.IP "\fBrawSPI_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + int clk; // GPIO for clock +.br + int mosi; // GPIO for MOSI +.br + int miso; // GPIO for MISO +.br + int ss_pol; // slave select off state +.br + int ss_us; // delay after slave select +.br + int clk_pol; // clock off state +.br + int clk_pha; // clock phase +.br + int clk_us; // clock micros +.br +} rawSPI_t; +.br + +.EE + +.br + +.br + +.IP "\fBrawWave_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint32_t gpioOn; +.br + uint32_t gpioOff; +.br + uint32_t usDelay; +.br + uint32_t flags; +.br +} rawWave_t; +.br + +.EE + +.br + +.br + +.IP "\fBrawWaveInfo_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint16_t botCB; // first CB used by wave +.br + uint16_t topCB; // last CB used by wave +.br + uint16_t botOOL; // last OOL used by wave +.br + uint16_t topOOL; // first OOL used by wave +.br + uint16_t deleted; +.br + uint16_t numCB; +.br + uint16_t numBOOL; +.br + uint16_t numTOOL; +.br +} rawWaveInfo_t; +.br + +.EE + +.br + +.br + +.IP "\fB*retBuf\fP" 0 + +.br + +.br +A buffer to hold a number of bytes returned to a used customised function, + +.br + +.br + +.IP "\fBretMax\fP" 0 + +.br + +.br +The maximum number of bytes a user customised function should return. + +.br + +.br + +.IP "\fB*rxBuf\fP" 0 + +.br + +.br +A pointer to a buffer to receive data. + +.br + +.br + +.IP "\fBSCL\fP" 0 +The user GPIO to use for the clock when bit banging I2C. + +.br + +.br + +.IP "\fBSCLK\fP" 0 +The GPIO used for the SCLK signal when bit banging SPI. + +.br + +.br + +.IP "\fB*script\fP" 0 +A pointer to the text of a script. + +.br + +.br + +.IP "\fBscript_id\fP" 0 +An id of a stored script as returned by \fBgpioStoreScript\fP. + +.br + +.br + +.IP "\fB*scriptName\fP" 0 +The name of a \fBshell\fP script to be executed. The script must be present in +/opt/pigpio/cgi and must have execute permission. + +.br + +.br + +.IP "\fB*scriptString\fP" 0 +The string to be passed to a \fBshell\fP script to be executed. + +.br + +.br + +.IP "\fBSDA\fP" 0 +The user GPIO to use for data when bit banging I2C. + +.br + +.br + +.IP "\fBsecondaryChannel\fP: 0-6" 0 + +.br + +.br +The DMA channel used to time output waveforms. + +.br + +.br + +.IP "\fB*seconds\fP" 0 + +.br + +.br +A pointer to a uint32_t to store the second component of +a returned time. + +.br + +.br + +.IP "\fBseconds\fP" 0 +The number of seconds. + +.br + +.br + +.IP "\fBseekFrom\fP" 0 + +.br + +.br + +.EX +PI_FROM_START 0 +.br +PI_FROM_CURRENT 1 +.br +PI_FROM_END 2 +.br + +.EE + +.br + +.br + +.IP "\fBseekOffset\fP" 0 +The number of bytes to move forward (positive) or backwards (negative) +from the seek position (start, current, or end of file). + +.br + +.br + +.IP "\fB*segs\fP" 0 +An array of segments which make up a combined I2C transaction. + +.br + +.br + +.IP "\fBserFlags\fP" 0 +Flags which modify a serial open command. None are currently defined. + +.br + +.br + +.IP "\fB*sertty\fP" 0 +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +.br + +.br + +.IP "\fBsetting\fP" 0 +A value used to set a flag, 0 for false, non-zero for true. + +.br + +.br + +.IP "\fBsignum\fP: 0-63" 0 + +.EX +PI_MIN_SIGNUM 0 +.br +PI_MAX_SIGNUM 63 +.br + +.EE + +.br + +.br + +.IP "\fBsize_t\fP" 0 + +.br + +.br +A standard type used to indicate the size of an object in bytes. + +.br + +.br + +.IP "\fB*sockAddr\fP" 0 +An array of network addresses allowed to use the socket interface encoded +as 32 bit numbers. + +.br + +.br +E.g. address 192.168.1.66 would be encoded as 0x4201a8c0. + +.br + +.br + +.IP "\fB*spi\fP" 0 +A pointer to a \fBrawSPI_t\fP structure. + +.br + +.br + +.IP "\fBspiBitFirst\fP" 0 +GPIO reads are made from spiBitFirst to spiBitLast. + +.br + +.br + +.IP "\fBspiBitLast\fP" 0 + +.br + +.br +GPIO reads are made from spiBitFirst to spiBitLast. + +.br + +.br + +.IP "\fBspiBits\fP" 0 +The number of bits to transfer in a raw SPI transaction. + +.br + +.br + +.IP "\fBspiChan\fP" 0 +A SPI channel, 0-2. + +.br + +.br + +.IP "\fBspiFlags\fP" 0 +See \fBspiOpen\fP and \fBbbSPIOpen\fP. + +.br + +.br + +.IP "\fBspiSS\fP" 0 +The SPI slave select GPIO in a raw SPI transaction. + +.br + +.br + +.IP "\fBspiTxBits\fP" 0 +The number of bits to transfer dring a raw SPI transaction + +.br + +.br + +.IP "\fBsteady\fP: 0-300000" 0 + +.br + +.br +The number of microseconds level changes must be stable for +before reporting the level changed (\fBgpioGlitchFilter\fP) or triggering +the active part of a noise filter (\fBgpioNoiseFilter\fP). + +.br + +.br + +.IP "\fBstop_bits\fP: 2-8" 0 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +.br + +.br + +.EX +PI_MIN_WAVE_HALFSTOPBITS 2 +.br +PI_MAX_WAVE_HALFSTOPBITS 8 +.br + +.EE + +.br + +.br + +.IP "\fB*str\fP" 0 +An array of characters. + +.br + +.br + +.IP "\fBtimeout\fP" 0 +A GPIO level change timeout in milliseconds. + +.br + +.br +\fBgpioSetWatchdog\fP + +.EX +PI_MIN_WDOG_TIMEOUT 0 +.br +PI_MAX_WDOG_TIMEOUT 60000 +.br + +.EE + +.br + +.br +\fBgpioSetISRFunc\fP and \fBgpioSetISRFuncEx\fP + +.EX +<=0 cancel timeout +.br +>0 timeout after specified milliseconds +.br + +.EE + +.br + +.br + +.IP "\fBtimer\fP" 0 + +.EX +PI_MIN_TIMER 0 +.br +PI_MAX_TIMER 9 +.br + +.EE + +.br + +.br + +.IP "\fBtimetype\fP" 0 + +.EX +PI_TIME_RELATIVE 0 +.br +PI_TIME_ABSOLUTE 1 +.br + +.EE + +.br + +.br + +.IP "\fB*txBuf\fP" 0 + +.br + +.br +An array of bytes to transmit. + +.br + +.br + +.IP "\fBuint32_t\fP: 0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF)" 0 + +.br + +.br +A 32-bit unsigned value. + +.br + +.br + +.IP "\fBuint64_t\fP: 0-(2^64)-1" 0 + +.br + +.br +A 64-bit unsigned value. + +.br + +.br + +.IP "\fBunsigned\fP" 0 + +.br + +.br +A whole number >= 0. + +.br + +.br + +.IP "\fBupdateMask\fP" 0 + +.br + +.br +A 64 bit mask indicating which GPIO may be written to by the user. + +.br + +.br +If GPIO#n may be written then bit (1< 4 +.br +#define PI_BAD_CHANNEL -27 // DMA channel not 0-15 +.br +#define PI_BAD_PRIM_CHANNEL -27 // DMA primary channel not 0-15 +.br +#define PI_BAD_SOCKET_PORT -28 // socket port not 1024-32000 +.br +#define PI_BAD_FIFO_COMMAND -29 // unrecognized fifo command +.br +#define PI_BAD_SECO_CHANNEL -30 // DMA secondary channel not 0-15 +.br +#define PI_NOT_INITIALISED -31 // function called before gpioInitialise +.br +#define PI_INITIALISED -32 // function called after gpioInitialise +.br +#define PI_BAD_WAVE_MODE -33 // waveform mode not 0-3 +.br +#define PI_BAD_CFG_INTERNAL -34 // bad parameter in gpioCfgInternals call +.br +#define PI_BAD_WAVE_BAUD -35 // baud rate not 50-250K(RX)/50-1M(TX) +.br +#define PI_TOO_MANY_PULSES -36 // waveform has too many pulses +.br +#define PI_TOO_MANY_CHARS -37 // waveform has too many chars +.br +#define PI_NOT_SERIAL_GPIO -38 // no bit bang serial read on GPIO +.br +#define PI_BAD_SERIAL_STRUC -39 // bad (null) serial structure parameter +.br +#define PI_BAD_SERIAL_BUF -40 // bad (null) serial buf parameter +.br +#define PI_NOT_PERMITTED -41 // GPIO operation not permitted +.br +#define PI_SOME_PERMITTED -42 // one or more GPIO not permitted +.br +#define PI_BAD_WVSC_COMMND -43 // bad WVSC subcommand +.br +#define PI_BAD_WVSM_COMMND -44 // bad WVSM subcommand +.br +#define PI_BAD_WVSP_COMMND -45 // bad WVSP subcommand +.br +#define PI_BAD_PULSELEN -46 // trigger pulse length not 1-100 +.br +#define PI_BAD_SCRIPT -47 // invalid script +.br +#define PI_BAD_SCRIPT_ID -48 // unknown script id +.br +#define PI_BAD_SER_OFFSET -49 // add serial data offset > 30 minutes +.br +#define PI_GPIO_IN_USE -50 // GPIO already in use +.br +#define PI_BAD_SERIAL_COUNT -51 // must read at least a byte at a time +.br +#define PI_BAD_PARAM_NUM -52 // script parameter id not 0-9 +.br +#define PI_DUP_TAG -53 // script has duplicate tag +.br +#define PI_TOO_MANY_TAGS -54 // script has too many tags +.br +#define PI_BAD_SCRIPT_CMD -55 // illegal script command +.br +#define PI_BAD_VAR_NUM -56 // script variable id not 0-149 +.br +#define PI_NO_SCRIPT_ROOM -57 // no more room for scripts +.br +#define PI_NO_MEMORY -58 // can't allocate temporary memory +.br +#define PI_SOCK_READ_FAILED -59 // socket read failed +.br +#define PI_SOCK_WRIT_FAILED -60 // socket write failed +.br +#define PI_TOO_MANY_PARAM -61 // too many script parameters (> 10) +.br +#define PI_NOT_HALTED -62 // DEPRECATED +.br +#define PI_SCRIPT_NOT_READY -62 // script initialising +.br +#define PI_BAD_TAG -63 // script has unresolved tag +.br +#define PI_BAD_MICS_DELAY -64 // bad MICS delay (too large) +.br +#define PI_BAD_MILS_DELAY -65 // bad MILS delay (too large) +.br +#define PI_BAD_WAVE_ID -66 // non existent wave id +.br +#define PI_TOO_MANY_CBS -67 // No more CBs for waveform +.br +#define PI_TOO_MANY_OOL -68 // No more OOL for waveform +.br +#define PI_EMPTY_WAVEFORM -69 // attempt to create an empty waveform +.br +#define PI_NO_WAVEFORM_ID -70 // no more waveforms +.br +#define PI_I2C_OPEN_FAILED -71 // can't open I2C device +.br +#define PI_SER_OPEN_FAILED -72 // can't open serial device +.br +#define PI_SPI_OPEN_FAILED -73 // can't open SPI device +.br +#define PI_BAD_I2C_BUS -74 // bad I2C bus +.br +#define PI_BAD_I2C_ADDR -75 // bad I2C address +.br +#define PI_BAD_SPI_CHANNEL -76 // bad SPI channel +.br +#define PI_BAD_FLAGS -77 // bad i2c/spi/ser open flags +.br +#define PI_BAD_SPI_SPEED -78 // bad SPI speed +.br +#define PI_BAD_SER_DEVICE -79 // bad serial device name +.br +#define PI_BAD_SER_SPEED -80 // bad serial baud rate +.br +#define PI_BAD_PARAM -81 // bad i2c/spi/ser parameter +.br +#define PI_I2C_WRITE_FAILED -82 // i2c write failed +.br +#define PI_I2C_READ_FAILED -83 // i2c read failed +.br +#define PI_BAD_SPI_COUNT -84 // bad SPI count +.br +#define PI_SER_WRITE_FAILED -85 // ser write failed +.br +#define PI_SER_READ_FAILED -86 // ser read failed +.br +#define PI_SER_READ_NO_DATA -87 // ser read no data available +.br +#define PI_UNKNOWN_COMMAND -88 // unknown command +.br +#define PI_SPI_XFER_FAILED -89 // spi xfer/read/write failed +.br +#define PI_BAD_POINTER -90 // bad (NULL) pointer +.br +#define PI_NO_AUX_SPI -91 // no auxiliary SPI on Pi A or B +.br +#define PI_NOT_PWM_GPIO -92 // GPIO is not in use for PWM +.br +#define PI_NOT_SERVO_GPIO -93 // GPIO is not in use for servo pulses +.br +#define PI_NOT_HCLK_GPIO -94 // GPIO has no hardware clock +.br +#define PI_NOT_HPWM_GPIO -95 // GPIO has no hardware PWM +.br +#define PI_BAD_HPWM_FREQ -96 // invalid hardware PWM frequency +.br +#define PI_BAD_HPWM_DUTY -97 // hardware PWM dutycycle not 0-1M +.br +#define PI_BAD_HCLK_FREQ -98 // invalid hardware clock frequency +.br +#define PI_BAD_HCLK_PASS -99 // need password to use hardware clock 1 +.br +#define PI_HPWM_ILLEGAL -100 // illegal, PWM in use for main clock +.br +#define PI_BAD_DATABITS -101 // serial data bits not 1-32 +.br +#define PI_BAD_STOPBITS -102 // serial (half) stop bits not 2-8 +.br +#define PI_MSG_TOOBIG -103 // socket/pipe message too big +.br +#define PI_BAD_MALLOC_MODE -104 // bad memory allocation mode +.br +#define PI_TOO_MANY_SEGS -105 // too many I2C transaction segments +.br +#define PI_BAD_I2C_SEG -106 // an I2C transaction segment failed +.br +#define PI_BAD_SMBUS_CMD -107 // SMBus command not supported by driver +.br +#define PI_NOT_I2C_GPIO -108 // no bit bang I2C in progress on GPIO +.br +#define PI_BAD_I2C_WLEN -109 // bad I2C write length +.br +#define PI_BAD_I2C_RLEN -110 // bad I2C read length +.br +#define PI_BAD_I2C_CMD -111 // bad I2C command +.br +#define PI_BAD_I2C_BAUD -112 // bad I2C baud rate, not 50-500k +.br +#define PI_CHAIN_LOOP_CNT -113 // bad chain loop count +.br +#define PI_BAD_CHAIN_LOOP -114 // empty chain loop +.br +#define PI_CHAIN_COUNTER -115 // too many chain counters +.br +#define PI_BAD_CHAIN_CMD -116 // bad chain command +.br +#define PI_BAD_CHAIN_DELAY -117 // bad chain delay micros +.br +#define PI_CHAIN_NESTING -118 // chain counters nested too deeply +.br +#define PI_CHAIN_TOO_BIG -119 // chain is too long +.br +#define PI_DEPRECATED -120 // deprecated function removed +.br +#define PI_BAD_SER_INVERT -121 // bit bang serial invert not 0 or 1 +.br +#define PI_BAD_EDGE -122 // bad ISR edge value, not 0-2 +.br +#define PI_BAD_ISR_INIT -123 // bad ISR initialisation +.br +#define PI_BAD_FOREVER -124 // loop forever must be last command +.br +#define PI_BAD_FILTER -125 // bad filter parameter +.br +#define PI_BAD_PAD -126 // bad pad number +.br +#define PI_BAD_STRENGTH -127 // bad pad drive strength +.br +#define PI_FIL_OPEN_FAILED -128 // file open failed +.br +#define PI_BAD_FILE_MODE -129 // bad file mode +.br +#define PI_BAD_FILE_FLAG -130 // bad file flag +.br +#define PI_BAD_FILE_READ -131 // bad file read +.br +#define PI_BAD_FILE_WRITE -132 // bad file write +.br +#define PI_FILE_NOT_ROPEN -133 // file not open for read +.br +#define PI_FILE_NOT_WOPEN -134 // file not open for write +.br +#define PI_BAD_FILE_SEEK -135 // bad file seek +.br +#define PI_NO_FILE_MATCH -136 // no files match pattern +.br +#define PI_NO_FILE_ACCESS -137 // no permission to access file +.br +#define PI_FILE_IS_A_DIR -138 // file is a directory +.br +#define PI_BAD_SHELL_STATUS -139 // bad shell return status +.br +#define PI_BAD_SCRIPT_NAME -140 // bad script name +.br +#define PI_BAD_SPI_BAUD -141 // bad SPI baud rate, not 50-500k +.br +#define PI_NOT_SPI_GPIO -142 // no bit bang SPI in progress on GPIO +.br +#define PI_BAD_EVENT_ID -143 // bad event id +.br +#define PI_CMD_INTERRUPTED -144 // Used by Python +.br +#define PI_NOT_ON_BCM2711 -145 // not available on BCM2711 +.br +#define PI_ONLY_ON_BCM2711 -146 // only available on BCM2711 +.br + +.br +#define PI_PIGIF_ERR_0 -2000 +.br +#define PI_PIGIF_ERR_99 -2099 +.br + +.br +#define PI_CUSTOM_ERR_0 -3000 +.br +#define PI_CUSTOM_ERR_999 -3999 +.br + +.br + +.EE +.SH Defaults + +.EX + +.br +#define PI_DEFAULT_BUFFER_MILLIS 120 +.br +#define PI_DEFAULT_CLK_MICROS 5 +.br +#define PI_DEFAULT_CLK_PERIPHERAL PI_CLOCK_PCM +.br +#define PI_DEFAULT_IF_FLAGS 0 +.br +#define PI_DEFAULT_FOREGROUND 0 +.br +#define PI_DEFAULT_DMA_CHANNEL 14 +.br +#define PI_DEFAULT_DMA_PRIMARY_CHANNEL 14 +.br +#define PI_DEFAULT_DMA_SECONDARY_CHANNEL 6 +.br +#define PI_DEFAULT_DMA_PRIMARY_CH_2711 7 +.br +#define PI_DEFAULT_DMA_SECONDARY_CH_2711 6 +.br +#define PI_DEFAULT_DMA_NOT_SET 15 +.br +#define PI_DEFAULT_SOCKET_PORT 8888 +.br +#define PI_DEFAULT_SOCKET_PORT_STR "8888" +.br +#define PI_DEFAULT_SOCKET_ADDR_STR "localhost" +.br +#define PI_DEFAULT_UPDATE_MASK_UNKNOWN 0x0000000FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_B1 0x03E7CF93 +.br +#define PI_DEFAULT_UPDATE_MASK_A_B2 0xFBC7CF9C +.br +#define PI_DEFAULT_UPDATE_MASK_APLUS_BPLUS 0x0080480FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_ZERO 0x0080000FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_PI2B 0x0080480FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_PI3B 0x0000000FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_PI4B 0x0000000FFFFFFCLL +.br +#define PI_DEFAULT_UPDATE_MASK_COMPUTE 0x00FFFFFFFFFFFFLL +.br +#define PI_DEFAULT_MEM_ALLOC_MODE PI_MEM_ALLOC_AUTO +.br + +.br +#define PI_DEFAULT_CFG_INTERNALS 0 +.br + +.br + +.EE + +.SH SEE ALSO + +pigpiod(1), pig2vcd(1), pigs(1), pigpiod_if(3), pigpiod_if2(3) +.SH AUTHOR + +joan@abyz.me.uk diff --git a/pigpio-master/pigpio.c b/pigpio-master/pigpio.c new file mode 100644 index 0000000..97bfc54 --- /dev/null +++ b/pigpio-master/pigpio.c @@ -0,0 +1,14036 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* pigpio version 79 */ + +/* include ------------------------------------------------------- */ + +#define _GNU_SOURCE + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" + +#include "command.h" + + +/* --------------------------------------------------------------- */ + +/* + 0 GPFSEL0 GPIO Function Select 0 + 1 GPFSEL1 GPIO Function Select 1 + 2 GPFSEL2 GPIO Function Select 2 + 3 GPFSEL3 GPIO Function Select 3 + 4 GPFSEL4 GPIO Function Select 4 + 5 GPFSEL5 GPIO Function Select 5 + 6 - Reserved + 7 GPSET0 GPIO Pin Output Set 0 + 8 GPSET1 GPIO Pin Output Set 1 + 9 - Reserved +10 GPCLR0 GPIO Pin Output Clear 0 +11 GPCLR1 GPIO Pin Output Clear 1 +12 - Reserved +13 GPLEV0 GPIO Pin Level 0 +14 GPLEV1 GPIO Pin Level 1 +15 - Reserved +16 GPEDS0 GPIO Pin Event Detect Status 0 +17 GPEDS1 GPIO Pin Event Detect Status 1 +18 - Reserved +19 GPREN0 GPIO Pin Rising Edge Detect Enable 0 +20 GPREN1 GPIO Pin Rising Edge Detect Enable 1 +21 - Reserved +22 GPFEN0 GPIO Pin Falling Edge Detect Enable 0 +23 GPFEN1 GPIO Pin Falling Edge Detect Enable 1 +24 - Reserved +25 GPHEN0 GPIO Pin High Detect Enable 0 +26 GPHEN1 GPIO Pin High Detect Enable 1 +27 - Reserved +28 GPLEN0 GPIO Pin Low Detect Enable 0 +29 GPLEN1 GPIO Pin Low Detect Enable 1 +30 - Reserved +31 GPAREN0 GPIO Pin Async. Rising Edge Detect 0 +32 GPAREN1 GPIO Pin Async. Rising Edge Detect 1 +33 - Reserved +34 GPAFEN0 GPIO Pin Async. Falling Edge Detect 0 +35 GPAFEN1 GPIO Pin Async. Falling Edge Detect 1 +36 - Reserved +37 GPPUD GPIO Pin Pull-up/down Enable +38 GPPUDCLK0 GPIO Pin Pull-up/down Enable Clock 0 +39 GPPUDCLK1 GPIO Pin Pull-up/down Enable Clock 1 +40 - Reserved +41 - Test +42-56 Reserved +57 GPPUPPDN1 Pin pull-up/down for pins 15:0 +58 GPPUPPDN1 Pin pull-up/down for pins 31:16 +59 GPPUPPDN2 Pin pull-up/down for pins 47:32 +60 GPPUPPDN3 Pin pull-up/down for pins 57:48 +*/ + +/* +0 CS DMA Channel 0 Control and Status +1 CPI_ONBLK_AD DMA Channel 0 Control Block Address +2 TI DMA Channel 0 CB Word 0 (Transfer Information) +3 SOURCE_AD DMA Channel 0 CB Word 1 (Source Address) +4 DEST_AD DMA Channel 0 CB Word 2 (Destination Address) +5 TXFR_LEN DMA Channel 0 CB Word 3 (Transfer Length) +6 STRIDE DMA Channel 0 CB Word 4 (2D Stride) +7 NEXTCPI_ONBK DMA Channel 0 CB Word 5 (Next CB Address) +8 DEBUG DMA Channel 0 Debug +*/ + +/* +DEBUG register bits + +bit 2 READ_ERROR + + Slave Read Response Error RW 0x0 + + Set if the read operation returned an error value on + the read response bus. It can be cleared by writing + a 1. + +bit 1 FIFO_ERROR + + Fifo Error RW 0x0 + + Set if the optional read Fifo records an error + condition. It can be cleared by writing a 1. + +bit 0 READ_LAST_NOT_SET_ERROR + + Read Last Not Set Error RW 0x0 + + If the AXI read last signal was not set when + expected, then this error bit will be set. It can be + cleared by writing a 1. +*/ + +/* +0 CTL PWM Control +1 STA PWM Status +2 DMAC PWM DMA Configuration +4 RNG1 PWM Channel 1 Range +5 DAT1 PWM Channel 1 Data +6 FIF1 PWM FIFO Input +8 RNG2 PWM Channel 2 Range +9 DAT2 PWM Channel 2 Data +*/ + +/* +0 PCM_CS PCM Control and Status +1 PCM_FIFO PCM FIFO Data +2 PCM_MODE PCM Mode +3 PCM_RXC PCM Receive Configuration +4 PCM_TXC PCM Transmit Configuration +5 PCM_DREQ PCM DMA Request Level +6 PCM_INTEN PCM Interrupt Enables +7 PCM_INTSTC PCM Interrupt Status & Clear +8 PCM_GRAY PCM Gray Mode Control +*/ + +/* +0 CS System Timer Control/Status +1 CLO System Timer Counter Lower 32 bits +2 CHI System Timer Counter Higher 32 bits +3 C0 System Timer Compare 0 +4 C1 System Timer Compare 1 +5 C2 System Timer Compare 2 +6 C3 System Timer Compare 3 +*/ + +/* define -------------------------------------------------------- */ + +#define THOUSAND 1000 +#define MILLION 1000000 +#define BILLION 1000000000 + +#define BANK (gpio>>5) + +#define BIT (1<<(gpio&0x1F)) + +#ifndef EMBEDDED_IN_VM +#define DBG(level, format, arg...) DO_DBG(level, format, ## arg) +#else +#define DBG(level, format, arg...) +#endif + +#define DO_DBG(level, format, arg...) \ + { \ + if ((gpioCfg.dbgLevel >= level) && \ + (!(gpioCfg.internals & PI_CFG_NOSIGHANDLER))) \ + fprintf(stderr, "%s %s: " format "\n" , \ + myTimeStamp(), __FUNCTION__ , ## arg); \ + } + +#ifndef DISABLE_SER_CHECK_INITED +#define SER_CHECK_INITED CHECK_INITED +#else +#define SER_CHECK_INITED +#endif + +#define CHECK_INITED \ + do \ + { \ + if (!libInitialised) \ + { \ + DBG(DBG_ALWAYS, \ + "pigpio uninitialised, call gpioInitialise()"); \ + return PI_NOT_INITIALISED; \ + } \ + } \ + while (0) + +#define CHECK_INITED_RET_NULL_PTR \ + do \ + { \ + if (!libInitialised) \ + { \ + DBG(DBG_ALWAYS, \ + "pigpio uninitialised, call gpioInitialise()"); \ + return (NULL); \ + } \ + } \ + while (0) + +#define CHECK_INITED_RET_NIL \ + do \ + { \ + if (!libInitialised) \ + { \ + DBG(DBG_ALWAYS, \ + "pigpio uninitialised, call gpioInitialise()"); \ + } \ + } \ + while (0) + +#define CHECK_NOT_INITED \ + do \ + { \ + if (libInitialised) \ + { \ + DBG(DBG_ALWAYS, \ + "pigpio initialised, call gpioTerminate()"); \ + return PI_INITIALISED; \ + } \ + } \ + while (0) + +#define SOFT_ERROR(x, format, arg...) \ + do \ + { \ + DBG(DBG_ALWAYS, format, ## arg); \ + return x; \ + } \ + while (0) + +#define TIMER_ADD(a, b, result) \ + do \ + { \ + (result)->tv_sec = (a)->tv_sec + (b)->tv_sec; \ + (result)->tv_nsec = (a)->tv_nsec + (b)->tv_nsec; \ + if ((result)->tv_nsec >= BILLION) \ + { \ + ++(result)->tv_sec; \ + (result)->tv_nsec -= BILLION; \ + } \ + } \ + while (0) + +#define TIMER_SUB(a, b, result) \ + do \ + { \ + (result)->tv_sec = (a)->tv_sec - (b)->tv_sec; \ + (result)->tv_nsec = (a)->tv_nsec - (b)->tv_nsec; \ + if ((result)->tv_nsec < 0) \ + { \ + --(result)->tv_sec; \ + (result)->tv_nsec += BILLION; \ + } \ + } \ + while (0) + +#define PI_PERI_BUS 0x7E000000 + +#define AUX_BASE (pi_peri_phys + 0x00215000) +#define BSCS_BASE (pi_peri_phys + 0x00214000) +#define CLK_BASE (pi_peri_phys + 0x00101000) +#define DMA_BASE (pi_peri_phys + 0x00007000) +#define DMA15_BASE (pi_peri_phys + 0x00E05000) +#define GPIO_BASE (pi_peri_phys + 0x00200000) +#define PADS_BASE (pi_peri_phys + 0x00100000) +#define PCM_BASE (pi_peri_phys + 0x00203000) +#define PWM_BASE (pi_peri_phys + 0x0020C000) +#define SPI_BASE (pi_peri_phys + 0x00204000) +#define SYST_BASE (pi_peri_phys + 0x00003000) + +#define AUX_LEN 0xD8 +#define BSCS_LEN 0x40 +#define CLK_LEN 0xA8 +#define DMA_LEN 0x1000 /* allow access to all channels */ +#define GPIO_LEN 0xF4 /* 2711 has more registers */ +#define PADS_LEN 0x38 +#define PCM_LEN 0x24 +#define PWM_LEN 0x28 +#define SPI_LEN 0x18 +#define SYST_LEN 0x1C + +#define DMA_ENABLE (0xFF0/4) + +#define GPFSEL0 0 + +#define GPSET0 7 +#define GPSET1 8 + +#define GPCLR0 10 +#define GPCLR1 11 + +#define GPLEV0 13 +#define GPLEV1 14 + +#define GPEDS0 16 +#define GPEDS1 17 + +#define GPREN0 19 +#define GPREN1 20 +#define GPFEN0 22 +#define GPFEN1 23 +#define GPHEN0 25 +#define GPHEN1 26 +#define GPLEN0 28 +#define GPLEN1 29 +#define GPAREN0 31 +#define GPAREN1 32 +#define GPAFEN0 34 +#define GPAFEN1 35 + +#define GPPUD 37 +#define GPPUDCLK0 38 +#define GPPUDCLK1 39 + +/* BCM2711 has different pulls */ + +#define GPPUPPDN0 57 +#define GPPUPPDN1 58 +#define GPPUPPDN2 59 +#define GPPUPPDN3 60 + +#define DMA_CS 0 +#define DMA_CONBLK_AD 1 +#define DMA_DEBUG 8 + +/* DMA CS Control and Status bits */ +#define DMA_CHANNEL_RESET (1<<31) +#define DMA_CHANNEL_ABORT (1<<30) +#define DMA_WAIT_ON_WRITES (1<<28) +#define DMA_PANIC_PRIORITY(x) ((x)<<20) +#define DMA_PRIORITY(x) ((x)<<16) +#define DMA_INTERRUPT_STATUS (1<< 2) +#define DMA_END_FLAG (1<< 1) +#define DMA_ACTIVE (1<< 0) + +/* DMA control block "info" field bits */ +#define DMA_NO_WIDE_BURSTS (1<<26) +#define DMA_PERIPHERAL_MAPPING(x) ((x)<<16) +#define DMA_BURST_LENGTH(x) ((x)<<12) +#define DMA_SRC_IGNORE (1<<11) +#define DMA_SRC_DREQ (1<<10) +#define DMA_SRC_WIDTH (1<< 9) +#define DMA_SRC_INC (1<< 8) +#define DMA_DEST_IGNORE (1<< 7) +#define DMA_DEST_DREQ (1<< 6) +#define DMA_DEST_WIDTH (1<< 5) +#define DMA_DEST_INC (1<< 4) +#define DMA_WAIT_RESP (1<< 3) +#define DMA_TDMODE (1<< 1) + +#define DMA_DEBUG_READ_ERR (1<<2) +#define DMA_DEBUG_FIFO_ERR (1<<1) +#define DMA_DEBUG_RD_LST_NOT_SET_ERR (1<<0) + +#define DMA_LITE_FIRST 7 +#define DMA_LITE_MAX 0xfffc + +#define PWM_CTL 0 +#define PWM_STA 1 +#define PWM_DMAC 2 +#define PWM_RNG1 4 +#define PWM_DAT1 5 +#define PWM_FIFO 6 +#define PWM_RNG2 8 +#define PWM_DAT2 9 + +#define PWM_CTL_MSEN2 (1<<15) +#define PWM_CTL_PWEN2 (1<<8) +#define PWM_CTL_MSEN1 (1<<7) +#define PWM_CTL_CLRF1 (1<<6) +#define PWM_CTL_USEF1 (1<<5) +#define PWM_CTL_MODE1 (1<<1) +#define PWM_CTL_PWEN1 (1<<0) + +#define PWM_DMAC_ENAB (1 <<31) +#define PWM_DMAC_PANIC(x) ((x)<< 8) +#define PWM_DMAC_DREQ(x) (x) + +#define PCM_CS 0 +#define PCM_FIFO 1 +#define PCM_MODE 2 +#define PCM_RXC 3 +#define PCM_TXC 4 +#define PCM_DREQ 5 +#define PCM_INTEN 6 +#define PCM_INTSTC 7 +#define PCM_GRAY 8 + +#define PCM_CS_STBY (1 <<25) +#define PCM_CS_SYNC (1 <<24) +#define PCM_CS_RXSEX (1 <<23) +#define PCM_CS_RXERR (1 <<16) +#define PCM_CS_TXERR (1 <<15) +#define PCM_CS_DMAEN (1 <<9) +#define PCM_CS_RXTHR(x) ((x)<<7) +#define PCM_CS_TXTHR(x) ((x)<<5) +#define PCM_CS_RXCLR (1 <<4) +#define PCM_CS_TXCLR (1 <<3) +#define PCM_CS_TXON (1 <<2) +#define PCM_CS_RXON (1 <<1) +#define PCM_CS_EN (1 <<0) + +#define PCM_MODE_CLK_DIS (1 <<28) +#define PCM_MODE_PDMN (1 <<27) +#define PCM_MODE_PDME (1 <<26) +#define PCM_MODE_FRXP (1 <<25) +#define PCM_MODE_FTXP (1 <<24) +#define PCM_MODE_CLKM (1 <<23) +#define PCM_MODE_CLKI (1 <<22) +#define PCM_MODE_FSM (1 <<21) +#define PCM_MODE_FSI (1 <<20) +#define PCM_MODE_FLEN(x) ((x)<<10) +#define PCM_MODE_FSLEN(x) ((x)<< 0) + +#define PCM_RXC_CH1WEX (1 <<31) +#define PCM_RXC_CH1EN (1 <<30) +#define PCM_RXC_CH1POS(x) ((x)<<20) +#define PCM_RXC_CH1WID(x) ((x)<<16) +#define PCM_RXC_CH2WEX (1 <<15) +#define PCM_RXC_CH2EN (1 <<14) +#define PCM_RXC_CH2POS(x) ((x)<< 4) +#define PCM_RXC_CH2WID(x) ((x)<< 0) + +#define PCM_TXC_CH1WEX (1 <<31) +#define PCM_TXC_CH1EN (1 <<30) +#define PCM_TXC_CH1POS(x) ((x)<<20) +#define PCM_TXC_CH1WID(x) ((x)<<16) +#define PCM_TXC_CH2WEX (1 <<15) +#define PCM_TXC_CH2EN (1 <<14) +#define PCM_TXC_CH2POS(x) ((x)<< 4) +#define PCM_TXC_CH2WID(x) ((x)<< 0) + +#define PCM_DREQ_TX_PANIC(x) ((x)<<24) +#define PCM_DREQ_RX_PANIC(x) ((x)<<16) +#define PCM_DREQ_TX_REQ_L(x) ((x)<< 8) +#define PCM_DREQ_RX_REQ_L(x) ((x)<< 0) + +#define PCM_INTEN_RXERR (1<<3) +#define PCM_INTEN_TXERR (1<<2) +#define PCM_INTEN_RXR (1<<1) +#define PCM_INTEN_TXW (1<<0) + +#define PCM_INTSTC_RXERR (1<<3) +#define PCM_INTSTC_TXERR (1<<2) +#define PCM_INTSTC_RXR (1<<1) +#define PCM_INTSTC_TXW (1<<0) + +#define PCM_GRAY_FLUSH (1<<2) +#define PCM_GRAY_CLR (1<<1) +#define PCM_GRAY_EN (1<<0) + +#define BCM_PASSWD (0x5A<<24) + +#define CLK_CTL_MASH(x)((x)<<9) +#define CLK_CTL_BUSY (1 <<7) +#define CLK_CTL_KILL (1 <<5) +#define CLK_CTL_ENAB (1 <<4) +#define CLK_CTL_SRC(x) ((x)<<0) + +#define CLK_SRCS 2 + +#define CLK_CTL_SRC_OSC 1 +#define CLK_CTL_SRC_PLLD 6 + +#define CLK_OSC_FREQ 19200000 +#define CLK_OSC_FREQ_2711 54000000 +#define CLK_PLLD_FREQ 500000000 +#define CLK_PLLD_FREQ_2711 750000000 + +#define CLK_DIV_DIVI(x) ((x)<<12) +#define CLK_DIV_DIVF(x) ((x)<< 0) + +#define CLK_GP0_CTL 28 +#define CLK_GP0_DIV 29 +#define CLK_GP1_CTL 30 +#define CLK_GP1_DIV 31 +#define CLK_GP2_CTL 32 +#define CLK_GP2_DIV 33 + +#define CLK_PCMCTL 38 +#define CLK_PCMDIV 39 + +#define CLK_PWMCTL 40 +#define CLK_PWMDIV 41 + +#define SYST_CS 0 +#define SYST_CLO 1 +#define SYST_CHI 2 + +/* SPI */ + +#define SPI_CS 0 +#define SPI_FIFO 1 +#define SPI_CLK 2 +#define SPI_DLEN 3 +#define SPI_LTOH 4 +#define SPI_DC 5 + +#define SPI_CS_LEN_LONG (1<<25) +#define SPI_CS_DMA_LEN (1<<24) +#define SPI_CS_CSPOLS(x) ((x)<<21) +#define SPI_CS_RXF (1<<20) +#define SPI_CS_RXR (1<<19) +#define SPI_CS_TXD (1<<18) +#define SPI_CS_RXD (1<<17) +#define SPI_CS_DONE (1<<16) +#define SPI_CS_LEN (1<<13) +#define SPI_CS_REN (1<<12) +#define SPI_CS_ADCS (1<<11) +#define SPI_CS_INTR (1<<10) +#define SPI_CS_INTD (1<<9) +#define SPI_CS_DMAEN (1<<8) +#define SPI_CS_TA (1<<7) +#define SPI_CS_CSPOL(x) ((x)<<6) +#define SPI_CS_CLEAR(x) ((x)<<4) +#define SPI_CS_MODE(x) ((x)<<2) +#define SPI_CS_CS(x) ((x)<<0) + +#define SPI_DC_RPANIC(x) ((x)<<24) +#define SPI_DC_RDREQ(x) ((x)<<16) +#define SPI_DC_TPANIC(x) ((x)<<8) +#define SPI_DC_TDREQ(x) ((x)<<0) + +#define SPI_MODE0 0 +#define SPI_MODE1 1 +#define SPI_MODE2 2 +#define SPI_MODE3 3 + +#define SPI_CS0 0 +#define SPI_CS1 1 +#define SPI_CS2 2 + +/* standard SPI gpios (ALT0) */ + +#define PI_SPI_CE0 8 +#define PI_SPI_CE1 7 +#define PI_SPI_SCLK 11 +#define PI_SPI_MISO 9 +#define PI_SPI_MOSI 10 + +/* auxiliary SPI gpios (ALT4) */ + +#define PI_ASPI_CE0 18 +#define PI_ASPI_CE1 17 +#define PI_ASPI_CE2 16 +#define PI_ASPI_MISO 19 +#define PI_ASPI_MOSI 20 +#define PI_ASPI_SCLK 21 + +/* AUX */ + +#define AUX_IRQ 0 +#define AUX_ENABLES 1 + +#define AUX_MU_IO_REG 16 +#define AUX_MU_IER_REG 17 +#define AUX_MU_IIR_REG 18 +#define AUX_MU_LCR_REG 19 +#define AUX_MU_MCR_REG 20 +#define AUX_MU_LSR_REG 21 +#define AUX_MU_MSR_REG 22 +#define AUX_MU_SCRATCH 23 +#define AUX_MU_CNTL_REG 24 +#define AUX_MU_STAT_REG 25 +#define AUX_MU_BAUD_REG 26 + +#define AUX_SPI0_CNTL0_REG 32 +#define AUX_SPI0_CNTL1_REG 33 +#define AUX_SPI0_STAT_REG 34 +#define AUX_SPI0_PEEK_REG 35 + +#define AUX_SPI0_IO_REG 40 +#define AUX_SPI0_TX_HOLD 44 + +#define AUX_SPI1_CNTL0_REG 48 +#define AUX_SPI1_CNTL1_REG 49 +#define AUX_SPI1_STAT_REG 50 +#define AUX_SPI1_PEEK_REG 51 + +#define AUX_SPI1_IO_REG 56 +#define AUX_SPI1_TX_HOLD 60 + +#define AUXENB_SPI2 (1<<2) +#define AUXENB_SPI1 (1<<1) +#define AUXENB_UART (1<<0) + +#define AUXSPI_CNTL0_SPEED(x) ((x)<<20) +#define AUXSPI_CNTL0_CS(x) ((x)<<17) +#define AUXSPI_CNTL0_POSTINP (1<<16) +#define AUXSPI_CNTL0_VAR_CS (1<<15) +#define AUXSPI_CNTL0_VAR_WIDTH (1<<14) +#define AUXSPI_CNTL0_DOUT_HOLD(x) ((x)<<12) +#define AUXSPI_CNTL0_ENABLE (1<<11) +#define AUXSPI_CNTL0_IN_RISING(x) ((x)<<10) +#define AUXSPI_CNTL0_CLR_FIFOS (1<<9) +#define AUXSPI_CNTL0_OUT_RISING(x) ((x)<<8) +#define AUXSPI_CNTL0_INVERT_CLK(x) ((x)<<7) +#define AUXSPI_CNTL0_MSB_FIRST(x) ((x)<<6) +#define AUXSPI_CNTL0_SHIFT_LEN(x) ((x)<<0) + +#define AUXSPI_CNTL1_CS_HIGH(x) ((x)<<8) +#define AUXSPI_CNTL1_TX_IRQ (1<<7) +#define AUXSPI_CNTL1_DONE_IRQ (1<<6) +#define AUXSPI_CNTL1_MSB_FIRST(x)((x)<<1) +#define AUXSPI_CNTL1_KEEP_INPUT (1<<0) + +#define AUXSPI_STAT_TX_FIFO(x) ((x)<<28) +#define AUXSPI_STAT_RX_FIFO(x) ((x)<<20) +#define AUXSPI_STAT_TX_FULL (1<<10) +#define AUXSPI_STAT_TX_EMPTY (1<<9) +#define AUXSPI_STAT_RX_EMPTY (1<<7) +#define AUXSPI_STAT_BUSY (1<<6) +#define AUXSPI_STAT_BITS(x) ((x)<<0) + +/* --------------------------------------------------------------- */ + +#define NORMAL_DMA (DMA_NO_WIDE_BURSTS | DMA_WAIT_RESP) +#define TWO_BEAT_DMA (DMA_TDMODE | DMA_BURST_LENGTH(1)) + +#define TIMED_DMA(x) (DMA_DEST_DREQ | DMA_PERIPHERAL_MAPPING(x)) + +#define PCM_TIMER (((PCM_BASE + PCM_FIFO*4) & 0x00ffffff) | PI_PERI_BUS) +#define PWM_TIMER (((PWM_BASE + PWM_FIFO*4) & 0x00ffffff) | PI_PERI_BUS) + +#define DBG_MIN_LEVEL 0 +#define DBG_ALWAYS 0 +#define DBG_STARTUP 1 +#define DBG_DMACBS 2 +#define DBG_SCRIPT 3 +#define DBG_USER 4 +#define DBG_INTERNAL 5 +#define DBG_SLOW_TICK 6 +#define DBG_FAST_TICK 7 +#define DBG_MAX_LEVEL 8 + +#define GPIO_UNDEFINED 0 +#define GPIO_WRITE 1 +#define GPIO_PWM 2 +#define GPIO_SERVO 3 +#define GPIO_HW_CLK 4 +#define GPIO_HW_PWM 5 +#define GPIO_SPI 6 +#define GPIO_I2C 7 + +#define STACK_SIZE (256*1024) + +#define PAGE_SIZE 4096 + +#define PWM_FREQS 18 + +#define CYCLES_PER_BLOCK 80 +#define PULSE_PER_CYCLE 25 + +#define PAGES_PER_BLOCK 53 + +#define CBS_PER_IPAGE 117 +#define LVS_PER_IPAGE 38 +#define OFF_PER_IPAGE 38 +#define TCK_PER_IPAGE 2 +#define ON_PER_IPAGE 2 +#define PAD_PER_IPAGE 7 + +#define CBS_PER_OPAGE 118 +#define OOL_PER_OPAGE 79 + +/* +Wave Count Block + +Assumes two counters per block. Each counter 4 * 16 (16^4=65536) + 0 CB [13] 13*8 104 CBs for counter 0 + 104 CB [13] 13*8 104 CBs for counter 1 + 208 CB [60] 60*8 480 CBs reserved to construct wave + 688 OOL [60] 60*1 60 OOL reserved to construct wave + 748 OOL[136] 136*1 136 OOL for counter 0 + 884 OOL[136] 136*1 136 OOL for counter 1 +1020 pad [4] 4*1 4 spare +*/ + +#define WCB_CNT_PER_PAGE 2 +#define WCB_COUNTERS (WCB_CNT_PER_PAGE * PI_WAVE_COUNT_PAGES) +#define WCB_CNT_CBS 13 +#define WCB_CNT_OOL 68 +#define WCB_COUNTER_OOL (WCB_CNT_PER_PAGE * WCB_CNT_OOL) +#define WCB_COUNTER_CBS (WCB_CNT_PER_PAGE * WCB_CNT_CBS) +#define WCB_CHAIN_CBS 60 +#define WCB_CHAIN_OOL 60 + +#define CBS_PER_CYCLE ((PULSE_PER_CYCLE*3)+2) + +#define NUM_CBS (CBS_PER_CYCLE * bufferCycles) + +#define SUPERCYCLE 800 +#define SUPERLEVEL 20000 + +#define BLOCK_SIZE (PAGES_PER_BLOCK*PAGE_SIZE) + +#define DMAI_PAGES (PAGES_PER_BLOCK * bufferBlocks) + +#define DMAO_PAGES (PAGES_PER_BLOCK * PI_WAVE_BLOCKS) + +#define NUM_WAVE_OOL (DMAO_PAGES * OOL_PER_OPAGE) +#define NUM_WAVE_CBS (DMAO_PAGES * CBS_PER_OPAGE) + +#define TICKSLOTS 50 + +#define PI_I2C_CLOSED 0 +#define PI_I2C_RESERVED 1 +#define PI_I2C_OPENED 2 + +#define PI_SPI_CLOSED 0 +#define PI_SPI_RESERVED 1 +#define PI_SPI_OPENED 2 + +#define PI_SER_CLOSED 0 +#define PI_SER_RESERVED 1 +#define PI_SER_OPENED 2 + +#define PI_FILE_CLOSED 0 +#define PI_FILE_RESERVED 1 +#define PI_FILE_OPENED 2 + +#define PI_NOTIFY_CLOSED 0 +#define PI_NOTIFY_RESERVED 1 +#define PI_NOTIFY_CLOSING 2 +#define PI_NOTIFY_OPENED 3 +#define PI_NOTIFY_RUNNING 4 +#define PI_NOTIFY_PAUSED 5 + +#define PI_WFRX_NONE 0 +#define PI_WFRX_SERIAL 1 +#define PI_WFRX_I2C_SDA 2 +#define PI_WFRX_I2C_SCL 3 +#define PI_WFRX_SPI_SCLK 4 +#define PI_WFRX_SPI_MISO 5 +#define PI_WFRX_SPI_MOSI 6 +#define PI_WFRX_SPI_CS 7 + +#define PI_WF_MICROS 1 + +#define BPD 4 + +#define MAX_REPORT 250 +#define MAX_SAMPLE 4000 + +#define DEFAULT_PWM_IDX 5 + +#define MAX_EMITS (PIPE_BUF / sizeof(gpioReport_t)) + +#define SRX_BUF_SIZE 8192 + +#define PI_I2C_RETRIES 0x0701 +#define PI_I2C_TIMEOUT 0x0702 +#define PI_I2C_SLAVE 0x0703 +#define PI_I2C_FUNCS 0x0705 +#define PI_I2C_RDWR 0x0707 +#define PI_I2C_SMBUS 0x0720 + +#define PI_I2C_SMBUS_READ 1 +#define PI_I2C_SMBUS_WRITE 0 + +#define PI_I2C_SMBUS_QUICK 0 +#define PI_I2C_SMBUS_BYTE 1 +#define PI_I2C_SMBUS_BYTE_DATA 2 +#define PI_I2C_SMBUS_WORD_DATA 3 +#define PI_I2C_SMBUS_PROC_CALL 4 +#define PI_I2C_SMBUS_BLOCK_DATA 5 +#define PI_I2C_SMBUS_I2C_BLOCK_BROKEN 6 +#define PI_I2C_SMBUS_BLOCK_PROC_CALL 7 +#define PI_I2C_SMBUS_I2C_BLOCK_DATA 8 + +#define PI_I2C_SMBUS_BLOCK_MAX 32 +#define PI_I2C_SMBUS_I2C_BLOCK_MAX 32 + +#define PI_I2C_FUNC_SMBUS_QUICK 0x00010000 +#define PI_I2C_FUNC_SMBUS_READ_BYTE 0x00020000 +#define PI_I2C_FUNC_SMBUS_WRITE_BYTE 0x00040000 +#define PI_I2C_FUNC_SMBUS_READ_BYTE_DATA 0x00080000 +#define PI_I2C_FUNC_SMBUS_WRITE_BYTE_DATA 0x00100000 +#define PI_I2C_FUNC_SMBUS_READ_WORD_DATA 0x00200000 +#define PI_I2C_FUNC_SMBUS_WRITE_WORD_DATA 0x00400000 +#define PI_I2C_FUNC_SMBUS_PROC_CALL 0x00800000 +#define PI_I2C_FUNC_SMBUS_READ_BLOCK_DATA 0x01000000 +#define PI_I2C_FUNC_SMBUS_WRITE_BLOCK_DATA 0x02000000 +#define PI_I2C_FUNC_SMBUS_READ_I2C_BLOCK 0x04000000 +#define PI_I2C_FUNC_SMBUS_WRITE_I2C_BLOCK 0x08000000 + +#define PI_MASH_MAX_FREQ 23800000 + +#define FLUSH_PAGES 1024 + +#define MB_DEV_MAJOR 100 + +#define MB_IOCTL _IOWR(MB_DEV_MAJOR, 0, char *) + +#define MB_DEV1 "/dev/vcio" +#define MB_DEV2 "/dev/pigpio-mb" + +#define BUS_TO_PHYS(x) ((x)&~0xC0000000) + +#define MB_END_TAG 0 +#define MB_PROCESS_REQUEST 0 + +#define MB_ALLOCATE_MEMORY_TAG 0x3000C +#define MB_LOCK_MEMORY_TAG 0x3000D +#define MB_UNLOCK_MEMORY_TAG 0x3000E +#define MB_RELEASE_MEMORY_TAG 0x3000F + +#define PI_SCRIPT_FREE 0 +#define PI_SCRIPT_RESERVED 1 +#define PI_SCRIPT_IN_USE 2 +#define PI_SCRIPT_DYING 3 + +#define PI_SCRIPT_HALT 0 +#define PI_SCRIPT_RUN 1 +#define PI_SCRIPT_DELETE 2 + +#define PI_SCRIPT_STACK_SIZE 256 + +#define PI_SPI_FLAGS_CHANNEL(x) ((x&7)<<29) + +#define PI_SPI_FLAGS_GET_CHANNEL(x) (((x)>>29)&7) +#define PI_SPI_FLAGS_GET_BITLEN(x) (((x)>>16)&63) +#define PI_SPI_FLAGS_GET_RX_LSB(x) (((x)>>15)&1) +#define PI_SPI_FLAGS_GET_TX_LSB(x) (((x)>>14)&1) +#define PI_SPI_FLAGS_GET_3WREN(x) (((x)>>10)&15) +#define PI_SPI_FLAGS_GET_3WIRE(x) (((x)>>9)&1) +#define PI_SPI_FLAGS_GET_AUX_SPI(x) (((x)>>8)&1) +#define PI_SPI_FLAGS_GET_RESVD(x) (((x)>>5)&7) +#define PI_SPI_FLAGS_GET_CSPOLS(x) (((x)>>2)&7) +#define PI_SPI_FLAGS_GET_MODE(x) ((x)&3) + +#define PI_SPI_FLAGS_GET_CPHA(x) ((x)&1) +#define PI_SPI_FLAGS_GET_CPOL(x) ((x)&2) +#define PI_SPI_FLAGS_GET_CSPOL(x) ((x)&4) + +#define PI_STARTING 0 +#define PI_RUNNING 1 +#define PI_ENDING 2 + +#define PI_THREAD_NONE 0 +#define PI_THREAD_STARTED 1 +#define PI_THREAD_RUNNING 2 + +#define PI_MAX_PATH 512 + +/* typedef ------------------------------------------------------- */ + +typedef void (*callbk_t) (); + +typedef struct +{ + rawCbs_t cb [128]; +} dmaPage_t; + +typedef struct +{ + rawCbs_t cb [CBS_PER_IPAGE]; + uint32_t level [LVS_PER_IPAGE]; + uint32_t gpioOff [OFF_PER_IPAGE]; + uint32_t tick [TCK_PER_IPAGE]; + uint32_t gpioOn [ON_PER_IPAGE]; + uint32_t periphData; + uint32_t pad [PAD_PER_IPAGE]; +} dmaIPage_t; + +typedef struct +{ + rawCbs_t cb [CBS_PER_OPAGE]; + uint32_t OOL [OOL_PER_OPAGE]; + uint32_t periphData; +} dmaOPage_t; + +typedef struct +{ + uint8_t is; + uint8_t pad; + uint16_t width; + uint16_t range; /* dutycycles specified by 0 .. range */ + uint16_t freqIdx; + uint16_t deferOff; + uint16_t deferRng; +} gpioInfo_t; + +typedef struct +{ + callbk_t func; + unsigned ex; + void *userdata; + + int wdSteadyUs; + uint32_t wdTick; + uint32_t wdLBitV; + + int nfSteadyUs; + int nfActiveUs; + int nfActive; + uint32_t nfTick1; + uint32_t nfTick2; + uint32_t nfLBitV; + uint32_t nfRBitV; + + uint32_t gfSteadyUs; + uint8_t gfInitialised; + uint32_t gfTick; + uint32_t gfLBitV; + uint32_t gfRBitV; + +} gpioAlert_t; + +typedef struct +{ + callbk_t func; + unsigned ex; + void *userdata; + int ignore; + int fired; +} eventAlert_t; + +typedef struct +{ + unsigned gpio; + pthread_t *pth; + callbk_t func; + unsigned edge; + int timeout; + unsigned ex; + void *userdata; + int fd; + int inited; +} gpioISR_t; + +typedef struct +{ + callbk_t func; + unsigned ex; + void *userdata; +} gpioSignal_t; + +typedef struct +{ + callbk_t func; + unsigned ex; + void *userdata; + uint32_t bits; +} gpioGetSamples_t; + +typedef struct +{ + callbk_t func; + unsigned ex; + void *userdata; + unsigned id; + unsigned running; + unsigned millis; + pthread_t pthId; +} gpioTimer_t; + +typedef struct +{ + unsigned id; + unsigned state; + unsigned request; + unsigned run_state; + uint32_t waitBits; + uint32_t eventBits; + uint32_t changedBits; + pthread_t *pthIdp; + pthread_mutex_t pthMutex; + pthread_cond_t pthCond; + cmdScript_t script; +} gpioScript_t; + + +typedef struct +{ + uint16_t valid; + uint16_t servoIdx; +} clkCfg_t; + +typedef struct +{ + uint16_t seqno; + uint16_t state; + uint32_t bits; + uint32_t eventBits; + uint32_t lastReportTick; + int fd; + int pipe; + int max_emits; +} gpioNotify_t; + +typedef struct +{ + uint16_t state; + int16_t fd; + uint32_t mode; +} fileInfo_t; + +typedef struct +{ + uint16_t state; + int16_t fd; + uint32_t addr; + uint32_t flags; + uint32_t funcs; +} i2cInfo_t; + +typedef struct +{ + uint16_t state; + int16_t fd; + uint32_t flags; +} serInfo_t; + +typedef struct +{ + uint16_t state; + unsigned speed; + uint32_t flags; +} spiInfo_t; + +typedef struct +{ + uint32_t alertTicks; + uint32_t lateTicks; + uint32_t moreToDo; + uint32_t diffTick[TICKSLOTS]; + uint32_t cbTicks; + uint32_t cbCalls; + uint32_t maxEmit; + uint32_t emitFrags; + uint32_t maxSamples; + uint32_t numSamples; + uint32_t DMARestarts; + uint32_t dmaInitCbsCount; + uint32_t goodPipeWrite; + uint32_t shortPipeWrite; + uint32_t wouldBlockPipeWrite; +} gpioStats_t; + +typedef struct +{ + unsigned bufferMilliseconds; + unsigned clockMicros; + unsigned clockPeriph; + unsigned DMAprimaryChannel; + unsigned DMAsecondaryChannel; + unsigned socketPort; + unsigned ifFlags; + unsigned memAllocMode; + unsigned dbgLevel; + unsigned alertFreq; + uint32_t internals; + /* + 0-3: dbgLevel + 4-7: alertFreq + */ +} gpioCfg_t; + +typedef struct +{ + uint32_t micros; + uint32_t highMicros; + uint32_t maxMicros; + uint32_t pulses; + uint32_t highPulses; + uint32_t maxPulses; + uint32_t cbs; + uint32_t highCbs; + uint32_t maxCbs; +} wfStats_t; + +typedef struct +{ + char *buf; + uint32_t bufSize; + int readPos; + int writePos; + uint32_t fullBit; /* nanoseconds */ + uint32_t halfBit; /* nanoseconds */ + int timeout; /* millisconds */ + uint32_t startBitTick; /* microseconds */ + uint32_t nextBitDiff; /* nanoseconds */ + int bit; + uint32_t data; + int bytes; /* 1, 2, 4 */ + int level; + int dataBits; /* 1-32 */ + int invert; /* 0, 1 */ +} wfRxSerial_t; + +typedef struct +{ + int SDA; + int SCL; + int delay; + int SDAMode; + int SCLMode; + int started; +} wfRxI2C_t; + +typedef struct +{ + int CS; + int MISO; + int MOSI; + int SCLK; + int usage; + int delay; + int spiFlags; + int MISOMode; + int MOSIMode; + int CSMode; + int SCLKMode; +} wfRxSPI_t; + +typedef struct +{ + int mode; + int gpio; + uint32_t baud; + pthread_mutex_t mutex; + union + { + wfRxSerial_t s; + wfRxI2C_t I; + wfRxSPI_t S; + }; +} wfRx_t; + +union my_smbus_data +{ + uint8_t byte; + uint16_t word; + uint8_t block[PI_I2C_SMBUS_BLOCK_MAX + 2]; +}; + +struct my_smbus_ioctl_data +{ + uint8_t read_write; + uint8_t command; + uint32_t size; + union my_smbus_data *data; +}; + +typedef struct +{ + pi_i2c_msg_t *msgs; /* pointers to pi_i2c_msgs */ + uint32_t nmsgs; /* number of pi_i2c_msgs */ +} my_i2c_rdwr_ioctl_data_t; + +typedef struct +{ + unsigned div; + unsigned frac; + unsigned clock; +} clkInf_t; + +typedef struct +{ + unsigned handle; /* mbAllocateMemory() */ + uintptr_t bus_addr; /* mbLockMemory() */ + uintptr_t *virtual_addr; /* mbMapMem() */ + unsigned size; /* in bytes */ +} DMAMem_t; + +/* global -------------------------------------------------------- */ + +/* initialise once then preserve */ + +static volatile uint32_t piCores = 0; +static volatile uint32_t pi_peri_phys = 0x20000000; +static volatile uint32_t pi_dram_bus = 0x40000000; +static volatile uint32_t pi_mem_flag = 0x0C; +static volatile uint32_t pi_ispi = 0; +static volatile uint32_t pi_is_2711 = 0; +static volatile uint32_t clk_osc_freq = CLK_OSC_FREQ; +static volatile uint32_t clk_plld_freq = CLK_PLLD_FREQ; +static volatile uint32_t hw_pwm_max_freq = PI_HW_PWM_MAX_FREQ; +static volatile uint32_t hw_clk_min_freq = PI_HW_CLK_MIN_FREQ; +static volatile uint32_t hw_clk_max_freq = PI_HW_CLK_MAX_FREQ; + +static int libInitialised = 0; + +/* initialise every gpioInitialise */ + +static struct timespec libStarted; + +static uint32_t sockNetAddr[MAX_CONNECT_ADDRESSES]; + +static int numSockNetAddr = 0; + +static uint32_t reportedLevel = 0; + +static int waveClockInited = 0; +static int PWMClockInited = 0; + +static volatile gpioStats_t gpioStats; + +static int gpioMaskSet = 0; + +/* initialise if not libInitialised */ + +static uint64_t gpioMask; + +static rawWave_t wf[3][PI_WAVE_MAX_PULSES]; + +static int wfc[3]={0, 0, 0}; + +static int wfcur=0; + +static wfStats_t wfStats= +{ + 0, 0, PI_WAVE_MAX_MICROS, + 0, 0, PI_WAVE_MAX_PULSES, + 0, 0, (DMAO_PAGES * CBS_PER_OPAGE) +}; + +static rawWaveInfo_t waveInfo[PI_MAX_WAVES]; + +static wfRx_t wfRx[PI_MAX_USER_GPIO+1]; + +static int waveOutBotCB = PI_WAVE_COUNT_PAGES*CBS_PER_OPAGE; +static int waveOutBotOOL = PI_WAVE_COUNT_PAGES*OOL_PER_OPAGE; +static int waveOutTopOOL = NUM_WAVE_OOL; +static int waveOutCount = 0; + +static uint32_t *waveEndPtr = NULL; + +static volatile uint32_t alertBits = 0; +static volatile uint32_t monitorBits = 0; +static volatile uint32_t notifyBits = 0; +static volatile uint32_t scriptBits = 0; +static volatile uint32_t gFilterBits = 0; +static volatile uint32_t nFilterBits = 0; +static volatile uint32_t wdogBits = 0; + +static volatile uint32_t scriptEventBits = 0; + +static volatile int runState = PI_STARTING; + +static int pthAlertRunning = PI_THREAD_NONE; +static int pthFifoRunning = PI_THREAD_NONE; +static int pthSocketRunning = PI_THREAD_NONE; + +static gpioAlert_t gpioAlert [PI_MAX_USER_GPIO+1]; + +static eventAlert_t eventAlert [PI_MAX_EVENT+1]; + +static gpioISR_t gpioISR [PI_MAX_GPIO+1]; + +static gpioGetSamples_t gpioGetSamples; + +static gpioInfo_t gpioInfo [PI_MAX_GPIO+1]; + +static gpioNotify_t gpioNotify [PI_NOTIFY_SLOTS]; + +static fileInfo_t fileInfo [PI_FILE_SLOTS]; +static i2cInfo_t i2cInfo [PI_I2C_SLOTS]; +static serInfo_t serInfo [PI_SER_SLOTS]; +static spiInfo_t spiInfo [PI_SPI_SLOTS]; + +static gpioScript_t gpioScript [PI_MAX_SCRIPTS]; + +static gpioSignal_t gpioSignal [PI_MAX_SIGNUM+1]; + +static gpioTimer_t gpioTimer [PI_MAX_TIMER+1]; + +static int pwmFreq[PWM_FREQS]; + +/* reset after gpioTerminated */ + +/* resources which must be released on gpioTerminate */ + +static FILE * inpFifo = NULL; +static FILE * outFifo = NULL; + +static int fdLock = -1; +static int fdMem = -1; +static int fdSock = -1; +static int fdPmap = -1; +static int fdMbox = -1; + +static DMAMem_t *dmaMboxBlk = MAP_FAILED; +static uintptr_t * * dmaPMapBlk = MAP_FAILED; +static dmaPage_t * * dmaVirt = MAP_FAILED; +static dmaPage_t * * dmaBus = MAP_FAILED; + +static dmaIPage_t * * dmaIVirt = MAP_FAILED; +static dmaIPage_t * * dmaIBus = MAP_FAILED; + +static dmaOPage_t * * dmaOVirt = MAP_FAILED; +static dmaOPage_t * * dmaOBus = MAP_FAILED; + +static volatile uint32_t * auxReg = MAP_FAILED; +static volatile uint32_t * bscsReg = MAP_FAILED; +static volatile uint32_t * clkReg = MAP_FAILED; +static volatile uint32_t * dmaReg = MAP_FAILED; +static volatile uint32_t * gpioReg = MAP_FAILED; +static volatile uint32_t * padsReg = MAP_FAILED; +static volatile uint32_t * pcmReg = MAP_FAILED; +static volatile uint32_t * pwmReg = MAP_FAILED; +static volatile uint32_t * spiReg = MAP_FAILED; +static volatile uint32_t * systReg = MAP_FAILED; + +static volatile uint32_t * dmaIn = MAP_FAILED; +static volatile uint32_t * dmaOut = MAP_FAILED; + +static uint32_t hw_clk_freq[3]; +static uint32_t hw_pwm_freq[2]; +static uint32_t hw_pwm_duty[2]; +static uint32_t hw_pwm_real_range[2]; + +static volatile gpioCfg_t gpioCfg = +{ + PI_DEFAULT_BUFFER_MILLIS, + PI_DEFAULT_CLK_MICROS, + PI_DEFAULT_CLK_PERIPHERAL, + PI_DEFAULT_DMA_NOT_SET, /* primary DMA */ + PI_DEFAULT_DMA_NOT_SET, /* secondary DMA */ + PI_DEFAULT_SOCKET_PORT, + PI_DEFAULT_IF_FLAGS, + PI_DEFAULT_MEM_ALLOC_MODE, + 0, /* dbgLevel */ + 0, /* alertFreq */ + 0, /* internals */ +}; + +/* no initialisation required */ + +static unsigned bufferBlocks; /* number of blocks in buffer */ +static unsigned bufferCycles; /* number of cycles */ + +static pthread_t pthAlert; +static pthread_t pthFifo; +static pthread_t pthSocket; + +static uint32_t spi_dummy; + +static unsigned old_mode_ce0; +static unsigned old_mode_ce1; +static unsigned old_mode_sclk; +static unsigned old_mode_miso; +static unsigned old_mode_mosi; + +static uint32_t old_spi_cs; +static uint32_t old_spi_clk; + +static unsigned old_mode_ace0; +static unsigned old_mode_ace1; +static unsigned old_mode_ace2; +static unsigned old_mode_asclk; +static unsigned old_mode_amiso; +static unsigned old_mode_amosi; + +static uint32_t old_spi_cntl0; +static uint32_t old_spi_cntl1; + +static uint32_t bscFR; + +/* const --------------------------------------------------------- */ + +static const uint8_t clkDef[PI_MAX_GPIO + 1] = +{ + /* 0 1 2 3 4 5 6 7 8 9 */ + /* 0 */ 0x00, 0x00, 0x00, 0x00, 0x84, 0x94, 0xA4, 0x00, 0x00, 0x00, + /* 1 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 2 */ 0x82, 0x92, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 3 */ 0x00, 0x00, 0x84, 0x00, 0x84, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 4 */ 0x00, 0x00, 0x94, 0xA4, 0x94, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 5 */ 0x00, 0x00, 0x00, 0x00, +}; + +/* + 7 6 5 4 3 2 1 0 + V . C C . M M M + + V: 0 no clock, 1 has a clock +CC: 00 CLK0, 01 CLK1, 10 CLK2 + M: 100 ALT0, 010 ALT5 + + gpio4 GPCLK0 ALT0 + gpio5 GPCLK1 ALT0 B+ and compute module only (reserved for system use) + gpio6 GPCLK2 ALT0 B+ and compute module only + gpio20 GPCLK0 ALT5 B+ and compute module only + gpio21 GPCLK1 ALT5 Not available on Rev.2 B (reserved for system use) + + gpio32 GPCLK0 ALT0 Compute module only + gpio34 GPCLK0 ALT0 Compute module only + gpio42 GPCLK1 ALT0 Compute module only (reserved for system use) + gpio43 GPCLK2 ALT0 Compute module only + gpio44 GPCLK1 ALT0 Compute module only (reserved for system use) +*/ + +static const uint8_t PWMDef[PI_MAX_GPIO + 1] = +{ + /* 0 1 2 3 4 5 6 7 8 9 */ + /* 0 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 1 */ 0x00, 0x00, 0x84, 0x94, 0x00, 0x00, 0x00, 0x00, 0x82, 0x92, + /* 2 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 3 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + /* 4 */ 0x84, 0x94, 0x00, 0x00, 0x00, 0x94, 0x00, 0x00, 0x00, 0x00, + /* 5 */ 0x00, 0x00, 0x85, 0x95, +}; + +/* + 7 6 5 4 3 2 1 0 + V . . P . M M M + + V: 0 no PWM, 1 has a PWM + P: 0 PWM0, 1 PWM1 + M: 010 ALT5, 100 ALT0, 101 ALT1 + + gpio12 pwm0 ALT0 + gpio13 pwm1 ALT0 + gpio18 pwm0 ALT5 + gpio19 pwm1 ALT5 + gpio40 pwm0 ALT0 + gpio41 pwm1 ALT0 + gpio45 pwm1 ALT0 + gpio52 pwm0 ALT1 + gpio53 pwm1 ALT1 +*/ + +static const clkCfg_t clkCfg[]= +{ + /* valid servo */ + { 0, 0}, /* 0 */ + { 1, 17}, /* 1 */ + { 1, 16}, /* 2 */ + { 0, 0}, /* 3 */ + { 1, 15}, /* 4 */ + { 1, 14}, /* 5 */ + { 0, 0}, /* 6 */ + { 0, 0}, /* 7 */ + { 1, 13}, /* 8 */ + { 0, 0}, /* 9 */ + { 1, 12}, /* 10 */ +}; + +static const uint16_t pwmCycles[PWM_FREQS]= + { 1, 2, 4, 5, 8, 10, 16, 20, 25, + 32, 40, 50, 80, 100, 160, 200, 400, 800}; + +static const uint16_t pwmRealRange[PWM_FREQS]= + { 25, 50, 100, 125, 200, 250, 400, 500, 625, + 800, 1000, 1250, 2000, 2500, 4000, 5000, 10000, 20000}; + +/* prototype ----------------------------------------------------- */ + +static void intNotifyBits(void); + +static void intScriptBits(void); + +static void intScriptEventBits(void); + +static int gpioNotifyOpenInBand(int fd); + +static void initHWClk + (int clkCtl, int clkDiv, int clkSrc, int divI, int divF, int MASH); + +static void initDMAgo(volatile uint32_t *dmaAddr, uint32_t cbAddr); + +int gpioWaveTxStart(unsigned wave_mode); /* deprecated */ + +static void closeOrphanedNotifications(int slot, int fd); + + +/* ======================================================================= */ + +int myScriptNameValid(char *name) +{ + int i, c, len, valid; + + len = strlen(name); + + valid = 1; + + for (i=0; i 40) c = 40; else c = count; + + for (i=0; ibyte+1, (char*)data)); + + args.read_write = rw; + args.command = cmd; + args.size = size; + args.data = data; + + return ioctl(fd, PI_I2C_SMBUS, &args); +} + +/* ----------------------------------------------------------------------- */ + +static void myGpioSetMode(unsigned gpio, unsigned mode) +{ + int reg, shift; + + reg = gpio/10; + shift = (gpio%10) * 3; + + gpioReg[reg] = (gpioReg[reg] & ~(7<level[slot]; + + return level; +} + +/* ----------------------------------------------------------------------- */ + +static int myI2CGetPar(char *inBuf, int *inPos, int inLen, int *esc) +{ + int bytes; + + if (*esc) bytes = 2; else bytes = 1; + + *esc = 0; + + if (*inPos <= (inLen - bytes)) + { + if (bytes == 1) + { + return inBuf[(*inPos)++]; + } + else + { + (*inPos) += 2; + return inBuf[*inPos-2] + (inBuf[*inPos-1]<<8); + } + } + return -1; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t myGetTick(int pos) +{ + uint32_t tick; + int page, slot; + + myTckPageSlot(pos, &page, &slot); + + tick = dmaIVirt[page]->tick[slot]; + + return tick; +} + +static int myPermit(unsigned gpio) +{ + if (gpio <= PI_MAX_GPIO) + { + if (gpioMask & ((uint64_t)(1)<>32; + + res = gpioWrite_Bits_32_53_Clear(p[1]&mask); + + if ((mask | p[1]) != mask) + { + DBG(DBG_USER, + "gpioWrite_Bits_32_53_Clear: bad bits %08"PRIXPTR" (permissions %08X)", + p[1], mask); + res = PI_SOME_PERMITTED; + } + break; + + case PI_CMD_BI2CC: + res = bbI2CClose(p[1]); + break; + + case PI_CMD_BI2CO: + memcpy(&p[4], buf, 4); + res = bbI2COpen(p[1], p[2], p[4]); + break; + + case PI_CMD_BI2CZ: + /* use half buffer for write, half buffer for read */ + if (p[3] > (bufSize/2)) p[3] = bufSize/2; + res = bbI2CZip(p[1], buf, p[3], buf+(bufSize/2), bufSize/2); + if (res > 0) + { + memcpy(buf, buf+(bufSize/2), res); + } + break; + + case PI_CMD_BSCX: + xfer.control = p[1]; + if (p[3] > BSC_FIFO_SIZE) p[3] = BSC_FIFO_SIZE; + xfer.txCnt = p[3]; + if (p[3]) memcpy(&xfer.txBuf, buf, p[3]); + res = bscXfer(&xfer); + if (res >= 0) + { + memcpy(buf, &res, 4); + res = 4 + xfer.rxCnt; + if (res > 4) memcpy(buf+4, &xfer.rxBuf, res-4); + } + break; + + case PI_CMD_BSPIO: + + memcpy(&tmp1, buf+ 0, 4); // MISO + memcpy(&tmp2, buf+ 4, 4); // MOSI + memcpy(&tmp3, buf+ 8, 4); // SCLK + memcpy(&tmp4, buf+12, 4); // baud + memcpy(&tmp5, buf+16, 4); // flags + + if (!myPermit(p[1])) + { + DBG(DBG_USER, + "bbSPIOpen: gpio %"PRIdPTR", no permission to update CS", p[1]); + res = PI_NOT_PERMITTED; + } + + if (!myPermit(tmp1)) + { + DBG(DBG_USER, + "bbSPIOpen: gpio %d, no permission to update MISO", tmp1); + res = PI_NOT_PERMITTED; + } + + if (!myPermit(tmp2)) + { + DBG(DBG_USER, + "bbSPIOpen: gpio %d, no permission to update MOSI", tmp2); + res = PI_NOT_PERMITTED; + } + + if (!myPermit(tmp3)) + { + DBG(DBG_USER, + "bbSPIOpen: gpio %d, no permission to update SCLK", tmp3); + res = PI_NOT_PERMITTED; + } + + if (!res) res = bbSPIOpen(p[1], tmp1, tmp2, tmp3, tmp4, tmp5); + break; + + case PI_CMD_BSPIC: + res = bbSPIClose(p[1]); + break; + + case PI_CMD_BSPIX: + if (p[3] > bufSize) p[3] = bufSize; + res = bbSPIXfer(p[1], buf, buf, p[3]); + break; + + case PI_CMD_BR1: res = gpioRead_Bits_0_31(); break; + + case PI_CMD_BR2: res = gpioRead_Bits_32_53(); break; + + case PI_CMD_BS1: + mask = gpioMask; + + res = gpioWrite_Bits_0_31_Set(p[1]&mask); + + if ((mask | p[1]) != mask) + { + DBG(DBG_USER, + "gpioWrite_Bits_0_31_Set: bad bits %08"PRIXPTR" (permissions %08X)", + p[1], mask); + res = PI_SOME_PERMITTED; + } + break; + + case PI_CMD_BS2: + mask = gpioMask>>32; + + res = gpioWrite_Bits_32_53_Set(p[1]&mask); + + if ((mask | p[1]) != mask) + { + DBG(DBG_USER, + "gpioWrite_Bits_32_53_Set: bad bits %08"PRIXPTR" (permissions %08X)", + p[1], mask); + res = PI_SOME_PERMITTED; + } + break; + + case PI_CMD_CF1: + res = gpioCustom1(p[1], p[2], buf, p[3]); + break; + + case PI_CMD_CF2: + /* a couple of extra precautions for untrusted code */ + if (p[2] > bufSize) p[2] = bufSize; + res = gpioCustom2(p[1], buf, p[3], buf, p[2]); + if (res > p[2]) res = p[2]; + break; + + case PI_CMD_CGI: res = gpioCfgGetInternals(); break; + + case PI_CMD_CSI: res = gpioCfgSetInternals(p[1]); break; + + case PI_CMD_EVM: res = eventMonitor(p[1], p[2]); break; + + case PI_CMD_EVT: res = eventTrigger(p[1]); break; + + case PI_CMD_FC: res = fileClose(p[1]); break; + + case PI_CMD_FG: + res = gpioGlitchFilter(p[1], p[2]); + break; + + case PI_CMD_FL: + if (p[1] > bufSize) p[1] = bufSize; + res = fileList(buf, buf, p[1]); + break; + + case PI_CMD_FN: + memcpy(&p[4], buf, 4); + res = gpioNoiseFilter(p[1], p[2], p[4]); + break; + + case PI_CMD_FO: res = fileOpen(buf, p[1]); break; + + case PI_CMD_FR: + if (p[2] > bufSize) p[2] = bufSize; + res = fileRead(p[1], buf, p[2]); + break; + + case PI_CMD_FS: + memcpy(&p[4], buf, 4); + res = fileSeek(p[1], p[2], p[4]); + break; + + case PI_CMD_FW: res = fileWrite(p[1], buf, p[3]); break; + + case PI_CMD_GDC: res = gpioGetPWMdutycycle(p[1]); break; + + case PI_CMD_GPW: res = gpioGetServoPulsewidth(p[1]); break; + + case PI_CMD_HC: + /* special case to allow password in upper byte */ + if (myPermit(p[1]&0xFFFFFF)) res = gpioHardwareClock(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioHardwareClock: gpio %"PRIdPTR", no permission to update", + p[1] & 0xFFFFFF); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_HELP: break; + + case PI_CMD_HP: + if (myPermit(p[1])) + { + memcpy(&p[4], buf, 4); + res = gpioHardwarePWM(p[1], p[2], p[4]); + } + else + { + DBG(DBG_USER, + "gpioHardwarePWM: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_HWVER: res = gpioHardwareRevision(); break; + + + + case PI_CMD_I2CC: res = i2cClose(p[1]); break; + + case PI_CMD_I2CO: + memcpy(&p[4], buf, 4); + res = i2cOpen(p[1], p[2], p[4]); + break; + + case PI_CMD_I2CPC: + memcpy(&p[4], buf, 4); + res = i2cProcessCall(p[1], p[2], p[4]); + break; + + case PI_CMD_I2CPK: + res = i2cBlockProcessCall(p[1], p[2], buf, p[3]); + break; + + case PI_CMD_I2CRB: res = i2cReadByteData(p[1], p[2]); break; + + case PI_CMD_I2CRD: + if (p[2] > bufSize) p[2] = bufSize; + res = i2cReadDevice(p[1], buf, p[2]); + break; + + case PI_CMD_I2CRI: + memcpy(&p[4], buf, 4); + res = i2cReadI2CBlockData(p[1], p[2], buf, p[4]); + break; + + case PI_CMD_I2CRK: + res = i2cReadBlockData(p[1], p[2], buf); + break; + + case PI_CMD_I2CRS: res = i2cReadByte(p[1]); break; + + case PI_CMD_I2CRW: res = i2cReadWordData(p[1], p[2]); break; + + case PI_CMD_I2CWB: + memcpy(&p[4], buf, 4); + res = i2cWriteByteData(p[1], p[2], p[4]); + break; + + case PI_CMD_I2CWD: + res = i2cWriteDevice(p[1], buf, p[3]); + break; + + case PI_CMD_I2CWI: + res = i2cWriteI2CBlockData(p[1], p[2], buf, p[3]); + break; + + case PI_CMD_I2CWK: + res = i2cWriteBlockData(p[1], p[2], buf, p[3]); + break; + + case PI_CMD_I2CWQ: res = i2cWriteQuick(p[1], p[2]); break; + + case PI_CMD_I2CWS: res = i2cWriteByte(p[1], p[2]); break; + + case PI_CMD_I2CWW: + memcpy(&p[4], buf, 4); + res = i2cWriteWordData(p[1], p[2], p[4]); + break; + + case PI_CMD_I2CZ: + /* use half buffer for write, half buffer for read */ + if (p[3] > (bufSize/2)) p[3] = bufSize/2; + res = i2cZip(p[1], buf, p[3], buf+(bufSize/2), bufSize/2); + if (res > 0) + { + memcpy(buf, buf+(bufSize/2), res); + } + break; + + case PI_CMD_MICS: + if (p[1] <= PI_MAX_MICS_DELAY) myGpioDelay(p[1]); + else res = PI_BAD_MICS_DELAY; + break; + + case PI_CMD_MILS: + if (p[1] <= PI_MAX_MILS_DELAY) myGpioDelay(p[1] * 1000); + else res = PI_BAD_MILS_DELAY; + break; + + case PI_CMD_MODEG: res = gpioGetMode(p[1]); break; + + case PI_CMD_MODES: + if (myPermit(p[1])) res = gpioSetMode(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioSetMode: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_NB: res = gpioNotifyBegin(p[1], p[2]); break; + + case PI_CMD_NC: res = gpioNotifyClose(p[1]); break; + + case PI_CMD_NO: res = gpioNotifyOpen(); break; + + case PI_CMD_NP: res = gpioNotifyPause(p[1]); break; + + case PI_CMD_PADG: res = gpioGetPad(p[1]); break; + + case PI_CMD_PADS: res = gpioSetPad(p[1], p[2]); break; + + case PI_CMD_PFG: res = gpioGetPWMfrequency(p[1]); break; + + case PI_CMD_PFS: + if (myPermit(p[1])) res = gpioSetPWMfrequency(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioSetPWMfrequency: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_PIGPV: res = gpioVersion(); break; + + case PI_CMD_PRG: res = gpioGetPWMrange(p[1]); break; + + case PI_CMD_PROC: + res = gpioStoreScript(buf); + break; + + case PI_CMD_PROCD: res = gpioDeleteScript(p[1]); break; + + case PI_CMD_PROCP: + res = gpioScriptStatus(p[1], (uint32_t *)buf); + break; + + case PI_CMD_PROCR: + res = gpioRunScript(p[1], p[3]/4, (uint32_t *)buf); + break; + + case PI_CMD_PROCS: res = gpioStopScript(p[1]); break; + + case PI_CMD_PROCU: + res = gpioUpdateScript(p[1], p[3]/4, (uint32_t *)buf); + break; + + case PI_CMD_PRRG: res = gpioGetPWMrealRange(p[1]); break; + + case PI_CMD_PRS: + if (myPermit(p[1])) res = gpioSetPWMrange(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioSetPWMrange: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_PUD: + if (myPermit(p[1])) res = gpioSetPullUpDown(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioSetPullUpDown: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_PWM: + if (myPermit(p[1])) res = gpioPWM(p[1], p[2]); + else + { + DBG(DBG_USER, "gpioPWM: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_READ: res = gpioRead(p[1]); break; + + case PI_CMD_SERVO: + if (myPermit(p[1])) res = gpioServo(p[1], p[2]); + else + { + DBG(DBG_USER, + "gpioServo: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + + + case PI_CMD_SERRB: res = serReadByte(p[1]); break; + + case PI_CMD_SERWB: res = serWriteByte(p[1], p[2]); break; + + case PI_CMD_SERC: res = serClose(p[1]); break; + + case PI_CMD_SERDA: res = serDataAvailable(p[1]); break; + + case PI_CMD_SERO: res = serOpen(buf, p[1], p[2]); break; + + case PI_CMD_SERR: + if (p[2] > bufSize) p[2] = bufSize; + res = serRead(p[1], buf, p[2]); + break; + + case PI_CMD_SERW: res = serWrite(p[1], buf, p[3]); break; + + + case PI_CMD_SHELL: + res = shell(buf, buf+p[1]+1); + break; + + + case PI_CMD_SLR: + if (p[2] > bufSize) p[2] = bufSize; + res = gpioSerialRead(p[1], buf, p[2]); + break; + + case PI_CMD_SLRC: res = gpioSerialReadClose(p[1]); break; + + case PI_CMD_SLRO: + memcpy(&p[4], buf, 4); + res = gpioSerialReadOpen(p[1], p[2], p[4]); break; + + case PI_CMD_SLRI: res = gpioSerialReadInvert(p[1], p[2]); break; + + case PI_CMD_SPIC: + res = spiClose(p[1]); + break; + + case PI_CMD_SPIO: + memcpy(&p[4], buf, 4); + res = spiOpen(p[1], p[2], p[4]); + break; + + case PI_CMD_SPIR: + if (p[2] > bufSize) p[2] = bufSize; + res = spiRead(p[1], buf, p[2]); + break; + + case PI_CMD_SPIW: + if (p[3] > bufSize) p[3] = bufSize; + res = spiWrite(p[1], buf, p[3]); + break; + + case PI_CMD_SPIX: + if (p[3] > bufSize) p[3] = bufSize; + res = spiXfer(p[1], buf, buf, p[3]); + break; + + case PI_CMD_TICK: res = gpioTick(); break; + + case PI_CMD_TRIG: + if (myPermit(p[1])) + { + memcpy(&p[4], buf, 4); + res = gpioTrigger(p[1], p[2], p[4]); + } + else + { + DBG(DBG_USER, + "gpioTrigger: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_WDOG: res = gpioSetWatchdog(p[1], p[2]); break; + + case PI_CMD_WRITE: + if (myPermit(p[1])) res = gpioWrite(p[1], p[2]); + else + { + DBG(DBG_USER, "gpioWrite: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + + + case PI_CMD_WVAG: + + /* need to mask off any non permitted gpios */ + + mask = gpioMask; + pulse = (gpioPulse_t *)buf; + j = p[3]/sizeof(gpioPulse_t); + masked = 0; + + for (i=0; i= 0)) res = PI_SOME_PERMITTED; + + break; + + case PI_CMD_WVAS: + if (myPermit(p[1])) + { + memcpy(&tmp1, buf, 4); /* databits */ + memcpy(&tmp2, buf+4, 4); /* stophalfbits */ + memcpy(&tmp3, buf+8, 4); /* offset */ + res = gpioWaveAddSerial + (p[1], p[2], tmp1, tmp2, tmp3, p[3]-12, buf+12); + } + else + { + DBG( + DBG_USER, + "gpioWaveAddSerial: gpio %"PRIdPTR", no permission to update", p[1]); + res = PI_NOT_PERMITTED; + } + break; + + case PI_CMD_WVBSY: res = gpioWaveTxBusy(); break; + + case PI_CMD_WVCHA: + if (p[3] > bufSize) p[3] = bufSize; + res = gpioWaveChain(buf, p[3]); + break; + + + case PI_CMD_WVCLR: res = gpioWaveClear(); break; + + case PI_CMD_WVCRE: res = gpioWaveCreate(); break; + + case PI_CMD_WVCAP: + /* Make WVCAP variadic */ + if (p[3] == 4) + { + memcpy(&tmp3, buf, 4); /* percent TOOL */ + res = gpioWaveCreatePad(p[1], p[2], tmp3); /* rawWaveAdd* usage */ + break; + } + if (p[2] && p[3]==0) + { + res = gpioWaveCreatePad(p[1], p[2], 0); + break; + } + if (p[2]==0 && p[3]==0) + { + res = gpioWaveCreatePad(p[1], p[1], 0); /* typical usage */ + break; + } + res = PI_BAD_WAVE_ID; // FIX? + break; + + case PI_CMD_WVDEL: res = gpioWaveDelete(p[1]); break; + + case PI_CMD_WVGO: res = gpioWaveTxStart(PI_WAVE_MODE_ONE_SHOT); break; + + case PI_CMD_WVGOR: res = gpioWaveTxStart(PI_WAVE_MODE_REPEAT); break; + + case PI_CMD_WVHLT: res = gpioWaveTxStop(); break; + + case PI_CMD_WVNEW: res = gpioWaveAddNew(); break; + + case PI_CMD_WVSC: + switch(p[1]) + { + case 0: res = gpioWaveGetCbs(); break; + case 1: res = gpioWaveGetHighCbs(); break; + case 2: res = gpioWaveGetMaxCbs(); break; + default: res = PI_BAD_WVSC_COMMND; + } + break; + + case PI_CMD_WVSM: + switch(p[1]) + { + case 0: res = gpioWaveGetMicros(); break; + case 1: res = gpioWaveGetHighMicros(); break; + case 2: res = gpioWaveGetMaxMicros(); break; + default: res = PI_BAD_WVSM_COMMND; + } + break; + + case PI_CMD_WVSP: + switch(p[1]) + { + case 0: res = gpioWaveGetPulses(); break; + case 1: res = gpioWaveGetHighPulses(); break; + case 2: res = gpioWaveGetMaxPulses(); break; + default: res = PI_BAD_WVSP_COMMND; + } + break; + + case PI_CMD_WVTAT: res = gpioWaveTxAt(); break; + + case PI_CMD_WVTX: + res = gpioWaveTxSend(p[1], PI_WAVE_MODE_ONE_SHOT); break; + + case PI_CMD_WVTXM: + res = gpioWaveTxSend(p[1], p[2]); break; + + case PI_CMD_WVTXR: + res = gpioWaveTxSend(p[1], PI_WAVE_MODE_REPEAT); break; + + default: + res = PI_UNKNOWN_COMMAND; + break; + } + + return res; +} + +/* ----------------------------------------------------------------------- */ + +static void mySetGpioOff(unsigned gpio, int pos) +{ + int page, slot; + + myOffPageSlot(pos, &page, &slot); + + dmaIVirt[page]->gpioOff[slot] |= (1<gpioOff[slot] &= ~(1<gpioOn[slot] |= (1<gpioOn[slot] &= ~(1< oldOff) + { + for (i=0; i oldOff) + { + for (i=0; ihandle) + { + mbUnmapMem(DMAMemP->virtual_addr, DMAMemP->size); + mbUnlockMemory(fdMbox, DMAMemP->handle); + mbReleaseMemory(fdMbox, DMAMemP->handle); + DMAMemP->handle = 0; + } +} + +static int mbDMAAlloc(DMAMem_t *DMAMemP, unsigned size, uint32_t pi_mem_flag) +{ + DMAMemP->size = size; + + DMAMemP->handle = + mbAllocateMemory(fdMbox, size, PAGE_SIZE, pi_mem_flag); + + if (DMAMemP->handle) + { + DMAMemP->bus_addr = mbLockMemory(fdMbox, DMAMemP->handle); + + DMAMemP->virtual_addr = + mbMapMem(BUS_TO_PHYS(DMAMemP->bus_addr), size); + + return 1; + } + return 0; +} + + +/* ======================================================================= */ + +rawCbs_t * rawWaveCBAdr(int cbNum) +{ + int page, slot; + + page = cbNum/CBS_PER_OPAGE; + slot = cbNum%CBS_PER_OPAGE; + + return &dmaOVirt[page]->cb[slot]; +} + + +/* ----------------------------------------------------------------------- */ + +static uint32_t waveCbPOadr(int pos) +{ + int page, slot; + + page = pos/CBS_PER_OPAGE; + slot = pos%CBS_PER_OPAGE; + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaOBus contains bus addresses, not virtual addresses. + return (uint32_t)(uintptr_t) &dmaOBus[page]->cb[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static void waveOOLPageSlot(int pos, int *page, int *slot) +{ + *page = pos/OOL_PER_OPAGE; + *slot = pos%OOL_PER_OPAGE; +} + + +/* ----------------------------------------------------------------------- */ + +static void waveSetOOL(int pos, uint32_t OOL) +{ + int page, slot; + + waveOOLPageSlot(pos, &page, &slot); + + dmaOVirt[page]->OOL[slot] = OOL; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t waveOOLPOadr(int pos) +{ + int page, slot; + + waveOOLPageSlot(pos, &page, &slot); + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaOBus contains bus addresses, not virtual addresses. + return (uint32_t)(uintptr_t) &dmaOBus[page]->OOL[slot]; +} + + +/* ----------------------------------------------------------------------- */ + +static void waveBitDelay + (unsigned baud, unsigned bits, unsigned stops, unsigned *bitDelay) +{ + unsigned fullBit, last, diff, t, i; + + /* scaled 1000X */ + + fullBit = 1000000000 / baud; + last = 0; + + for (i=0; i<=bits; i++) + { + t = (((i+1)*fullBit)+500)/1000; + diff = t - last; + last = t; + bitDelay[i] = diff; + } + + t = (((bits+1)*fullBit) + ((stops*fullBit)/2) + 500)/1000; + diff = t - last; + bitDelay[i] = diff; +} + +static int waveDelayCBs(uint32_t delay) +{ + uint32_t cbs; + + if (!delay) return 0; + if (gpioCfg.DMAsecondaryChannel < DMA_LITE_FIRST) return 1; + cbs = BPD * delay / DMA_LITE_MAX; + if ((BPD * delay) % DMA_LITE_MAX) cbs++; + return cbs; +} + +/* ----------------------------------------------------------------------- */ + +static void waveCBsOOLs(int *numCBs, int *numBOOLs, int *numTOOLs) +{ + int numCB=0, numBOOL=0, numTOOL=0; + + unsigned i; + + unsigned numWaves; + + rawWave_t *waves; + + numWaves = wfc[wfcur]; + waves = wf [wfcur]; + + /* delay cb at start of DMA */ + + numCB++; + + for (i=0; iinfo = NORMAL_DMA | TIMED_DMA(2); + p->dst = PCM_TIMER; + } + else + { + p->info = NORMAL_DMA | TIMED_DMA(5); + p->dst = PWM_TIMER; + } + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaOBus contains bus addresses, not virtual addresses. + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->length = BPD * 20 / PI_WF_MICROS; /* 20 micros delay */ + p->next = waveCbPOadr(botCB); + + repeatCB = botCB; + + for (i=0; iinfo = TWO_BEAT_DMA; + p->src = waveOOLPOadr(botOOL); + waveSetOOL(botOOL++, waves[i].gpioOn); + s_stride = waveOOLPOadr(botOOL) - p->src; + waveSetOOL(botOOL++, waves[i].gpioOff); + p->dst = ((GPIO_BASE + (GPSET0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = (2<<16) + 4; // 2 transfers of 4 bytes each + p->stride = (12<<16) + s_stride; // d_stride = (GPCLR0-GPSET0)*4 = 12 + p->next = waveCbPOadr(botCB); + } + if (waves[i].gpioOn && !waves[i].gpioOff) + { + waveSetOOL(botOOL, waves[i].gpioOn); + + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA; + p->src = waveOOLPOadr(botOOL++); + p->dst = ((GPIO_BASE + (GPSET0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = 4; + p->next = waveCbPOadr(botCB); + } + if (waves[i].gpioOff && !waves[i].gpioOn) + { + waveSetOOL(botOOL, waves[i].gpioOff); + + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA; + p->src = waveOOLPOadr(botOOL++); + p->dst = ((GPIO_BASE + (GPCLR0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = 4; + p->next = waveCbPOadr(botCB); + } + if (waves[i].flags & WAVE_FLAG_READ) + { + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA; + p->src = ((GPIO_BASE + (GPLEV0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->dst = waveOOLPOadr(--topOOL); + p->length = 4; + p->next = waveCbPOadr(botCB); + } + + if (waves[i].flags & WAVE_FLAG_TICK) + { + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA; + p->src = ((SYST_BASE + (SYST_CLO*4)) & 0x00ffffff) | PI_PERI_BUS; + p->dst = waveOOLPOadr(--topOOL); + p->length = 4; + p->next = waveCbPOadr(botCB); + } + + if (waves[i].usDelay) + { + delayLeft = waves[i].usDelay; + + delayCBs = waveDelayCBs(delayLeft); + + for (dcb=0; dcbinfo = NORMAL_DMA | TIMED_DMA(2); + p->dst = PCM_TIMER; + } + else + { + p->info = NORMAL_DMA | TIMED_DMA(5); + p->dst = PWM_TIMER; + } + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaOBus contains bus addresses, not virtual addresses. + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + + p->length = BPD * delayLeft / PI_WF_MICROS; + + if ((gpioCfg.DMAsecondaryChannel >= DMA_LITE_FIRST) && + (p->length > DMA_LITE_MAX)) + { + p->length = DMA_LITE_MAX; + } + + delayLeft -= (p->length / BPD); + + p->next = waveCbPOadr(botCB); + } + } + } + + if (numCB) + { + /* Pad the wave */ + + botCB = *CB + numCB - 1; + botOOL = *BOOL + numBOOL - 1; + topOOL = *TOOL - numTOOL; + + /* Link the last CB to end of wave */ + + p->next = waveCbPOadr(botCB); + + /* Insert sentinel CB at end of DMA */ + + p = rawWaveCBAdr(botCB++); + p->info = NORMAL_DMA | DMA_DEST_IGNORE; + p->src = waveOOLPOadr(botOOL++); + p->dst = ((GPIO_BASE + (GPSET0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = 4; + p->next = 0; + } + + if (p != NULL) + { + if (wave_mode == PI_WAVE_MODE_ONE_SHOT) + p->next = 0; + else p->next = waveCbPOadr(repeatCB); + } + + status = botCB - *CB; + + *CB = botCB; + *BOOL = botOOL; + *TOOL = topOOL; + + return status; +} + +/* ----------------------------------------------------------------------- */ + +static void waveRxSerial(wfRx_t *w, int level, uint32_t tick) +{ + int diffTicks, lastLevel; + int newWritePos; + + level = level ^ w->s.invert; + + if (w->s.bit >= 0) + { + diffTicks = tick - w->s.startBitTick; + + if (level != PI_TIMEOUT) + { + w->s.level = level; + lastLevel = !level; + } + else lastLevel = w->s.level; + + while ((w->s.bit <= w->s.dataBits) && + (diffTicks > (w->s.nextBitDiff/1000))) + { + if (w->s.bit) + { + if (lastLevel) w->s.data |= (1<<(w->s.bit-1)); + } + else w->s.data = 0; + + ++(w->s.bit); + + w->s.nextBitDiff += w->s.fullBit; + } + + if (w->s.bit > w->s.dataBits) + { + memcpy(w->s.buf + w->s.writePos, &w->s.data, w->s.bytes); + + /* don't let writePos catch readPos */ + + newWritePos = (w->s.writePos + w->s.bytes) % (w->s.bufSize); + + if (newWritePos != w->s.readPos) w->s.writePos = newWritePos; + + if (level == 0) + { + gpioSetWatchdog(w->gpio, w->s.timeout); + w->s.bit = 0; + w->s.startBitTick = tick; + w->s.nextBitDiff = w->s.halfBit; + } + else + { + w->s.bit = -1; + gpioSetWatchdog(w->gpio, 0); + } + } + } + else + { + /* start bit if high->low */ + + if (level == 0) + { + gpioSetWatchdog(w->gpio, w->s.timeout); + w->s.level = 0; + w->s.bit = 0; + w->s.startBitTick = tick; + w->s.nextBitDiff = w->s.halfBit; + } + } +} + + +/* ----------------------------------------------------------------------- */ + +static void waveRxBit(int gpio, int level, uint32_t tick) +{ + switch (wfRx[gpio].mode) + { + case PI_WFRX_SERIAL: + waveRxSerial(&wfRx[gpio], level, tick); + } +} + + +/* ----------------------------------------------------------------------- */ + +int rawWaveAddGeneric(unsigned numIn1, rawWave_t *in1) +{ + unsigned inPos1=0, inPos2=0, outPos=0, level = NUM_WAVE_OOL; + + unsigned cbs=0; + + unsigned numIn2, numOut; + + uint32_t tNow, tNext1, tNext2, tDelay, tMax; + + rawWave_t *in2, *out; + + numIn2 = wfc[wfcur]; + in2 = wf[wfcur]; + + numOut = PI_WAVE_MAX_PULSES; + out = wf[1-wfcur]; + + tNow = 0; + tMax = 0; + + if (!numIn1) tNext1 = -1; else tNext1 = 0; + if (!numIn2) tNext2 = -1; else tNext2 = 0; + + while (((inPos1= numIn1) tNext1 = -1; + if (inPos2 >= numIn2) tNext2 = -1; + + } + + if (tNow < tMax) + { + /* extend previous delay */ + out[outPos-1].usDelay += (tMax - tNow); + tNow = tMax; + } + + if ((outPos < numOut) && (outPos < level)) + { + wfStats.micros = tNow; + + if (tNow > wfStats.highMicros) wfStats.highMicros = tNow; + + wfStats.pulses = outPos; + + if (outPos > wfStats.highPulses) wfStats.highPulses = outPos; + + wfStats.cbs = cbs; + + if (cbs > wfStats.highCbs) wfStats.highCbs = cbs; + + wfc[1-wfcur] = outPos; + wfcur = 1 - wfcur; + + return outPos; + } + else return PI_TOO_MANY_PULSES; +} + +/* ======================================================================= */ + +int i2cWriteQuick(unsigned handle, unsigned bit) +{ + int status; + + DBG(DBG_USER, "handle=%d bit=%d", handle, bit); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_QUICK) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (bit > 1) + SOFT_ERROR(PI_BAD_PARAM, "bad bit (%d)", bit); + + status = my_smbus_access( + i2cInfo[handle].fd, bit, 0, PI_I2C_SMBUS_QUICK, NULL); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + +int i2cReadByte(unsigned handle) +{ + union my_smbus_data data; + int status; + + DBG(DBG_USER, "handle=%d", handle); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_READ_BYTE) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + status = my_smbus_access( + i2cInfo[handle].fd, PI_I2C_SMBUS_READ, 0, PI_I2C_SMBUS_BYTE, &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + + return 0xFF & data.byte; +} + + +int i2cWriteByte(unsigned handle, unsigned bVal) +{ + int status; + + DBG(DBG_USER, "handle=%d bVal=%d", handle, bVal); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_WRITE_BYTE) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (bVal > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad bVal (%d)", bVal); + + status = my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + bVal, + PI_I2C_SMBUS_BYTE, + NULL); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + + +int i2cReadByteData(unsigned handle, unsigned reg) +{ + union my_smbus_data data; + int status; + + DBG(DBG_USER, "handle=%d reg=%d", handle, reg); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_READ_BYTE_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + status = my_smbus_access(i2cInfo[handle].fd, + PI_I2C_SMBUS_READ, reg, PI_I2C_SMBUS_BYTE_DATA, &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + + return 0xFF & data.byte; +} + + +int i2cWriteByteData(unsigned handle, unsigned reg, unsigned bVal) +{ + union my_smbus_data data; + + int status; + + DBG(DBG_USER, "handle=%d reg=%d bVal=%d", handle, reg, bVal); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_WRITE_BYTE_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if (bVal > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad bVal (%d)", bVal); + + data.byte = bVal; + + status = my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + reg, + PI_I2C_SMBUS_BYTE_DATA, + &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + + +int i2cReadWordData(unsigned handle, unsigned reg) +{ + union my_smbus_data data; + int status; + + DBG(DBG_USER, "handle=%d reg=%d", handle, reg); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_READ_WORD_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + status = (my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_READ, + reg, + PI_I2C_SMBUS_WORD_DATA, + &data)); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + + return 0xFFFF & data.word; +} + + +int i2cWriteWordData(unsigned handle, unsigned reg, unsigned wVal) +{ + union my_smbus_data data; + + int status; + + DBG(DBG_USER, "handle=%d reg=%d wVal=%d", handle, reg, wVal); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_WRITE_WORD_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if (wVal > 0xFFFF) + SOFT_ERROR(PI_BAD_PARAM, "bad wVal (%d)", wVal); + + data.word = wVal; + + status = my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + reg, + PI_I2C_SMBUS_WORD_DATA, + &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + + +int i2cProcessCall(unsigned handle, unsigned reg, unsigned wVal) +{ + union my_smbus_data data; + int status; + + DBG(DBG_USER, "handle=%d reg=%d wVal=%d", handle, reg, wVal); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_PROC_CALL) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if (wVal > 0xFFFF) + SOFT_ERROR(PI_BAD_PARAM, "bad wVal (%d)", wVal); + + data.word = wVal; + + status = (my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + reg, PI_I2C_SMBUS_PROC_CALL, + &data)); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + + return 0xFFFF & data.word; +} + + +int i2cReadBlockData(unsigned handle, unsigned reg, char *buf) +{ + union my_smbus_data data; + + int i, status; + + DBG(DBG_USER, "handle=%d reg=%d buf=%08"PRIXPTR, handle, reg, (uintptr_t)buf); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_READ_BLOCK_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + status = (my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_READ, + reg, + PI_I2C_SMBUS_BLOCK_DATA, + &data)); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + else + { + if (data.block[0] <= PI_I2C_SMBUS_BLOCK_MAX) + { + for (i=0; i= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_WRITE_BLOCK_DATA) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if ((count < 1) || (count > 32)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + for (i=1; i<=count; i++) data.block[i] = buf[i-1]; + data.block[0] = count; + + status = my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + reg, + PI_I2C_SMBUS_BLOCK_DATA, + &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + + +int i2cBlockProcessCall( + unsigned handle, unsigned reg, char *buf, unsigned count) +{ + union my_smbus_data data; + + int i, status; + + DBG(DBG_USER, "handle=%d reg=%d count=%d [%s]", + handle, reg, count, myBuf2Str(count, buf)); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_PROC_CALL) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if ((count < 1) || (count > 32)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + for (i=1; i<=count; i++) data.block[i] = buf[i-1]; + data.block[0] = count; + + status = (my_smbus_access( + i2cInfo[handle].fd, PI_I2C_SMBUS_WRITE, reg, + PI_I2C_SMBUS_BLOCK_PROC_CALL, &data)); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + else + { + if (data.block[0] <= PI_I2C_SMBUS_BLOCK_MAX) + { + for (i=0; i= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_READ_I2C_BLOCK) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if ((count < 1) || (count > 32)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + if (count == 32) + size = PI_I2C_SMBUS_I2C_BLOCK_BROKEN; + else + size = PI_I2C_SMBUS_I2C_BLOCK_DATA; + + data.block[0] = count; + + status = (my_smbus_access( + i2cInfo[handle].fd, PI_I2C_SMBUS_READ, reg, size, &data)); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_READ_FAILED; + } + else + { + if (data.block[0] <= PI_I2C_SMBUS_I2C_BLOCK_MAX) + { + for (i=0; i= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((i2cInfo[handle].funcs & PI_I2C_FUNC_SMBUS_WRITE_I2C_BLOCK) == 0) + SOFT_ERROR(PI_BAD_SMBUS_CMD, "SMBUS command not supported by driver"); + + if (reg > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad reg (%d)", reg); + + if ((count < 1) || (count > 32)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + for (i=1; i<=count; i++) data.block[i] = buf[i-1]; + + data.block[0] = count; + + status = my_smbus_access( + i2cInfo[handle].fd, + PI_I2C_SMBUS_WRITE, + reg, + PI_I2C_SMBUS_I2C_BLOCK_BROKEN, + &data); + + if (status < 0) + { + DBG(DBG_USER, "error=%d (%m)", status); + return PI_I2C_WRITE_FAILED; + } + + return status; +} + +int i2cWriteDevice(unsigned handle, char *buf, unsigned count) +{ + int bytes; + + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, buf)); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((count < 1) || (count > PI_MAX_I2C_DEVICE_COUNT)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + bytes = write(i2cInfo[handle].fd, buf, count); + + if (bytes != count) + { + DBG(DBG_USER, "error=%d (%m)", bytes); + return PI_I2C_WRITE_FAILED; + } + + return 0; +} + +int i2cReadDevice(unsigned handle, char *buf, unsigned count) +{ + int bytes; + + DBG(DBG_USER, "handle=%d count=%d buf=%08"PRIXPTR, + handle, count, (uintptr_t)buf); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if ((count < 1) || (count > PI_MAX_I2C_DEVICE_COUNT)) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + bytes = read(i2cInfo[handle].fd, buf, count); + + if (bytes != count) + { + DBG(DBG_USER, "error=%d (%m)", bytes); + return PI_I2C_READ_FAILED; + } + + return bytes; +} + +int i2cOpen(unsigned i2cBus, unsigned i2cAddr, unsigned i2cFlags) +{ + static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + char dev[32]; + int i, slot, fd; + uint32_t funcs; + + DBG(DBG_USER, "i2cBus=%d i2cAddr=%d flags=0x%X", + i2cBus, i2cAddr, i2cFlags); + + CHECK_INITED; + + if (i2cAddr > PI_MAX_I2C_ADDR) + SOFT_ERROR(PI_BAD_I2C_ADDR, "bad I2C address (%d)", i2cAddr); + + if (i2cFlags) + SOFT_ERROR(PI_BAD_FLAGS, "bad flags (0x%X)", i2cFlags); + + slot = -1; + + pthread_mutex_lock(&mutex); + + for (i=0; i= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].fd >= 0) close(i2cInfo[handle].fd); + + i2cInfo[handle].fd = -1; + i2cInfo[handle].state = PI_I2C_CLOSED; + + return 0; +} + +void i2cSwitchCombined(int setting) +{ + int fd; + + DBG(DBG_USER, "setting=%d", setting); + + fd = open(PI_I2C_COMBINED, O_WRONLY); + + if (fd >= 0) + { + if (setting) + { + if (write(fd, "1\n", 2) == -1) { /* ignore errors */ } + } + else + { + if (write(fd, "0\n", 2) == -1) { /* ignore errors */ } + } + + close(fd); + } +} + +int i2cSegments(unsigned handle, pi_i2c_msg_t *segs, unsigned numSegs) +{ + int retval; + my_i2c_rdwr_ioctl_data_t rdwr; + + DBG(DBG_USER, "handle=%d", handle); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (segs == NULL) + SOFT_ERROR(PI_BAD_POINTER, "null segments"); + + if (numSegs > PI_I2C_RDRW_IOCTL_MAX_MSGS) + SOFT_ERROR(PI_TOO_MANY_SEGS, "too many segments (%d)", numSegs); + + rdwr.msgs = segs; + rdwr.nmsgs = numSegs; + + retval = ioctl(i2cInfo[handle].fd, PI_I2C_RDWR, &rdwr); + + if (retval >= 0) return retval; + else return PI_BAD_I2C_SEG; +} + +int i2cZip( + unsigned handle, + char *inBuf, unsigned inLen, char *outBuf, unsigned outLen) +{ + int numSegs, inPos, outPos, status, bytes, flags, addr; + int esc, setesc; + pi_i2c_msg_t segs[PI_I2C_RDRW_IOCTL_MAX_MSGS]; + + DBG(DBG_USER, "handle=%d inBuf=%s outBuf=%08"PRIXPTR" len=%d", + handle, myBuf2Str(inLen, (char *)inBuf), (uintptr_t)outBuf, outLen); + + CHECK_INITED; + + if (handle >= PI_I2C_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (i2cInfo[handle].state != PI_I2C_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (!inBuf || !inLen) + SOFT_ERROR(PI_BAD_POINTER, "input buffer can't be NULL"); + + if (!outBuf && outLen) + SOFT_ERROR(PI_BAD_POINTER, "output buffer can't be NULL"); + + numSegs = 0; + + inPos = 0; + outPos = 0; + status = 0; + + addr = i2cInfo[handle].addr; + flags = 0; + esc = 0; + setesc = 0; + + while (!status && (inPos < inLen)) + { + DBG(DBG_INTERNAL, "status=%d inpos=%d inlen=%d cmd=%d addr=%d flags=%x", + status, inPos, inLen, inBuf[inPos], addr, flags); + + switch (inBuf[inPos++]) + { + case PI_I2C_END: + status = 1; + break; + + case PI_I2C_COMBINED_ON: + /* Run prior transactions before setting combined flag */ + if (numSegs) + { + status = i2cSegments(handle, segs, numSegs); + if (status >= 0) status = 0; /* continue */ + numSegs = 0; + } + i2cSwitchCombined(1); + break; + + case PI_I2C_COMBINED_OFF: + /* Run prior transactions before clearing combined flag */ + if (numSegs) + { + status = i2cSegments(handle, segs, numSegs); + if (status >= 0) status = 0; /* continue */ + numSegs = 0; + } + i2cSwitchCombined(0); + break; + + case PI_I2C_ADDR: + addr = myI2CGetPar(inBuf, &inPos, inLen, &esc); + if (addr < 0) status = PI_BAD_I2C_CMD; + break; + + case PI_I2C_FLAGS: + /* cheat to force two byte flags */ + esc = 1; + flags = myI2CGetPar(inBuf, &inPos, inLen, &esc); + if (flags < 0) status = PI_BAD_I2C_CMD; + break; + + case PI_I2C_ESC: + setesc = 1; + break; + + case PI_I2C_READ: + + bytes = myI2CGetPar(inBuf, &inPos, inLen, &esc); + + if (bytes >= 0) + { + if ((bytes + outPos) < outLen) + { + segs[numSegs].addr = addr; + segs[numSegs].flags = (flags|1); + segs[numSegs].len = bytes; + segs[numSegs].buf = (uint8_t *)(outBuf + outPos); + outPos += bytes; + numSegs++; + if (numSegs >= PI_I2C_RDRW_IOCTL_MAX_MSGS) + { + status = i2cSegments(handle, segs, numSegs); + if (status >= 0) status = 0; /* continue */ + numSegs = 0; + } + } + else status = PI_BAD_I2C_RLEN; + } + else status = PI_BAD_I2C_RLEN; + break; + + case PI_I2C_WRITE: + + bytes = myI2CGetPar(inBuf, &inPos, inLen, &esc); + + if (bytes >= 0) + { + if ((bytes + inPos) < inLen) + { + segs[numSegs].addr = addr; + segs[numSegs].flags = (flags&0xfffe); + segs[numSegs].len = bytes; + segs[numSegs].buf = (uint8_t *)(inBuf + inPos); + inPos += bytes; + numSegs++; + if (numSegs >= PI_I2C_RDRW_IOCTL_MAX_MSGS) + { + status = i2cSegments(handle, segs, numSegs); + if (status >= 0) status = 0; /* continue */ + numSegs = 0; + } + } + else status = PI_BAD_I2C_WLEN; + } + else status = PI_BAD_I2C_WLEN; + break; + + default: + status = PI_BAD_I2C_CMD; + } + + if (setesc) esc = 1; else esc = 0; + + setesc = 0; + } + + if (status >= 0) + { + if (numSegs) status = i2cSegments(handle, segs, numSegs); + } + + if (status >= 0) status = outPos; + + return status; +} + +/* ======================================================================= */ + +/*SPI */ + +static uint32_t _spiTXBits(char *buf, int pos, int bitlen, int msbf) +{ + uint32_t bits=0; + + if (buf) + { + if (bitlen <= 8) bits = *((( uint8_t*)buf)+pos); + else if (bitlen <= 16) bits = *(((uint16_t*)buf)+pos); + else bits = *(((uint32_t*)buf)+pos); + + if (msbf) bits <<= (32-bitlen); + } + + return bits; +} + +static void _spiRXBits( + char *buf, int pos, int bitlen, int msbf, uint32_t bits) +{ + if (buf) + { + if (!msbf) bits >>= (32-bitlen); + + if (bitlen <= 8) *((( uint8_t*)buf)+pos) = bits; + else if (bitlen <= 16) *(((uint16_t*)buf)+pos) = bits; + else *(((uint32_t*)buf)+pos) = bits; + } +} + +static void spiACS(int channel, int on) +{ + int gpio; + + switch (channel) + { + case 0: gpio = PI_ASPI_CE0; break; + case 1: gpio = PI_ASPI_CE1; break; + default: gpio = PI_ASPI_CE2; break; + } + myGpioWrite(gpio, on); +} + +static void spiGoA( + unsigned speed, /* bits per second */ + uint32_t flags, /* flags */ + char *txBuf, /* tx buffer */ + char *rxBuf, /* rx buffer */ + unsigned count) /* number of bytes */ +{ + int cs; + char bit_ir[4] = {1, 0, 0, 1}; /* read on rising edge */ + char bit_or[4] = {0, 1, 1, 0}; /* write on rising edge */ + char bit_ic[4] = {0, 0, 1, 1}; /* invert clock */ + + int mode, bitlen, txmsbf, rxmsbf, channel; + unsigned txCnt=0; + unsigned rxCnt=0; + uint32_t spiDefaults; + uint32_t statusReg; + int txFull, rxEmpty; + + channel = PI_SPI_FLAGS_GET_CHANNEL(flags); + mode = PI_SPI_FLAGS_GET_MODE (flags); + + bitlen = PI_SPI_FLAGS_GET_BITLEN (flags); + + if (!bitlen) bitlen = 8; + + /* correct count for word size */ + + if (bitlen > 8) count /= 2; + if (bitlen > 16) count /= 2; + + txmsbf = !PI_SPI_FLAGS_GET_TX_LSB (flags); + rxmsbf = !PI_SPI_FLAGS_GET_RX_LSB (flags); + + cs = PI_SPI_FLAGS_GET_CSPOLS(flags) & (1<>28)&15) > 2); + + if (rxCnt < count) + { + if (!rxEmpty) + { + _spiRXBits( + rxBuf, rxCnt++, bitlen, rxmsbf, auxReg[AUX_SPI0_IO_REG]); + } + } + + if (txCnt < count) + { + if (!txFull) + { + if (txCnt != (count-1)) + { + auxReg[AUX_SPI0_TX_HOLD] = + _spiTXBits(txBuf, txCnt++, bitlen, txmsbf); + } + else + { + auxReg[AUX_SPI0_IO_REG] = + _spiTXBits(txBuf, txCnt++, bitlen, txmsbf); + } + } + } + } + + while ((auxReg[AUX_SPI0_STAT_REG] & AUXSPI_STAT_BUSY)) ; + + spiACS(channel, !cs); +} + +static void spiGoS( + unsigned speed, + uint32_t flags, + char *txBuf, + char *rxBuf, + unsigned count) +{ + unsigned txCnt=0; + unsigned rxCnt=0; + unsigned cnt, cnt4w, cnt3w; + uint32_t spiDefaults; + unsigned mode, channel, cspol, cspols, flag3w, ren3w; + + channel = PI_SPI_FLAGS_GET_CHANNEL(flags); + mode = PI_SPI_FLAGS_GET_MODE (flags); + cspols = PI_SPI_FLAGS_GET_CSPOLS(flags); + cspol = (cspols>>channel) & 1; + flag3w = PI_SPI_FLAGS_GET_3WIRE(flags); + ren3w = PI_SPI_FLAGS_GET_3WREN(flags); + + spiDefaults = SPI_CS_MODE(mode) | + SPI_CS_CSPOLS(cspols) | + SPI_CS_CS(channel) | + SPI_CS_CSPOL(cspol) | + SPI_CS_CLEAR(3); + + spiReg[SPI_DLEN] = 2; /* undocumented, stops inter-byte gap */ + + spiReg[SPI_CS] = spiDefaults; /* stop */ + + if (!count) return; + + if (flag3w) + { + if (ren3w < count) + { + cnt4w = ren3w; + cnt3w = count - ren3w; + } + else + { + cnt4w = count; + cnt3w = 0; + } + } + else + { + cnt4w = count; + cnt3w = 0; + } + + spiReg[SPI_CLK] = 250000000/speed; + + spiReg[SPI_CS] = spiDefaults | SPI_CS_TA; /* start */ + + cnt = cnt4w; + + while((txCnt < cnt) || (rxCnt < cnt)) + { + while((rxCnt < cnt) && ((spiReg[SPI_CS] & SPI_CS_RXD))) + { + if (rxBuf) rxBuf[rxCnt] = spiReg[SPI_FIFO]; + else spi_dummy = spiReg[SPI_FIFO]; + rxCnt++; + } + + while((txCnt < cnt) && ((spiReg[SPI_CS] & SPI_CS_TXD))) + { + if (txBuf) spiReg[SPI_FIFO] = txBuf[txCnt]; + else spiReg[SPI_FIFO] = 0; + txCnt++; + } + } + + while (!(spiReg[SPI_CS] & SPI_CS_DONE)) ; + + /* now switch to 3-wire bus */ + + cnt += cnt3w; + + spiReg[SPI_CS] |= SPI_CS_REN; + + while((txCnt < cnt) || (rxCnt < cnt)) + { + while((rxCnt < cnt) && ((spiReg[SPI_CS] & SPI_CS_RXD))) + { + if (rxBuf) rxBuf[rxCnt] = spiReg[SPI_FIFO]; + else spi_dummy = spiReg[SPI_FIFO]; + rxCnt++; + } + + while((txCnt < cnt) && ((spiReg[SPI_CS] & SPI_CS_TXD))) + { + if (txBuf) spiReg[SPI_FIFO] = txBuf[txCnt]; + else spiReg[SPI_FIFO] = 0; + txCnt++; + } + } + + while (!(spiReg[SPI_CS] & SPI_CS_DONE)) ; + + spiReg[SPI_CS] = spiDefaults; /* stop */ +} + +static void spiGo( + unsigned speed, + uint32_t flags, + char *txBuf, + char *rxBuf, + unsigned count) +{ + static pthread_mutex_t main_mutex = PTHREAD_MUTEX_INITIALIZER; + static pthread_mutex_t aux_mutex = PTHREAD_MUTEX_INITIALIZER; + + if (PI_SPI_FLAGS_GET_AUX_SPI(flags)) + { + pthread_mutex_lock(&aux_mutex); + spiGoA(speed, flags, txBuf, rxBuf, count); + pthread_mutex_unlock(&aux_mutex); + } + else + { + pthread_mutex_lock(&main_mutex); + spiGoS(speed, flags, txBuf, rxBuf, count); + pthread_mutex_unlock(&main_mutex); + } +} + +static int spiAnyOpen(uint32_t flags) +{ + int i, aux; + + aux = PI_SPI_FLAGS_GET_AUX_SPI(flags); + + for (i=0; i= i) + SOFT_ERROR(PI_BAD_SPI_CHANNEL, "bad spiChan (%d)", spiChan); + + if ((baud < PI_SPI_MIN_BAUD) || (baud > PI_SPI_MAX_BAUD)) + SOFT_ERROR(PI_BAD_SPI_SPEED, "bad baud (%d)", baud); + + if (spiFlags > (1<<22)) + SOFT_ERROR(PI_BAD_FLAGS, "bad spiFlags (0x%X)", spiFlags); + + if (!spiAnyOpen(spiFlags)) /* initialise on first open */ + { + spiInit(spiFlags); + spiGo(baud, spiFlags, NULL, NULL, 0); + } + + slot = -1; + + pthread_mutex_lock(&mutex); + + for (i=0; i= PI_SPI_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (spiInfo[handle].state != PI_SPI_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + spiInfo[handle].state = PI_SPI_CLOSED; + + if (!spiAnyOpen(spiInfo[handle].flags)) + spiTerm(spiInfo[handle].flags); /* terminate on last close */ + + return 0; +} + +int spiRead(unsigned handle, char *buf, unsigned count) +{ + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, buf)); + + CHECK_INITED; + + if (handle >= PI_SPI_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (spiInfo[handle].state != PI_SPI_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (count > PI_MAX_SPI_DEVICE_COUNT) + SOFT_ERROR(PI_BAD_SPI_COUNT, "bad count (%d)", count); + + spiGo(spiInfo[handle].speed, spiInfo[handle].flags, NULL, buf, count); + + return count; +} + +int spiWrite(unsigned handle, char *buf, unsigned count) +{ + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, buf)); + + CHECK_INITED; + + if (handle >= PI_SPI_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (spiInfo[handle].state != PI_SPI_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (count > PI_MAX_SPI_DEVICE_COUNT) + SOFT_ERROR(PI_BAD_SPI_COUNT, "bad count (%d)", count); + + spiGo(spiInfo[handle].speed, spiInfo[handle].flags, buf, NULL, count); + + return count; +} + +int spiXfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count) +{ + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, txBuf)); + + CHECK_INITED; + + if (handle >= PI_SPI_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (spiInfo[handle].state != PI_SPI_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (count > PI_MAX_SPI_DEVICE_COUNT) + SOFT_ERROR(PI_BAD_SPI_COUNT, "bad count (%d)", count); + + spiGo(spiInfo[handle].speed, spiInfo[handle].flags, txBuf, rxBuf, count); + + return count; +} + +/* ======================================================================= */ + + +int serOpen(char *tty, unsigned serBaud, unsigned serFlags) +{ + static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + struct termios new; + int speed; + int fd; + int i, slot; + + DBG(DBG_USER, "tty=%s serBaud=%d serFlags=0x%X", tty, serBaud, serFlags); + + SER_CHECK_INITED; + + if (strncmp("/dev/tty", tty, 8) && strncmp("/dev/serial", tty, 11)) + SOFT_ERROR(PI_BAD_SER_DEVICE, "bad device (%s)", tty); + + switch (serBaud) + { + case 50: speed = B50; break; + case 75: speed = B75; break; + case 110: speed = B110; break; + case 134: speed = B134; break; + case 150: speed = B150; break; + case 200: speed = B200; break; + case 300: speed = B300; break; + case 600: speed = B600; break; + case 1200: speed = B1200; break; + case 1800: speed = B1800; break; + case 2400: speed = B2400; break; + case 4800: speed = B4800; break; + case 9600: speed = B9600; break; + case 19200: speed = B19200; break; + case 38400: speed = B38400; break; + case 57600: speed = B57600; break; + case 115200: speed = B115200; break; + case 230400: speed = B230400; break; + + default: + SOFT_ERROR(PI_BAD_SER_SPEED, "bad speed (%d)", serBaud); + } + + if (serFlags) + SOFT_ERROR(PI_BAD_FLAGS, "bad flags (0x%X)", serFlags); + + slot = -1; + + pthread_mutex_lock(&mutex); + + for (i=0; i= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].fd >= 0) close(serInfo[handle].fd); + + serInfo[handle].fd = -1; + serInfo[handle].state = PI_SER_CLOSED; + + return 0; +} + +int serWriteByte(unsigned handle, unsigned bVal) +{ + char c; + + DBG(DBG_USER, "handle=%d bVal=%d", handle, bVal); + + SER_CHECK_INITED; + + if (handle >= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (bVal > 0xFF) + SOFT_ERROR(PI_BAD_PARAM, "bad parameter (%d)", bVal); + + c = bVal; + + if (write(serInfo[handle].fd, &c, 1) != 1) + return PI_SER_WRITE_FAILED; + else + return 0; +} + +int serReadByte(unsigned handle) +{ + int r; + char x; + + DBG(DBG_USER, "handle=%d", handle); + + SER_CHECK_INITED; + + if (handle >= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + r = read(serInfo[handle].fd, &x, 1); + + if (r == 1) + return ((int)x) & 0xFF; + + else if (r == 0) + return PI_SER_READ_NO_DATA; + + else if ((r == -1) && (errno == EAGAIN)) + return PI_SER_READ_NO_DATA; + + else + return PI_SER_READ_FAILED; +} + +int serWrite(unsigned handle, char *buf, unsigned count) +{ + int written=0, wrote=0; + + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, buf)); + + SER_CHECK_INITED; + + if (handle >= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (!count) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + while ((written != count) && (wrote >= 0)) + { + wrote = write(serInfo[handle].fd, buf+written, count-written); + + if (wrote >= 0) + { + written += wrote; + + if (written != count) time_sleep(0.05); + } + } + + if (written != count) + return PI_SER_WRITE_FAILED; + else + return 0; +} + +int serRead(unsigned handle, char *buf, unsigned count) +{ + int r; + + DBG(DBG_USER, "handle=%d count=%d buf=0x%"PRIXPTR, handle, count, (uintptr_t)buf); + + SER_CHECK_INITED; + + if (handle >= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (!count) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + r = read(serInfo[handle].fd, buf, count); + + if (r == -1) + { + if (errno == EAGAIN) + return PI_SER_READ_NO_DATA; + else + return PI_SER_READ_FAILED; + } + else + { + if (r < count) buf[r] = 0; + return r; + } +} + +int serDataAvailable(unsigned handle) +{ + int result; + + DBG(DBG_USER, "handle=%d", handle); + + SER_CHECK_INITED; + + if (handle >= PI_SER_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (serInfo[handle].state != PI_SER_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (ioctl(serInfo[handle].fd, FIONREAD, &result) == -1) return 0; + + return result; +} + +/* ======================================================================= */ + +static int chooseBestClock + (clkInf_t *clkInf, unsigned f, unsigned numc, unsigned *cf) +{ + int c, valid; + double fdiv, offby, best_offby; + unsigned div, frac; + + valid = 0; + best_offby = 0; + + for (c=0; c 1) && (div < 4096)) + { + offby = f - (cf[c] / (div + (frac / 4096.0))); + if (offby < 0) offby = - offby; + if ((!valid) || (offby <= best_offby)) + { + valid = 1; + clkInf->div = div; + clkInf->frac = frac; + clkInf->clock = c; + best_offby = offby; + } + } + } + return valid; +} + +/* ======================================================================= */ + +static rawCbs_t * dmaCB2adr(int pos) +{ + int page, slot; + + page = pos/CBS_PER_IPAGE; + slot = pos%CBS_PER_IPAGE; + + return &dmaIVirt[page]->cb[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static void dmaCbPrint(int pos) +{ + rawCbs_t * p; + + p = dmaCB2adr(pos); + + fprintf(stderr, "i=%x s=%x d=%x len=%x s=%x nxt=%x\n", + p->info, p->src, p->dst, p->length, p->stride, p->next); +} + +/* ----------------------------------------------------------------------- */ + +static unsigned dmaNowAtICB(void) +{ + unsigned cb; + static unsigned lastPage=0; + unsigned page; + uint32_t cbAddr; + uint32_t startTick, endTick; + + startTick = systReg[SYST_CLO]; + + cbAddr = dmaIn[DMA_CONBLK_AD]; + + page = lastPage; + + /* which page are we dma'ing? */ + + while (1) + { + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + cb = (cbAddr - ((int)(uintptr_t)dmaIBus[page])) / 32; + + if (cb < CBS_PER_IPAGE) + { + endTick = systReg[SYST_CLO]; + + if (endTick != startTick) + gpioStats.cbTicks += (endTick - startTick); + + gpioStats.cbCalls++; + + lastPage = page; + + return (page*CBS_PER_IPAGE) + cb; + } + + if (page++ >= DMAI_PAGES) page=0; + + if (page == lastPage) break; + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +static int dmaNowAtOCB(void) +{ + unsigned cb; + unsigned page; + uint32_t cbAddr; + + cbAddr = dmaOut[DMA_CONBLK_AD]; + + if (!cbAddr) return -PI_NO_TX_WAVE; + + page = 0; + + /* which page are we dma'ing? */ + + while (1) + { + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + cb = (cbAddr - ((int)(uintptr_t)dmaOBus[page])) / 32; + + if (cb < CBS_PER_OPAGE) return (page*CBS_PER_OPAGE) + cb; + + if (page++ >= DMAO_PAGES) break; + } + + /* Try twice */ + + cbAddr = dmaOut[DMA_CONBLK_AD]; + + if (!cbAddr) return -PI_NO_TX_WAVE; + + page = 0; + + /* which page are we dma'ing? */ + + while (1) + { + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + cb = (cbAddr - ((int)(uintptr_t)dmaOBus[page])) / 32; + + if (cb < CBS_PER_OPAGE) return (page*CBS_PER_OPAGE) + cb; + + if (page++ >= DMAO_PAGES) break; + } + + return -PI_WAVE_NOT_FOUND; +} + +/* ----------------------------------------------------------------------- */ + +unsigned rawWaveCB(void) +{ + unsigned cb; + static unsigned lastPage=0; + unsigned page; + uint32_t cbAddr; + + cbAddr = dmaOut[DMA_CONBLK_AD]; + + if (!cbAddr) return -1; + + page = lastPage; + + /* which page are we dma'ing? */ + + while (1) + { + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + cb = (cbAddr - ((int)(uintptr_t)dmaOBus[page])) / 32; + + if (cb < CBS_PER_OPAGE) + { + lastPage = page; + + return (page*CBS_PER_OPAGE) + cb; + } + + if (page++ >= DMAO_PAGES) page=0; + + if (page == lastPage) break; + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +static unsigned dmaCurrentSlot(unsigned pos) +{ + unsigned cycle=0, slot=0, tmp; + + cycle = (pos/CBS_PER_CYCLE); + tmp = (pos%CBS_PER_CYCLE); + + if (tmp > 2) slot = ((tmp-2)/3); + + return (cycle*PULSE_PER_CYCLE)+slot; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaPwmDataAdr(int pos) +{ + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[pos]->periphData; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaGpioOnAdr(int pos) +{ + int page, slot; + + page = pos/ON_PER_IPAGE; + slot = pos%ON_PER_IPAGE; + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[page]->gpioOn[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaGpioOffAdr(int pos) +{ + int page, slot; + + myOffPageSlot(pos, &page, &slot); + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[page]->gpioOff[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaTickAdr(int pos) +{ + int page, slot; + + myTckPageSlot(pos, &page, &slot); + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[page]->tick[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaReadLevelsAdr(int pos) +{ + int page, slot; + + myLvsPageSlot(pos, &page, &slot); + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[page]->level[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t dmaCbAdr(int pos) +{ + int page, slot; + + page = (pos/CBS_PER_IPAGE); + slot = (pos%CBS_PER_IPAGE); + + //cast twice to suppress compiler warning, I belive this cast is ok + //because dmaIbus contains bus addresses, not user addresses. --plugwash + return (uint32_t)(uintptr_t) &dmaIBus[page]->cb[slot]; +} + +/* ----------------------------------------------------------------------- */ + +static void dmaGpioOnCb(int b, int pos) +{ + rawCbs_t * p; + + p = dmaCB2adr(b); + + p->info = NORMAL_DMA; + p->src = dmaGpioOnAdr(pos); + p->dst = ((GPIO_BASE + (GPSET0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = 4; + p->next = dmaCbAdr(b+1); +} + +/* ----------------------------------------------------------------------- */ + +static void dmaTickCb(int b, int pos) +{ + rawCbs_t * p; + + p = dmaCB2adr(b); + + p->info = NORMAL_DMA; + p->src = ((SYST_BASE + (SYST_CLO*4)) & 0x00ffffff) | PI_PERI_BUS; + p->dst = dmaTickAdr(pos); + p->length = 4; + p->next = dmaCbAdr(b+1); +} + +/* ----------------------------------------------------------------------- */ + +static void dmaGpioOffCb(int b, int pos) +{ + rawCbs_t * p; + + p = dmaCB2adr(b); + + p->info = NORMAL_DMA; + p->src = dmaGpioOffAdr(pos); + p->dst = ((GPIO_BASE + (GPCLR0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->length = 4; + p->next = dmaCbAdr(b+1); +} + +/* ----------------------------------------------------------------------- */ + +static void dmaReadLevelsCb(int b, int pos) +{ + rawCbs_t * p; + + p = dmaCB2adr(b); + + p->info = NORMAL_DMA; + p->src = ((GPIO_BASE + (GPLEV0*4)) & 0x00ffffff) | PI_PERI_BUS; + p->dst = dmaReadLevelsAdr(pos); + p->length = 4; + p->next = dmaCbAdr(b+1); +} + +/* ----------------------------------------------------------------------- */ + +static void dmaDelayCb(int b) +{ + rawCbs_t * p; + + p = dmaCB2adr(b); + + if (gpioCfg.clockPeriph == PI_CLOCK_PCM) + { + p->info = NORMAL_DMA | TIMED_DMA(2); + p->dst = PCM_TIMER; + } + else + { + p->info = NORMAL_DMA | TIMED_DMA(5); + p->dst = PWM_TIMER; + } + + p->src = dmaPwmDataAdr(b%DMAI_PAGES); + p->length = 4; + p->next = dmaCbAdr(b+1); +} + +/* ----------------------------------------------------------------------- */ + +static void dmaInitCbs(void) +{ + int b, pulse, level, cycle; + + rawCbs_t * p; + + /* set up the DMA control blocks */ + + DBG(DBG_STARTUP, ""); + + gpioStats.dmaInitCbsCount++; + + b = -1; + level = 0; + + for (cycle=0; cyclenext = dmaCbAdr(0); + + DBG(DBG_STARTUP, "DMA page type count = %zd", sizeof(dmaIPage_t)); + + DBG(DBG_STARTUP, "%d control blocks (exp=%d)", b+1, NUM_CBS); +} + +/* ======================================================================= */ + + +static void sigHandler(int signum) +{ + if ((signum >= PI_MIN_SIGNUM) && (signum <= PI_MAX_SIGNUM)) + { + if (gpioSignal[signum].func) + { + if (gpioSignal[signum].ex) + { + (gpioSignal[signum].func)(signum, gpioSignal[signum].userdata); + } + else + { + (gpioSignal[signum].func)(signum); + } + } + else + { + switch(signum) + { + case SIGUSR1: + + if (gpioCfg.dbgLevel > DBG_MIN_LEVEL) --gpioCfg.dbgLevel; + else gpioCfg.dbgLevel = DBG_MIN_LEVEL; + DBG(DBG_USER, "Debug level %d\n", gpioCfg.dbgLevel); + break; + + case SIGUSR2: + if (gpioCfg.dbgLevel < DBG_MAX_LEVEL) ++gpioCfg.dbgLevel; + else gpioCfg.dbgLevel = DBG_MAX_LEVEL; + DBG(DBG_USER, "Debug level %d\n", gpioCfg.dbgLevel); + break; + + case SIGPIPE: + case SIGWINCH: + DBG(DBG_USER, "signal %d ignored", signum); + break; + + case SIGCHLD: + /* Used to notify threads of events */ + break; + + default: + DBG(DBG_ALWAYS, "Unhandled signal %d, terminating\n", signum); + gpioTerminate(); + exit(-1); + } + } + } + else + { + /* exit */ + + DBG(DBG_ALWAYS, "Unhandled signal %d, terminating\n", signum); + gpioTerminate(); + exit(-1); + } +} + +/* ----------------------------------------------------------------------- */ + +static void sigSetHandler(void) +{ + int i; + struct sigaction new; + + for (i=PI_MIN_SIGNUM; i<=PI_MAX_SIGNUM; i++) + { + + memset(&new, 0, sizeof(new)); + new.sa_handler = sigHandler; + + sigaction(i, &new, NULL); + } +} + +/* + freq mics net + 0 1000 1000 900 + 1 4000 250 225 + 2 3750 266 240 + 3 3500 285 257 + 4 3250 307 276 + 5 3000 333 300 + 6 2750 363 327 + 7 2500 400 360 + 8 2250 444 400 + 9 2000 500 450 +10 1750 571 514 +11 1500 666 600 +12 1250 800 720 +13 1000 1000 900 +14 750 1333 1200 +15 500 2000 1800 +*/ + +unsigned alert_delays[]= +{ + 900000, 225000, 240000, 257142, 276923, 300000, 327272, 360000, + 400000, 450000, 514285, 600000, 720000, 900000, 1200000, 1800000 +}; + +/* ======================================================================= */ + +static void alertGlitchFilter(gpioSample_t *sample, int numSamples) +{ + int i, j, diff; + uint32_t steadyUs, changedTick, RBitV, LBitV, initialised; + uint32_t bit, bitV; + + for (i=0; i<=PI_MAX_USER_GPIO; i++) + { + bit = (1< 0) + { + /* Initialise filter with first sample */ + bitV = sample[0].level & bit; + gpioAlert[i].gfRBitV = bitV; + gpioAlert[i].gfLBitV = bitV; + gpioAlert[i].gfTick = sample[0].tick; + gpioAlert[i].gfInitialised = 1; + } + + steadyUs = gpioAlert[i].gfSteadyUs; + RBitV = gpioAlert[i].gfRBitV; + LBitV = gpioAlert[i].gfLBitV; + changedTick = gpioAlert[i].gfTick; + + for (j=0; j= steadyUs) + { + /* Level stable for steady period. */ + RBitV = bitV; + } + else + { + /* Keep reporting old level. */ + + sample[j].level ^= bit; + } + } + + } + + gpioAlert[i].gfRBitV = RBitV; + gpioAlert[i].gfLBitV = LBitV; + gpioAlert[i].gfTick = changedTick; + } + } +} + +static void alertNoiseFilter(gpioSample_t *sample, int numSamples) +{ + int i, j, diff; + uint32_t LBitV; + uint32_t bit, bitV; + uint32_t nowTick; + + for (i=0; i<=PI_MAX_USER_GPIO; i++) + { + bit = (1<= 0) + { + /* Stop reporting gpio changes */ + + gpioAlert[i].nfActive = 0; + gpioAlert[i].nfTick1 = nowTick; + } + } + else /* waiting for steady us */ + { + if (bitV != LBitV) + { + diff = nowTick - gpioAlert[i].nfTick1; + gpioAlert[i].nfTick1 = nowTick; + + if (diff >= gpioAlert[i].nfSteadyUs) + { + /* Start reporting gpio changes */ + + gpioAlert[i].nfRBitV = LBitV; + gpioAlert[i].nfActive = 1; + gpioAlert[i].nfTick2 = + nowTick + gpioAlert[i].nfActiveUs; + } + } + } + + if (!gpioAlert[i].nfActive) + { + if (bitV != gpioAlert[i].nfRBitV) + sample[j].level ^= bit; + } + + LBitV = bitV; + } + + gpioAlert[i].nfLBitV = LBitV; + + } + } +} + +static void alertEmit( + gpioSample_t *sample, int numSamples, uint32_t changedBits, uint32_t eTick) +{ + uint32_t oldLevel, newLevel; + int32_t diff; + int emit, seqno, emitted; + uint32_t changes, bits, timeoutBits, eventBits; + int d; + int b, n, v; + int err; + int max_emits; + char fifo[32]; + /* ensure space for maximum number of watchdog and event notifications */ + gpioReport_t report[MAX_REPORT+PI_MAX_USER_GPIO+1+PI_MAX_EVENT+1]; + + if (changedBits) + { + if (gpioGetSamples.func) + { + if (gpioGetSamples.ex) + { + (gpioGetSamples.func) + (sample, numSamples, gpioGetSamples.userdata); + } + else + { + (gpioGetSamples.func)(sample, numSamples); + } + } + } + + eventBits = 0; + + if (bscFR != (bscsReg[BSC_FR]&0xffff)) + { + bscFR = bscsReg[BSC_FR]&0xffff; + eventAlert[PI_EVENT_BSC].fired = 1; + } + + for (b=0; b<=PI_MAX_EVENT; b++) + { + if (eventAlert[b].fired && (!eventAlert[b].ignore)) + { + eventBits |= (1<= gpioAlert[b].wdSteadyUs) + { + timeoutBits |= (1<= PI_NOTIFY_OPENED) + { + bits = gpioNotify[n].bits; + + emit = 0; + + seqno = gpioNotify[n].seqno; + + if (gpioNotify[n].state == PI_NOTIFY_RUNNING) + { + /* check to see if any bits have changed for this + notification. + + bits is the set of notification bits + changedBits is the set of changed bits + */ + + if (changedBits & bits) + { + oldLevel = reportedLevel & bits; + + for (d=0; d 60000000) + { + if (numSamples) + newLevel = sample[numSamples-1].level; + else + newLevel = reportedLevel; + + report[emit].seqno = seqno; + report[emit].flags = PI_NTFY_FLAGS_ALIVE; + report[emit].tick = eTick; + report[emit].level = newLevel; + + emit++; + seqno++; + } + } + + if (emit) + { + DBG(DBG_FAST_TICK, "notification %d (%d reports, %x-%x)", + n, emit, report[0].seqno, report[emit-1].seqno); + gpioNotify[n].lastReportTick = eTick; + max_emits = gpioNotify[n].max_emits; + + if (emit > gpioStats.maxEmit) gpioStats.maxEmit = emit; + + emitted = 0; + + while (emit > 0) + { + if (emit > max_emits) + { + gpioStats.emitFrags++; + + err = write(gpioNotify[n].fd, + report+emitted, + max_emits*sizeof(gpioReport_t)); + + if (err != (max_emits*sizeof(gpioReport_t))) + { + if (err < 0) + { + if ((errno != EAGAIN) && (errno != EWOULDBLOCK)) + { + /* serious error, no point continuing */ + + DBG(DBG_ALWAYS, "fd=%d err=%d errno=%d", + gpioNotify[n].fd, err, errno); + + DBG(DBG_ALWAYS, "%s", strerror(errno)); + + gpioNotify[n].bits = 0; + gpioNotify[n].state = PI_NOTIFY_CLOSING; + intNotifyBits(); + break; + } + else gpioStats.wouldBlockPipeWrite++; + } + else + { + gpioStats.shortPipeWrite++; + DBG(DBG_ALWAYS, "emitted %zd, asked for %d", + err/sizeof(gpioReport_t), max_emits); + } + } + else + { + gpioStats.goodPipeWrite++; + } + + emitted += max_emits; + emit -= max_emits; + } + else + { + err = write(gpioNotify[n].fd, + report+emitted, + emit*sizeof(gpioReport_t)); + + if (err != (emit*sizeof(gpioReport_t))) + { + if (err < 0) + { + if ((errno != EAGAIN) && (errno != EWOULDBLOCK)) + { + DBG(DBG_ALWAYS, "fd=%d err=%d errno=%d", + gpioNotify[n].fd, err, errno); + + DBG(DBG_ALWAYS, "%s", strerror(errno)); + + /* serious error, no point continuing */ + gpioNotify[n].bits = 0; + gpioNotify[n].state = PI_NOTIFY_CLOSING; + intNotifyBits(); + break; + } + else gpioStats.wouldBlockPipeWrite++; + } + else + { + gpioStats.shortPipeWrite++; + DBG(DBG_ALWAYS, "emitted %zd, asked for %d", + err/sizeof(gpioReport_t), emit); + } + } + else + { + gpioStats.goodPipeWrite++; + } + + emitted += emit; + emit = 0; + } + } + + gpioNotify[n].seqno = seqno; + } + } + } + + if (changedBits & scriptBits) + { + for (n=0; n= PULSE_PER_CYCLE) + { + pulse = 0; + + if (++cycle >= bufferCycles) + { + cycle = 0; + oldSlot = 0; + } + + expected = sTick; + + sTick = myGetTick(cycle); + + if (stickInited) + { + diff = sTick - expected; + + if (abs(diff) > minDiff) + { + ft = sample[numSamples-PULSE_PER_CYCLE].tick; + + ticks = sTick - ft; + + for (i=1; i= TICKSLOTS) + { + gpioStats.diffTick[TICKSLOTS-1]++; + } + + else gpioStats.diffTick[diff]++; + } + else + { + stickInited = 1; + numSamples = 0; + if (!(gpioCfg.ifFlags & PI_DISABLE_ALERT)) + { + pthAlertRunning = PI_THREAD_RUNNING; + } + } + } + } + + if (oldSlot == newSlot) moreToDo = 0; else moreToDo = 1; + + /* Apply glitch filter */ + + if (numSamples && gFilterBits) alertGlitchFilter(sample, numSamples); + + /* Apply noise filter */ + + if (numSamples && nFilterBits) alertNoiseFilter(sample, numSamples); + + /* Compact samples */ + + changedBits = 0; + oldLevel &= monitorBits; + reports = 0; + totalSamples = 0; + + for (rp=0; rp= MAX_REPORT) + { + totalSamples += reports; + + /* Rebase watchdog timeouts */ + if (wdogBits) alertWdogCheck(sample, reports); + + gpioStats.numSamples += reports; + + alertEmit(sample, reports, changedBits, sample[rp].tick); + + changedBits = 0; + reports = 0; + } + } + } + + if (reports) + { + totalSamples += reports; + + /* Rebase watchdog timeouts */ + if (wdogBits) alertWdogCheck(sample, reports); + + gpioStats.numSamples += reports; + } + + alertEmit(sample, reports, changedBits, sTick); + reportedLevel = sample[numSamples -1].level; + + if (totalSamples > gpioStats.maxSamples) + gpioStats.maxSamples = numSamples; + + req.tv_sec = 0; + req.tv_nsec = alert_delays[(gpioCfg.internals>>PI_CFG_ALERT_FREQ)&15]; + + if (moreToDo) + { + gpioStats.moreToDo++; + } + else + { + gpioStats.alertTicks++; + + while (nanosleep(&req, &rem)) + { + req.tv_sec = rem.tv_sec; + req.tv_nsec = rem.tv_nsec; + } + } + } + + return 0; +} + +/* ======================================================================= */ + +static int scrPop(gpioScript_t *s, int *SP, int *S) +{ + if ((*SP) > 0) + { + return S[--(*SP)]; + } + else + { + s->run_state = PI_SCRIPT_FAILED; + DBG(DBG_ALWAYS, "script %d too many pops", s->id); + return 0; + } +} + +/* ----------------------------------------------------------------------- */ + +static void scrPush(gpioScript_t *s, int *SP, int *S, int val) +{ + if ((*SP) < PI_SCRIPT_STACK_SIZE) + { + S[(*SP)++] = val; + } + else + { + s->run_state = PI_SCRIPT_FAILED; + DBG(DBG_ALWAYS, "script %d too many pushes", s->id); + } +} + +/* ----------------------------------------------------------------------- */ + +static void scrSwap(int *v1, int *v2) +{ + int t; + + t=*v1; *v1=*v2; *v2= t; +} + +/* ----------------------------------------------------------------------- */ + +static int scrEvtWait(gpioScript_t *s, uint32_t bits) +{ + pthread_mutex_lock(&s->pthMutex); + + if (s->request == PI_SCRIPT_RUN) + { + s->run_state = PI_SCRIPT_WAITING; + s->eventBits = bits; + intScriptEventBits(); + + pthread_cond_wait(&s->pthCond, &s->pthMutex); + + s->waitBits = 0; + intScriptEventBits(); + s->run_state = PI_SCRIPT_RUNNING; + } + + pthread_mutex_unlock(&s->pthMutex); + + return s->changedBits; +} + +/* ----------------------------------------------------------------------- */ + +static int scrWait(gpioScript_t *s, uint32_t bits) +{ + pthread_mutex_lock(&s->pthMutex); + + if (s->request == PI_SCRIPT_RUN) + { + s->run_state = PI_SCRIPT_WAITING; + s->waitBits = bits; + intScriptBits(); + + pthread_cond_wait(&s->pthCond, &s->pthMutex); + + s->waitBits = 0; + intScriptBits(); + s->run_state = PI_SCRIPT_RUNNING; + } + + pthread_mutex_unlock(&s->pthMutex); + + return s->changedBits; +} + +/* ----------------------------------------------------------------------- */ + +static int scrSys(char *cmd, uint32_t p1, uint32_t p2) +{ + char buf[1024]; + int status; + + if (!myScriptNameValid(cmd)) + SOFT_ERROR(PI_BAD_SCRIPT_NAME, "bad script name (%s)", cmd); + + snprintf(buf, sizeof(buf), "/opt/pigpio/cgi/%s %u %u", cmd, p1, p2); + + DBG(DBG_USER, "%s", buf); + + status = system(buf); + + if (status < 0) status = PI_BAD_SHELL_STATUS; + + return status; +} + +/* ----------------------------------------------------------------------- */ + +static void *pthScript(void *x) +{ + gpioScript_t *s; + cmdInstr_t instr; + int p1, p2, p1o, p2o, p3o, *t1, *t2; + int PC, A, F, SP; + int S[PI_SCRIPT_STACK_SIZE]; + char buf[CMD_MAX_EXTENSION]; + + + S[0] = 0; /* to prevent compiler warning */ + + s = x; + + while ((volatile int)s->request != PI_SCRIPT_DELETE) + { + pthread_mutex_lock(&s->pthMutex); + s->run_state = PI_SCRIPT_HALTED; + pthread_cond_wait(&s->pthCond, &s->pthMutex); + pthread_mutex_unlock(&s->pthMutex); + + s->run_state = PI_SCRIPT_RUNNING; + + A = 0; + F = 0; + PC = 0; + SP = 0; + + while (((volatile int)s->request == PI_SCRIPT_RUN ) && + (s->run_state == PI_SCRIPT_RUNNING)) + { + instr = s->script.instr[PC]; + + p1o = instr.p[1]; + p2o = instr.p[2]; + + if (instr.opt[1] == CMD_VAR) instr.p[1] = s->script.var[p1o]; + else if (instr.opt[1] == CMD_PAR) instr.p[1] = s->script.par[p1o]; + + if (instr.opt[2] == CMD_VAR) instr.p[2] = s->script.var[p2o]; + else if (instr.opt[2] == CMD_PAR) instr.p[2] = s->script.par[p2o]; +/* + fprintf(stderr, "PC=%d cmd=%d p1o=%d p1=%d p2o=%d p2=%d\n", + PC, instr.p[0], p1o, instr.p[1], p2o, instr.p[2]); + fflush(stderr); +*/ + if (instr.p[0] < PI_CMD_SCRIPT) + { + if (instr.p[3]) + { + if ((instr.p[3] == sizeof(int)) && ((instr.opt[3] == CMD_VAR) || (instr.opt[3] == CMD_PAR))) + { + /* Hack to allow register use in 3rd parameter */ + memcpy((char*)&p3o, (char *)instr.p[4], sizeof(int)); + if (instr.opt[3] == CMD_VAR) memcpy(buf, (char *)&(s->script.var[p3o]), sizeof(int)); + else memcpy(buf, (char *)&(s->script.par[p3o]), sizeof(int)); + } + else + { + memcpy(buf, (char *)instr.p[4], instr.p[3]); + } + } + + A = myDoCommand(instr.p, sizeof(buf)-1, buf); + + F = A; + + PC++; + } + else + { + p1 = instr.p[1]; + p2 = instr.p[2]; + + switch (instr.p[0]) + { + case PI_CMD_ADD: A+=p1; F=A; PC++; break; + + case PI_CMD_AND: A&=p1; F=A; PC++; break; + + case PI_CMD_CALL: scrPush(s, &SP, S, PC+1); PC = p1; break; + + case PI_CMD_CMP: F=A-p1; PC++; break; + + case PI_CMD_DCR: + if (instr.opt[1] == CMD_PAR) + {--s->script.par[p1o]; F=s->script.par[p1o];} + else + {--s->script.var[p1o]; F=s->script.var[p1o];} + PC++; + break; + + case PI_CMD_DCRA: --A; F=A; PC++; break; + + case PI_CMD_DIV: A/=p1; F=A; PC++; break; + + case PI_CMD_HALT: s->run_state = PI_SCRIPT_HALTED; break; + + case PI_CMD_EVTWT: A=scrEvtWait(s, p1); F=A; PC++; break; + + case PI_CMD_INR: + if (instr.opt[1] == CMD_PAR) + {++s->script.par[p1o]; F=s->script.par[p1o];} + else + {++s->script.var[p1o]; F=s->script.var[p1o];} + PC++; + break; + + case PI_CMD_INRA: ++A; F=A; PC++; break; + + case PI_CMD_JM: if (F<0) PC=p1; else PC++; break; + + case PI_CMD_JMP: PC=p1; break; + + case PI_CMD_JNZ: if (F) PC=p1; else PC++; break; + + case PI_CMD_JP: if (F>=0) PC=p1; else PC++; break; + + case PI_CMD_JZ: if (!F) PC=p1; else PC++; break; + + case PI_CMD_LD: + if (instr.opt[1] == CMD_PAR) s->script.par[p1o]=p2; + else s->script.var[p1o]=p2; + PC++; + break; + + case PI_CMD_LDA: A=p1; PC++; break; + + case PI_CMD_LDAB: + if ((p1 >= 0) && (p1 < sizeof(buf))) A = buf[p1]; + PC++; + break; + + case PI_CMD_MLT: A*=p1; F=A; PC++; break; + + case PI_CMD_MOD: A%=p1; F=A; PC++; break; + + case PI_CMD_OR: A|=p1; F=A; PC++; break; + + case PI_CMD_POP: + if (instr.opt[1] == CMD_PAR) + s->script.par[p1o]=scrPop(s, &SP, S); + else + s->script.var[p1o]=scrPop(s, &SP, S); + PC++; + break; + + case PI_CMD_POPA: A=scrPop(s, &SP, S); PC++; break; + + case PI_CMD_PUSH: + if (instr.opt[1] == CMD_PAR) + scrPush(s, &SP, S, s->script.par[p1o]); + else + scrPush(s, &SP, S, s->script.var[p1o]); + PC++; + break; + + case PI_CMD_PUSHA: scrPush(s, &SP, S, A); PC++; break; + + case PI_CMD_RET: PC=scrPop(s, &SP, S); break; + + case PI_CMD_RL: + if (instr.opt[1] == CMD_PAR) + {s->script.par[p1o]<<=p2; F=s->script.par[p1o];} + else + {s->script.var[p1o]<<=p2; F=s->script.var[p1o];} + PC++; + break; + + case PI_CMD_RLA: A<<=p1; F=A; PC++; break; + + case PI_CMD_RR: + if (instr.opt[1] == CMD_PAR) + {s->script.par[p1o]>>=p2; F=s->script.par[p1o];} + else + {s->script.var[p1o]>>=p2; F=s->script.var[p1o];} + PC++; + break; + + case PI_CMD_RRA: A>>=p1; F=A; PC++; break; + + case PI_CMD_STA: + if (instr.opt[1] == CMD_PAR) s->script.par[p1o]=A; + else s->script.var[p1o]=A; + PC++; + break; + + case PI_CMD_STAB: + if ((p1 >= 0) && (p1 < sizeof(buf))) buf[p1] = A; + PC++; + break; + + case PI_CMD_SUB: A-=p1; F=A; PC++; break; + + case PI_CMD_SYS: + A=scrSys((char*)instr.p[4], A, *(gpioReg + GPLEV0)); + F=A; + PC++; + break; + + case PI_CMD_WAIT: A=scrWait(s, p1); F=A; PC++; break; + + case PI_CMD_X: + if (instr.opt[1] == CMD_PAR) t1 = &s->script.par[p1o]; + else t1 = &s->script.var[p1o]; + + if (instr.opt[2] == CMD_PAR) t2 = &s->script.par[p2o]; + else t2 = &s->script.var[p2o]; + + scrSwap(t1, t2); + PC++; + break; + + case PI_CMD_XA: + if (instr.opt[1] == CMD_PAR) + scrSwap(&s->script.par[p1o], &A); + else + scrSwap(&s->script.var[p1o], &A); + PC++; + break; + + case PI_CMD_XOR: A^=p1; F=A; PC++; break; + + } + } + + if (PC >= s->script.instrs) s->run_state = PI_SCRIPT_HALTED; + + } + + if ((volatile int)s->request == PI_SCRIPT_HALT) + s->run_state = PI_SCRIPT_HALTED; + + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +static void * pthTimerTick(void *x) +{ + gpioTimer_t *tp; + struct timespec req, rem; + + tp = x; + + while (1) + { + req.tv_sec = tp->millis / THOUSAND; + req.tv_nsec = (tp->millis % THOUSAND) * THOUSAND * THOUSAND; + + while (nanosleep(&req, &rem)) + { + req.tv_sec = rem.tv_sec; + req.tv_nsec = rem.tv_nsec; + } + + if (tp->ex) (tp->func)(tp->userdata); + else (tp->func)(); + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + + +static void * pthFifoThread(void *x) +{ + char buf[CMD_MAX_EXTENSION]; + int idx, flags, len, res, i; + uintptr_t p[CMD_P_ARR]; + cmdCtlParse_t ctl; + uint32_t *param; + char v[CMD_MAX_EXTENSION]; + + myCreatePipe(PI_INPFIFO, 0662); + + if ((inpFifo = fopen(PI_INPFIFO, "r+")) == NULL) + SOFT_ERROR((void*)PI_INIT_FAILED, "fopen %s failed(%m)", PI_INPFIFO); + + myCreatePipe(PI_OUTFIFO, 0664); + + if ((outFifo = fopen(PI_OUTFIFO, "w+")) == NULL) + SOFT_ERROR((void*)PI_INIT_FAILED, "fopen %s failed (%m)", PI_OUTFIFO); + + /* set outFifo non-blocking */ + + flags = fcntl(fileno(outFifo), F_GETFL, 0); + fcntl(fileno(outFifo), F_SETFL, flags | O_NONBLOCK); + + /* don't start until DMA started */ + + spinWhileStarting(); + + while (1) + { + if (fgets(buf, sizeof(buf), inpFifo) == NULL) + SOFT_ERROR((void*)PI_INIT_FAILED, "fifo fgets failed (%m)"); + + len = strlen(buf); + + if (len) + { + --len; + buf[len] = 0; /* replace terminating */ + } + + ctl.eaten = 0; + idx = 0; + + while (((ctl.eaten)= 0)) + { + if ((idx=cmdParse(buf, p, CMD_MAX_EXTENSION, v, &ctl)) >= 0) + { + /* make sure extensions are null terminated */ + + v[p[3]] = 0; + + res = myDoCommand(p, sizeof(v)-1, v); + + switch (cmdInfo[idx].rv) + { + case 0: + fprintf(outFifo, "%d\n", res); + break; + + case 1: + fprintf(outFifo, "%d\n", res); + break; + + case 2: + fprintf(outFifo, "%d\n", res); + break; + + case 3: + fprintf(outFifo, "%08X\n", res); + break; + + case 4: + fprintf(outFifo, "%u\n", res); + break; + + case 5: + fprintf(outFifo, "%s", cmdUsage); + break; + + case 6: + fprintf(outFifo, "%d", res); + if (res > 0) + { + for (i=0; i= 0) + { + memcpy(buf, &p[3], 4); + p[3] = 4 + (4*PI_MAX_SCRIPT_PARAMS); + } + break; + + default: + p[3] = myDoCommand(p, sizeof(buf)-1, buf); + } + + if (sizeof(uintptr_t) == 8) // 64-bit system + { + for (i = 0; i < 4; i++) + response[i] = (uint32_t)p[i]; + if (write(sock, response, 16) == -1) { /* ignore errors */ } + } + else // 32-bit system + { + if (write(sock, p, 16) == -1) { /* ignore errors */ } + } + + switch (p[0]) + { + /* extensions */ + + case PI_CMD_BI2CZ: + case PI_CMD_BSCX: + case PI_CMD_CF2: + case PI_CMD_FL: + case PI_CMD_FR: + case PI_CMD_I2CPK: + case PI_CMD_I2CRD: + case PI_CMD_I2CRI: + case PI_CMD_I2CRK: + case PI_CMD_I2CZ: + case PI_CMD_PROCP: + case PI_CMD_SERR: + case PI_CMD_SLR: + case PI_CMD_SPIX: + case PI_CMD_SPIR: + case PI_CMD_BSPIX: + + if (((int)p[3]) > 0) + { + if (write(sock, buf, p[3]) == 1) { /* ignore errors */ } + } + break; + + default: + break; + } + } + + closeOrphanedNotifications(-1, sock); + + close(sock); + + DBG(DBG_USER, "Socket %d closed", sock); + + return 0; +} + +static int addrAllowed(struct sockaddr *saddr) +{ + int i; + uint32_t addr; + + if (!numSockNetAddr) return 1; + + // FIXME: add IPv6 whitelisting support + if (saddr->sa_family != AF_INET) return 0; + + addr = ((struct sockaddr_in *) saddr)->sin_addr.s_addr; + + for (i=0; i= 0) + { + pthread_t thr; + + fdC = accept(fdSock, (struct sockaddr *)&client, (socklen_t*)&c); + + closeOrphanedNotifications(-1, fdC); + + if (addrAllowed((struct sockaddr *)&client)) + { + DBG(DBG_USER, "Connection accepted on socket %d", fdC); + + sock = malloc(sizeof(int)); + + *sock = fdC; + + /* Enable tcp_keepalive */ + int optval = 1; + socklen_t optlen = sizeof(optval); + + if (setsockopt(fdC, SOL_SOCKET, SO_KEEPALIVE, &optval, optlen) < 0) + { + DBG(DBG_ALWAYS, "setsockopt() fail, closing socket %d", fdC); + close(fdC); + } + + DBG(DBG_USER, "SO_KEEPALIVE enabled on socket %d\n", fdC); + + if (pthread_create + (&thr, &attr, pthSocketThreadHandler, (void*) sock) < 0) + SOFT_ERROR((void*)PI_INIT_FAILED, + "socket pthread_create failed (%m)"); + } + else + { + DBG(DBG_ALWAYS, "Connection rejected, closing"); + close(fdC); + } + } + + if (fdC < 0) + SOFT_ERROR((void*)PI_INIT_FAILED, "accept failed (%m)"); + + return 0; +} + +/* ======================================================================= */ + +static void initCheckLockFile(void) +{ + int fd; + int count; + int pid; + int err; + int delete; + char str[20]; + + fd = open(PI_LOCKFILE, O_RDONLY); + + if (fd != -1) + { + DBG(DBG_STARTUP, "lock file exists"); + delete = 1; + + count = read(fd, str, sizeof(str)-1); + + if (count) + { + pid = atoi(str); + err = kill(pid, 0); + if (!err) delete = 0; /* process still exists */ + DBG(DBG_STARTUP, "lock file pid=%d err=%d", pid, err); + } + + close(fd); + DBG(DBG_STARTUP, "lock file delete=%d", delete); + + if (delete) unlink(PI_LOCKFILE); + } +} + +static int initGrabLockFile(void) +{ + int fd; + int lockResult; + char pidStr[20]; + + initCheckLockFile(); + + /* try to grab the lock file */ + + fd = open(PI_LOCKFILE, O_WRONLY|O_CREAT|O_EXCL|O_TRUNC, 0644); + + if (fd != -1) + { + lockResult = flock(fd, LOCK_EX|LOCK_NB); + + if(lockResult == 0) + { + sprintf(pidStr, "%d\n", (int)getpid()); + + if (write(fd, pidStr, strlen(pidStr)) == -1) + { + /* ignore errors */ + } + } + else + { + close(fd); + return -1; + } + } + + return fd; +} + +/* ----------------------------------------------------------------------- */ + +static uint32_t * initMapMem(int fd, uint32_t addr, uint32_t len) +{ + return (uint32_t *) mmap(0, len, + PROT_READ|PROT_WRITE, + MAP_SHARED|MAP_LOCKED, + fd, addr); +} + +/* ----------------------------------------------------------------------- */ + +static int initCheckPermitted(void) +{ + DBG(DBG_STARTUP, ""); + + if (!pi_ispi) + { + DBG(DBG_ALWAYS, + "\n" \ + "+---------------------------------------------------------+\n" \ + "|Sorry, this system does not appear to be a raspberry pi. |\n" \ + "|aborting. |\n" \ + "+---------------------------------------------------------+\n\n"); + return -1; + } + + if ((fdMem = open("/dev/mem", O_RDWR | O_SYNC) ) < 0) + { + DBG(DBG_ALWAYS, + "\n" \ + "+---------------------------------------------------------+\n" \ + "|Sorry, you don't have permission to run this program. |\n" \ + "|Try running as root, e.g. precede the command with sudo. |\n" \ + "+---------------------------------------------------------+\n\n"); + return -1; + } + return 0; +} + +/* ----------------------------------------------------------------------- */ + +static int initPeripherals(void) +{ + DBG(DBG_STARTUP, ""); + + gpioReg = initMapMem(fdMem, GPIO_BASE, GPIO_LEN); + + if (gpioReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap gpio failed (%m)"); + + dmaReg = initMapMem(fdMem, DMA_BASE, DMA_LEN); + + if (dmaReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap dma failed (%m)"); + + /* we should know if we are running on a BCM2711 by now */ + + if (gpioCfg.DMAprimaryChannel == PI_DEFAULT_DMA_NOT_SET) + { + if (pi_is_2711) + gpioCfg.DMAprimaryChannel = PI_DEFAULT_DMA_PRIMARY_CH_2711; + else + gpioCfg.DMAprimaryChannel = PI_DEFAULT_DMA_PRIMARY_CHANNEL; + } + + if (gpioCfg.DMAsecondaryChannel == PI_DEFAULT_DMA_NOT_SET) + { + if (pi_is_2711) + gpioCfg.DMAsecondaryChannel = PI_DEFAULT_DMA_SECONDARY_CH_2711; + else + gpioCfg.DMAsecondaryChannel = PI_DEFAULT_DMA_SECONDARY_CHANNEL; + } + + dmaIn = dmaReg + (gpioCfg.DMAprimaryChannel * 0x40); + dmaOut = dmaReg + (gpioCfg.DMAsecondaryChannel * 0x40); + + DBG(DBG_STARTUP, "DMA #%d @ %08"PRIXPTR, + gpioCfg.DMAprimaryChannel, (uintptr_t)dmaIn); + + DBG(DBG_STARTUP, "debug reg is %08X", dmaIn[DMA_DEBUG]); + + clkReg = initMapMem(fdMem, CLK_BASE, CLK_LEN); + + if (clkReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap clk failed (%m)"); + + systReg = initMapMem(fdMem, SYST_BASE, SYST_LEN); + + if (systReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap syst failed (%m)"); + + spiReg = initMapMem(fdMem, SPI_BASE, SPI_LEN); + + if (spiReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap spi failed (%m)"); + + pwmReg = initMapMem(fdMem, PWM_BASE, PWM_LEN); + + if (pwmReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap pwm failed (%m)"); + + pcmReg = initMapMem(fdMem, PCM_BASE, PCM_LEN); + + if (pcmReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap pcm failed (%m)"); + + auxReg = initMapMem(fdMem, AUX_BASE, AUX_LEN); + + if (auxReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap aux failed (%m)"); + + padsReg = initMapMem(fdMem, PADS_BASE, PADS_LEN); + + if (padsReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap pads failed (%m)"); + + bscsReg = initMapMem(fdMem, BSCS_BASE, BSCS_LEN); + + if (bscsReg == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap bscs failed (%m)"); + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +static int initZaps + (int pmapFd, void *virtualBase, int basePage, int pages) +{ + int n; + uintptr_t index; + off_t offset; + ssize_t t; + uint32_t physical; + int status; + uintptr_t pageAdr; + unsigned long long pa; + + DBG(DBG_STARTUP, ""); + + status = 0; + + pageAdr = (uintptr_t) dmaVirt[basePage]; + + index = ((uintptr_t)virtualBase / PAGE_SIZE) * 8; + + offset = lseek(pmapFd, index, SEEK_SET); + + if (offset != index) + SOFT_ERROR(PI_INIT_FAILED, "lseek pagemap failed (%m)"); + + for (n=0; n PI_DEFAULT_BUFFER_MILLIS))) + { + /* pagemap allocation of DMA memory */ + + dmaPMapBlk = mmap( + 0, (bufferBlocks+PI_WAVE_BLOCKS)*sizeof(dmaPage_t *), + PROT_READ|PROT_WRITE, + MAP_PRIVATE|MAP_ANONYMOUS|MAP_LOCKED, + -1, 0); + + if (dmaPMapBlk == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "pagemap mmap block failed (%m)"); + + fdPmap = open("/proc/self/pagemap", O_RDONLY); + + if (fdPmap < 0) + SOFT_ERROR(PI_INIT_FAILED, "pagemap open failed(%m)"); + + for (i=0; i<(bufferBlocks+PI_WAVE_BLOCKS); i++) + { + status = initPagemapBlock(i); + if (status < 0) + { + close(fdPmap); + return status; + } + } + + close(fdPmap); + + DBG(DBG_STARTUP, "dmaPMapBlk=%08"PRIXPTR" dmaIn=%08"PRIXPTR, + (uintptr_t)dmaPMapBlk, (uintptr_t)dmaIn); + } + else + { + /* mailbox allocation of DMA memory */ + + dmaMboxBlk = mmap( + 0, (bufferBlocks+PI_WAVE_BLOCKS)*sizeof(DMAMem_t), + PROT_READ|PROT_WRITE, + MAP_PRIVATE|MAP_ANONYMOUS|MAP_LOCKED, + -1, 0); + + if (dmaMboxBlk == MAP_FAILED) + SOFT_ERROR(PI_INIT_FAILED, "mmap mbox block failed (%m)"); + + fdMbox = mbOpen(); + + if (fdMbox < 0) + SOFT_ERROR(PI_INIT_FAILED, "mbox open failed(%m)"); + + for (i=0; i<(bufferBlocks+PI_WAVE_BLOCKS); i++) + { + status = initMboxBlock(i); + if (status < 0) + { + mbClose(fdMbox); + return status; + } + } + + mbClose(fdMbox); + + DBG(DBG_STARTUP, "dmaMboxBlk=%08"PRIXPTR" dmaIn=%08"PRIXPTR, + (uintptr_t)dmaMboxBlk, (uintptr_t)dmaIn); + } + + DBG(DBG_STARTUP, + "gpioReg=%08"PRIXPTR" pwmReg=%08"PRIXPTR" pcmReg=%08"PRIXPTR" clkReg=%08"PRIXPTR" auxReg=%08"PRIXPTR, + (uintptr_t)gpioReg, (uintptr_t)pwmReg, + (uintptr_t)pcmReg, (uintptr_t)clkReg, (uintptr_t)auxReg); + + for (i=0; i= DBG_DMACBS) + { + fprintf(stderr, "*** INPUT DMA CONTROL BLOCKS ***\n"); + for (i=0; iperiphData = 1; + + /* enable PWM DMA, raise panic and dreq thresholds to 15 */ + + pwmReg[PWM_DMAC] = PWM_DMAC_ENAB | + PWM_DMAC_PANIC(15) | + PWM_DMAC_DREQ(15); + + myGpioDelay(10); + + /* clear PWM fifo */ + + pwmReg[PWM_CTL] = PWM_CTL_CLRF1; + + myGpioDelay(10); + + /* enable PWM channel 1 and use fifo */ + + pwmReg[PWM_CTL] = PWM_CTL_USEF1 | PWM_CTL_MODE1 | PWM_CTL_PWEN1; +} + +/* ----------------------------------------------------------------------- */ + +static void initPCM(unsigned bits) +{ + DBG(DBG_STARTUP, "bits=%d", bits); + + /* disable PCM so we can modify the regs */ + + pcmReg[PCM_CS] = 0; + + myGpioDelay(1000); + + pcmReg[PCM_FIFO] = 0; + pcmReg[PCM_MODE] = 0; + pcmReg[PCM_RXC] = 0; + pcmReg[PCM_TXC] = 0; + pcmReg[PCM_DREQ] = 0; + pcmReg[PCM_INTEN] = 0; + pcmReg[PCM_INTSTC] = 0; + pcmReg[PCM_GRAY] = 0; + + myGpioDelay(1000); + + pcmReg[PCM_MODE] = PCM_MODE_FLEN(bits-1); /* # bits in frame */ + + /* enable channel 1 with # bits width */ + + pcmReg[PCM_TXC] = PCM_TXC_CH1EN | PCM_TXC_CH1WID(bits-8); + + pcmReg[PCM_CS] |= PCM_CS_STBY; /* clear standby */ + + myGpioDelay(1000); + + pcmReg[PCM_CS] |= PCM_CS_TXCLR; /* clear TX FIFO */ + + pcmReg[PCM_CS] |= PCM_CS_DMAEN; /* enable DREQ */ + + pcmReg[PCM_DREQ] = PCM_DREQ_TX_PANIC(16) | PCM_DREQ_TX_REQ_L(30); + + pcmReg[PCM_INTSTC] = 0b1111; /* clear status bits */ + + /* enable PCM */ + + pcmReg[PCM_CS] |= PCM_CS_EN; + + /* enable tx */ + + pcmReg[PCM_CS] |= PCM_CS_TXON; + + dmaIVirt[0]->periphData = 0x0F; +} + +/* ----------------------------------------------------------------------- */ + +static void initHWClk + (int clkCtl, int clkDiv, int clkSrc, int divI, int divF, int MASH) +{ + DBG(DBG_INTERNAL, "ctl=%d div=%d src=%d /I=%d /f=%d M=%d", + clkCtl, clkDiv, clkSrc, divI, divF, MASH); + + /* kill the clock if busy, anything else isn't reliable */ + + if (clkReg[clkCtl] & CLK_CTL_BUSY) + { + do + { + clkReg[clkCtl] = BCM_PASSWD | CLK_CTL_KILL; + } + while (clkReg[clkCtl] & CLK_CTL_BUSY); + } + + clkReg[clkDiv] = (BCM_PASSWD | CLK_DIV_DIVI(divI) | CLK_DIV_DIVF(divF)); + + usleep(10); + + clkReg[clkCtl] = (BCM_PASSWD | CLK_CTL_MASH(MASH) | CLK_CTL_SRC(clkSrc)); + + usleep(10); + + clkReg[clkCtl] |= (BCM_PASSWD | CLK_CTL_ENAB); +} + +static void initClock(int mainClock) +{ + const unsigned BITS=10; + int clockPWM; + unsigned clkCtl, clkDiv, clkSrc, clkDivI, clkDivF, clkMash, clkBits; + char *per; + unsigned micros; + + DBG(DBG_STARTUP, "mainClock=%d", mainClock); + + if (mainClock) micros = gpioCfg.clockMicros; + else micros = PI_WF_MICROS; + + clockPWM = mainClock ^ (gpioCfg.clockPeriph == PI_CLOCK_PCM); + + if (clockPWM) + { + clkCtl = CLK_PWMCTL; + clkDiv = CLK_PWMDIV; + per = "PWM"; + } + else + { + clkCtl = CLK_PCMCTL; + clkDiv = CLK_PCMDIV; + per = "PCM"; + } + + clkSrc = CLK_CTL_SRC_PLLD; + clkDivI = clk_plld_freq / (10000000 / micros); /* 10 MHz - 1 MHz */ + clkBits = BITS; /* 10/BITS MHz - 1/BITS MHz */ + clkDivF = 0; + clkMash = 0; + + DBG(DBG_STARTUP, "%s PLLD divi=%d divf=%d mash=%d bits=%d", + per, clkDivI, clkDivF, clkMash, clkBits); + + initHWClk(clkCtl, clkDiv, clkSrc, clkDivI, clkDivF, clkMash); + + if (clockPWM) initPWM(BITS); + else initPCM(BITS); + + myGpioDelay(2000); +} + +static void initKillDMA(volatile uint32_t *dmaAddr) +{ + dmaAddr[DMA_CS] = DMA_CHANNEL_ABORT; + dmaAddr[DMA_CS] = 0; + dmaAddr[DMA_CS] = DMA_CHANNEL_RESET; + + dmaAddr[DMA_CONBLK_AD] = 0; +} + +/* ----------------------------------------------------------------------- */ + +static void initDMAgo(volatile uint32_t *dmaAddr, uint32_t cbAddr) +{ + DBG(DBG_STARTUP, ""); + + initKillDMA(dmaAddr); + + dmaAddr[DMA_CS] = DMA_INTERRUPT_STATUS | DMA_END_FLAG; + + dmaAddr[DMA_CONBLK_AD] = cbAddr; + + /* clear READ/FIFO/READ_LAST_NOT_SET error bits */ + + dmaAddr[DMA_DEBUG] = DMA_DEBUG_READ_ERR | + DMA_DEBUG_FIFO_ERR | + DMA_DEBUG_RD_LST_NOT_SET_ERR; + + + dmaAddr[DMA_CS] = DMA_WAIT_ON_WRITES | + DMA_PANIC_PRIORITY(8) | + DMA_PRIORITY(8) | + DMA_ACTIVE; +} + +/* ----------------------------------------------------------------------- */ + +static void initClearGlobals(void) +{ + int i; + + DBG(DBG_STARTUP, ""); + + alertBits = 0; + monitorBits = 0; + notifyBits = 0; + scriptBits = 0; + gFilterBits = 0; + nFilterBits = 0; + wdogBits = 0; + + pthAlertRunning = PI_THREAD_NONE; + pthFifoRunning = PI_THREAD_NONE; + pthSocketRunning = PI_THREAD_NONE; + + wfc[0] = 0; + wfc[1] = 0; + wfc[2] = 0; + + wfcur=0; + + wfStats.micros = 0; + wfStats.highMicros = 0; + wfStats.maxMicros = PI_WAVE_MAX_MICROS; + + wfStats.pulses = 0; + wfStats.highPulses = 0; + wfStats.maxPulses = PI_WAVE_MAX_PULSES; + + wfStats.cbs = 0; + wfStats.highCbs = 0; + wfStats.maxCbs = (PI_WAVE_BLOCKS * PAGES_PER_BLOCK * CBS_PER_OPAGE); + + gpioGetSamples.func = NULL; + gpioGetSamples.ex = 0; + gpioGetSamples.userdata = NULL; + gpioGetSamples.bits = 0; + + for (i=0; i<=PI_MAX_USER_GPIO; i++) + { + wfRx[i].mode = PI_WFRX_NONE; + pthread_mutex_init(&wfRx[i].mutex, NULL); + gpioAlert[i].func = NULL; + } + + for (i=0; i<=PI_MAX_GPIO; i++) + { + gpioInfo [i].is = GPIO_UNDEFINED; + gpioInfo [i].width = 0; + gpioInfo [i].range = PI_DEFAULT_DUTYCYCLE_RANGE; + gpioInfo [i].freqIdx = DEFAULT_PWM_IDX; + } + + for (i=0; i> 4) & 0xFF; + + /* model + 0=A 1=B + 2=A+ 3=B+ + 4=Pi2B + 5=Alpha + 6=Compute Module + 7=Unknown + 8=Pi3B + 9=Zero + 12=Zero W + 13=Pi3B+ + 14=Pi3A+ + 17=Pi4B + */ + if (model < 2) gpioMask = PI_DEFAULT_UPDATE_MASK_A_B2; + else if (model < 4) gpioMask = PI_DEFAULT_UPDATE_MASK_APLUS_BPLUS; + else if (model == 4) gpioMask = PI_DEFAULT_UPDATE_MASK_PI2B; + + else if (model == 6 + || model ==10 + || model ==16) gpioMask = PI_DEFAULT_UPDATE_MASK_COMPUTE; + + else if (model == 8 + || model ==13 + || model ==14) gpioMask = PI_DEFAULT_UPDATE_MASK_PI3B; + + else if (model == 9 + || model ==12) gpioMask = PI_DEFAULT_UPDATE_MASK_ZERO; + + else if (model ==17) gpioMask = PI_DEFAULT_UPDATE_MASK_PI4B; + else gpioMask = PI_DEFAULT_UPDATE_MASK_UNKNOWN; + } + + gpioMaskSet = 1; + } + +#ifndef EMBEDDED_IN_VM + if (!(gpioCfg.internals & PI_CFG_NOSIGHANDLER)) + sigSetHandler(); +#endif + + if (initPeripherals() < 0) return PI_INIT_FAILED; + + if (initAllocDMAMem() < 0) return PI_INIT_FAILED; + + /* done with /dev/mem */ + + if (fdMem != -1) + { + close(fdMem); + fdMem = -1; + } + + param.sched_priority = sched_get_priority_max(SCHED_FIFO); + + if (gpioCfg.internals & PI_CFG_RT_PRIORITY) + sched_setscheduler(0, SCHED_FIFO, ¶m); + + initClock(1); /* initialise main clock */ + + atexit(gpioTerminate); + + if (pthread_attr_init(&pthAttr)) + SOFT_ERROR(PI_INIT_FAILED, "pthread_attr_init failed (%m)"); + + if (pthread_attr_setstacksize(&pthAttr, STACK_SIZE)) + SOFT_ERROR(PI_INIT_FAILED, "pthread_attr_setstacksize failed (%m)"); + + if (!(gpioCfg.ifFlags & PI_DISABLE_ALERT)) + { + if (pthread_create(&pthAlert, &pthAttr, pthAlertThread, &i)) + SOFT_ERROR(PI_INIT_FAILED, "pthread_create alert failed (%m)"); + + pthAlertRunning = PI_THREAD_STARTED; + } + + if (!(gpioCfg.ifFlags & PI_DISABLE_FIFO_IF)) + { + if (pthread_create(&pthFifo, &pthAttr, pthFifoThread, &i)) + SOFT_ERROR(PI_INIT_FAILED, "pthread_create fifo failed (%m)"); + + pthFifoRunning = PI_THREAD_STARTED; + } + + if (!(gpioCfg.ifFlags & PI_DISABLE_SOCK_IF)) + { + portStr = getenv(PI_ENVPORT); + if (portStr) port = atoi(portStr); else port = gpioCfg.socketPort; + + // Accept connections on IPv6, unless we have an IPv4-only whitelist + if (!numSockNetAddr) + { + fdSock = socket(AF_INET6, SOCK_STREAM , 0); + + if (fdSock != -1) + { + bzero((char *)&server6, sizeof(server6)); + server6.sin6_family = AF_INET6; + if (gpioCfg.ifFlags & PI_LOCALHOST_SOCK_IF) + { + server6.sin6_addr = in6addr_loopback; + } + else + { + server6.sin6_addr = in6addr_any; + } + server6.sin6_port = htons(port); + + int opt = 1; + setsockopt(fdSock, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt)); + if (bind(fdSock,(struct sockaddr *)&server6, sizeof(server6)) < 0) + SOFT_ERROR(PI_INIT_FAILED, "bind to port %d failed (%m)", port); + } + } + + if (numSockNetAddr || fdSock == -1) + { + fdSock = socket(AF_INET , SOCK_STREAM , 0); + + if (fdSock == -1) + SOFT_ERROR(PI_INIT_FAILED, "socket failed (%m)"); + else + { + int opt = 1; + setsockopt(fdSock, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt)); + } + server.sin_family = AF_INET; + if (gpioCfg.ifFlags & PI_LOCALHOST_SOCK_IF) + { + server.sin_addr.s_addr = htonl(INADDR_LOOPBACK); + } + else + { + server.sin_addr.s_addr = htonl(INADDR_ANY); + } + server.sin_port = htons(port); + + if (bind(fdSock,(struct sockaddr *)&server , sizeof(server)) < 0) + SOFT_ERROR(PI_INIT_FAILED, "bind to port %d failed (%m)", port); + } + + if (pthread_create(&pthSocket, &pthAttr, pthSocketThread, &i)) + SOFT_ERROR(PI_INIT_FAILED, "pthread_create socket failed (%m)"); + + pthSocketRunning = PI_THREAD_STARTED; + } + + myGpioDelay(1000); + + dmaInitCbs(); + + flushMemory(); + + //cast twice to suppress compiler warning, I belive this cast + //is ok because dmaIBus contains bus addresses, not virtual + //addresses. + initDMAgo((uint32_t *)dmaIn, (uint32_t)(uintptr_t)dmaIBus[0]); + + return PIGPIO_VERSION; +} + + +/* ======================================================================= */ + +int getBitInBytes(int bitPos, char *buf, int numBits) +{ + int bitp, bufp; + + if (bitPos < numBits) + { + bufp = bitPos / 8; + bitp = 7 - (bitPos % 8); + if (buf[bufp] & (1<= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot(pos, &page, &slot); + return (dmaOVirt[page]->OOL[slot]); + } + + return -1; +} + +/* ----------------------------------------------------------------------- */ + +void rawWaveSetOOL(int pos, uint32_t value) +{ + int page, slot; + + if ((pos >= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot(pos, &page, &slot); + dmaOVirt[page]->OOL[slot] = value; + } +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t rawWaveGetOut(int pos) +{ + int page, slot; + + if ((pos >= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot(pos, &page, &slot); + return (dmaOVirt[page]->OOL[slot]); + } + + return -1; +} + +/* ----------------------------------------------------------------------- */ + +void rawWaveSetOut(int pos, uint32_t value) +{ + int page, slot; + + if ((pos >= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot(pos, &page, &slot); + dmaOVirt[page]->OOL[slot] = value; + } +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t rawWaveGetIn(int pos) +{ + int page, slot; + + if ((pos >= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot((NUM_WAVE_OOL-1)-pos, &page, &slot); + return (dmaOVirt[page]->OOL[slot]); + } + + return -1; +} + +/* ----------------------------------------------------------------------- */ + +void rawWaveSetIn(int pos, uint32_t value) +{ + int page, slot; + + if ((pos >= 0) && (pos < NUM_WAVE_OOL)) + { + waveOOLPageSlot((NUM_WAVE_OOL-1)-pos, &page, &slot); + dmaOVirt[page]->OOL[slot] = value; + } +} + +/* ----------------------------------------------------------------------- */ + +rawWaveInfo_t rawWaveInfo(int wave_id) +{ + rawWaveInfo_t dummy = {0, 0, 0, 0, 0, 0, 0, 0}; + + if ((wave_id >=0) && (wave_id < PI_MAX_WAVES)) return waveInfo[wave_id]; + else return dummy; +} + +/* ----------------------------------------------------------------------- */ + +double time_time(void) +{ + struct timeval tv; + double t; + + gettimeofday(&tv, 0); + + t = (double)tv.tv_sec + ((double)tv.tv_usec / 1E6); + + return t; +} + +/* ----------------------------------------------------------------------- */ + +void time_sleep(double seconds) +{ + struct timespec ts, rem; + + if (seconds > 0.0) + { + ts.tv_sec = seconds; + ts.tv_nsec = (seconds-(double)ts.tv_sec) * 1E9; + + while (clock_nanosleep(CLOCK_REALTIME, 0, &ts, &rem)) + { + /* copy remaining time to ts */ + ts.tv_sec = rem.tv_sec; + ts.tv_nsec = rem.tv_nsec; + } + } +} + +/* ----------------------------------------------------------------------- */ + +void rawDumpWave(void) +{ + int i; + + unsigned numWaves, t; + + rawWave_t *waves; + + numWaves = wfc[wfcur]; + waves = wf [wfcur]; + + t = 0; + + for (i=0; i= PI_MAX_SCRIPTS) return; + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + + for (i=0; i> 4) & 3; + + if (pwm == 0) pwmReg[PWM_CTL] &= (~PWM_CTL_PWEN1); + else pwmReg[PWM_CTL] &= (~PWM_CTL_PWEN2); + + gpioInfo[i].width = 0; + gpioInfo[i].is = GPIO_UNDEFINED; + } + } +} + +/* ----------------------------------------------------------------------- */ + +int gpioSetMode(unsigned gpio, unsigned mode) +{ + int reg, shift, old_mode; + + DBG(DBG_USER, "gpio=%d mode=%d", gpio, mode); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (mode > PI_ALT3) + SOFT_ERROR(PI_BAD_MODE, "gpio %d, bad mode (%d)", gpio, mode); + + reg = gpio/10; + shift = (gpio%10) * 3; + + old_mode = (gpioReg[reg] >> shift) & 7; + + if (mode != old_mode) + { + switchFunctionOff(gpio); + + gpioInfo[gpio].is = GPIO_UNDEFINED; + } + + gpioReg[reg] = (gpioReg[reg] & ~(7< PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + reg = gpio/10; + shift = (gpio%10) * 3; + + return (gpioReg[reg] >> shift) & 7; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetPullUpDown(unsigned gpio, unsigned pud) +{ + int shift = (gpio & 0xf) << 1; + uint32_t bits; + uint32_t pull; + + DBG(DBG_USER, "gpio=%d pud=%d", gpio, pud); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (pud > PI_PUD_UP) + SOFT_ERROR(PI_BAD_PUD, "gpio %d, bad pud (%d)", gpio, pud); + + if (pi_is_2711) + { + switch (pud) + { + case PI_PUD_OFF: pull = 0; break; + case PI_PUD_UP: pull = 1; break; + case PI_PUD_DOWN: pull = 2; break; + } + + bits = *(gpioReg + GPPUPPDN0 + (gpio>>4)); + bits &= ~(3 << shift); + bits |= (pull << shift); + *(gpioReg + GPPUPPDN0 + (gpio>>4)) = bits; + } + else + { + *(gpioReg + GPPUD) = pud; + + myGpioDelay(1); + + *(gpioReg + GPPUDCLK0 + BANK) = BIT; + + myGpioDelay(1); + + *(gpioReg + GPPUD) = 0; + + *(gpioReg + GPPUDCLK0 + BANK) = 0; + } + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioRead(unsigned gpio) +{ + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if ((*(gpioReg + GPLEV0 + BANK) & BIT) != 0) return PI_ON; + else return PI_OFF; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWrite(unsigned gpio, unsigned level) +{ + DBG(DBG_USER, "gpio=%d level=%d", gpio, level); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (level > PI_ON) + SOFT_ERROR(PI_BAD_LEVEL, "gpio %d, bad level (%d)", gpio, level); + + if (gpio <= PI_MAX_GPIO) + { + if (gpioInfo[gpio].is != GPIO_WRITE) + { + /* stop a glitch between setting mode then level */ + if (level == PI_OFF) *(gpioReg + GPCLR0 + BANK) = BIT; + else *(gpioReg + GPSET0 + BANK) = BIT; + + switchFunctionOff(gpio); + + gpioInfo[gpio].is = GPIO_WRITE; + } + } + + myGpioSetMode(gpio, PI_OUTPUT); + + if (level == PI_OFF) *(gpioReg + GPCLR0 + BANK) = BIT; + else *(gpioReg + GPSET0 + BANK) = BIT; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioPWM(unsigned gpio, unsigned val) +{ + DBG(DBG_USER, "gpio=%d dutycycle=%d", gpio, val); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (val > gpioInfo[gpio].range) + SOFT_ERROR(PI_BAD_DUTYCYCLE, "gpio %d, bad dutycycle (%d)", gpio, val); + + if (gpioInfo[gpio].is != GPIO_PWM) + { + switchFunctionOff(gpio); + + gpioInfo[gpio].is = GPIO_PWM; + + if (!val) myGpioWrite(gpio, 0); + } + + myGpioSetMode(gpio, PI_OUTPUT); + + myGpioSetPwm(gpio, gpioInfo[gpio].width, val); + + gpioInfo[gpio].width=val; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioGetPWMdutycycle(unsigned gpio) +{ + unsigned pwm; + + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + switch (gpioInfo[gpio].is) + { + case GPIO_PWM: + return gpioInfo[gpio].width; + + case GPIO_HW_PWM: + pwm = (PWMDef[gpio] >> 4) & 3; + return hw_pwm_duty[pwm]; + + case GPIO_HW_CLK: + return PI_HW_PWM_RANGE/2; + + default: + SOFT_ERROR(PI_NOT_PWM_GPIO, "not a PWM gpio (%d)", gpio); + } +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetPWMrange(unsigned gpio, unsigned range) +{ + int oldWidth, newWidth; + + DBG(DBG_USER, "gpio=%d range=%d", gpio, range); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if ((range < PI_MIN_DUTYCYCLE_RANGE) || (range > PI_MAX_DUTYCYCLE_RANGE)) + SOFT_ERROR(PI_BAD_DUTYRANGE, "gpio %d, bad range (%d)", gpio, range); + + oldWidth = gpioInfo[gpio].width; + + if (oldWidth) + { + if (gpioInfo[gpio].is == GPIO_PWM) + { + newWidth = (range * oldWidth) / gpioInfo[gpio].range; + + myGpioSetPwm(gpio, oldWidth, 0); + gpioInfo[gpio].range = range; + gpioInfo[gpio].width = newWidth; + myGpioSetPwm(gpio, 0, newWidth); + } + } + + gpioInfo[gpio].range = range; + + /* return the actual range for the current gpio frequency */ + + return pwmRealRange[gpioInfo[gpio].freqIdx]; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioGetPWMrange(unsigned gpio) +{ + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + switch (gpioInfo[gpio].is) + { + case GPIO_HW_PWM: + case GPIO_HW_CLK: + return PI_HW_PWM_RANGE; + + default: + return gpioInfo[gpio].range; + } +} + + +/* ----------------------------------------------------------------------- */ + +int gpioGetPWMrealRange(unsigned gpio) +{ + unsigned pwm; + + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + switch (gpioInfo[gpio].is) + { + case GPIO_HW_PWM: + pwm = (PWMDef[gpio] >> 4) & 3; + return hw_pwm_real_range[pwm]; + + case GPIO_HW_CLK: + return PI_HW_PWM_RANGE; + + default: + return pwmRealRange[gpioInfo[gpio].freqIdx]; + } +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetPWMfrequency(unsigned gpio, unsigned frequency) +{ + int i, width; + unsigned diff, best, idx; + + DBG(DBG_USER, "gpio=%d frequency=%d", gpio, frequency); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (frequency > pwmFreq[0]) idx = 0; + else if (frequency < pwmFreq[PWM_FREQS-1]) idx = PWM_FREQS-1; + else + { + best = 100000; /* impossibly high frequency difference */ + idx = 0; + + for (i=0; i pwmFreq[i]) diff = frequency - pwmFreq[i]; + else diff = pwmFreq[i] - frequency; + + if (diff < best) + { + best = diff; + idx = i; + } + } + } + + width = gpioInfo[gpio].width; + + if (width) + { + if (gpioInfo[gpio].is == GPIO_PWM) + { + myGpioSetPwm(gpio, width, 0); + gpioInfo[gpio].freqIdx = idx; + myGpioSetPwm(gpio, 0, width); + } + } + + gpioInfo[gpio].freqIdx = idx; + + return pwmFreq[idx]; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioGetPWMfrequency(unsigned gpio) +{ + unsigned pwm, clock; + + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + switch (gpioInfo[gpio].is) + { + case GPIO_HW_PWM: + pwm = (PWMDef[gpio] >> 4) & 3; + return hw_pwm_freq[pwm]; + + case GPIO_HW_CLK: + clock = (clkDef[gpio] >> 4) & 3; + return hw_clk_freq[clock]; + + default: + return pwmFreq[gpioInfo[gpio].freqIdx]; + } +} + + +/* ----------------------------------------------------------------------- */ + +int gpioServo(unsigned gpio, unsigned val) +{ + DBG(DBG_USER, "gpio=%d pulsewidth=%d", gpio, val); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if ((val!=PI_SERVO_OFF) && (valPI_MAX_SERVO_PULSEWIDTH) + SOFT_ERROR(PI_BAD_PULSEWIDTH, + "gpio %d, bad pulsewidth (%d)", gpio, val); + + if (gpioInfo[gpio].is != GPIO_SERVO) + { + switchFunctionOff(gpio); + + gpioInfo[gpio].is = GPIO_SERVO; + + if (!val) myGpioWrite(gpio, 0); + } + + myGpioSetMode(gpio, PI_OUTPUT); + + myGpioSetServo(gpio, gpioInfo[gpio].width, val); + + gpioInfo[gpio].width=val; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioGetServoPulsewidth(unsigned gpio) +{ + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (gpioInfo[gpio].is != GPIO_SERVO) + SOFT_ERROR(PI_NOT_SERVO_GPIO, "not a servo gpio (%d)", gpio); + + return gpioInfo[gpio].width; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWaveClear(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + wfc[0] = 0; + wfc[1] = 0; + wfc[2] = 0; + + wfcur = 0; + + wfStats.micros = 0; + wfStats.pulses = 0; + wfStats.cbs = 0; + + waveOutBotCB = PI_WAVE_COUNT_PAGES*CBS_PER_OPAGE; + waveOutBotOOL = PI_WAVE_COUNT_PAGES*OOL_PER_OPAGE; + waveOutTopOOL = NUM_WAVE_OOL; + + waveOutCount = 0; + + waveEndPtr = NULL; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveAddNew(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + wfc[0] = 0; + wfc[1] = 0; + wfc[2] = 0; + + wfcur = 0; + + wfStats.micros = 0; + wfStats.pulses = 0; + wfStats.cbs = 0; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveAddGeneric(unsigned numPulses, gpioPulse_t *pulses) +{ + int p; + + DBG(DBG_USER, "numPulses=%u pulses=%08"PRIXPTR, numPulses, (uintptr_t)pulses); + + CHECK_INITED; + + if (numPulses > PI_WAVE_MAX_PULSES) + SOFT_ERROR(PI_TOO_MANY_PULSES, "bad number of pulses (%d)", numPulses); + + if (!pulses) SOFT_ERROR(PI_BAD_POINTER, "bad (NULL) pulses pointer"); + + for (p=0; p PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if ((baud < PI_WAVE_MIN_BAUD) || (baud > PI_WAVE_MAX_BAUD)) + SOFT_ERROR(PI_BAD_WAVE_BAUD, "bad baud rate (%d)", baud); + + if ((data_bits < PI_MIN_WAVE_DATABITS) || + (data_bits > PI_MAX_WAVE_DATABITS)) + SOFT_ERROR(PI_BAD_DATABITS, "bad number of databits (%d)", data_bits); + + if ((stop_bits < PI_MIN_WAVE_HALFSTOPBITS) || + (stop_bits > PI_MAX_WAVE_HALFSTOPBITS)) + SOFT_ERROR(PI_BAD_STOPBITS, + "bad number of (half) stop bits (%d)", stop_bits); + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (numBytes > PI_WAVE_MAX_CHARS) + SOFT_ERROR(PI_TOO_MANY_CHARS, "too many chars (%d)", numBytes); + + if (offset > PI_WAVE_MAX_MICROS) + SOFT_ERROR(PI_BAD_SER_OFFSET, "offset too large (%d)", offset); + + if (data_bits > 8) numBytes /= 2; + if (data_bits > 16) numBytes /= 2; + + if (!numBytes) return 0; + + waveBitDelay(baud, data_bits, stop_bits, bitDelay); + + p = 0; + + wf[2][p].gpioOn = (1< bitDelay[0]) wf[2][p].usDelay = offset; + else wf[2][p].usDelay = bitDelay[0]; + + for (i=0; i PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", spiSS); + + /* + CPOL CPHA + 0 0 read rising/write falling + 0 1 read falling/write rising + 1 0 read falling/write rising + 1 1 read rising/write falling + */ + + if (spi->clk_pol) {rising_edge[0] = 0; rising_edge[1] = 1;} + else {rising_edge[0] = 1; rising_edge[1] = 0;} + + if (spi->clk_pha) {read_cycle[0] = 0; read_cycle[1] = 1;} + else {read_cycle[0] = 1; read_cycle[1] = 0;} + + p = 0; + + if (offset) + { + wf[2][p].gpioOn = 0; + wf[2][p].gpioOff = 0; + wf[2][p].flags = 0; + wf[2][p].usDelay = offset; + p++; + } + + on_bits = 0; + off_bits = 0; + + tx_bit_pos = 0; + + /* preset initial mosi bit */ + + if (getBitInBytes(tx_bit_pos, buf, spiTxBits)) + { + on_bits |= (1<<(spi->mosi)); + dbv = 1; + } + else + { + off_bits |= (1<<(spi->mosi)); + dbv = 0; + } + + if (!spi->clk_pha) tx_bit_pos ++; + + if (spi->ss_pol) off_bits |= (1<clk_pol) on_bits |= (1<<(spi->clk)); + else off_bits |= (1<<(spi->clk)); + + wf[2][p].gpioOn = on_bits; + wf[2][p].gpioOff = off_bits; + wf[2][p].flags = 0; + + if (spi->clk_us > spi->ss_us) wf[2][p].usDelay = spi->clk_us; + else wf[2][p].usDelay = spi->ss_us; + + p++; + + for (bit=1; bit<=spiBits; bit++) + { + for (halfbit=0; halfbit<2; halfbit++) + { + wf[2][p].usDelay = spi->clk_us; + wf[2][p].flags = 0; + + on_bits = 0; + off_bits = 0; + + if (read_cycle[halfbit]) + { + if ((bit>=spiBitFirst) && (bit<=spiBitLast)) + wf[2][p].flags = WAVE_FLAG_READ; + } + else + { + if (getBitInBytes(tx_bit_pos, buf, spiTxBits)) + { + if (!dbv) on_bits |= (1<<(spi->mosi)); + dbv = 1; + } + else + { + if (dbv) off_bits |= (1<<(spi->mosi)); + dbv = 0; + } + + ++tx_bit_pos; + } + + if (rising_edge[halfbit]) on_bits |= (1<<(spi->clk)); + else off_bits |= (1<<(spi->clk)); + + wf[2][p].gpioOn = on_bits; + wf[2][p].gpioOff = off_bits; + + p++; + } + } + + on_bits = 0; + off_bits = 0; + + if (spi->ss_pol) on_bits |= (1< NUM_WAVE_CBS) + return PI_TOO_MANY_CBS; + + if ((numBOOL+waveOutBotOOL) > (waveOutTopOOL-numTOOL)) + return PI_TOO_MANY_OOL; + + if (wid >= PI_MAX_WAVES) + return PI_NO_WAVEFORM_ID; + + wid = waveOutCount++; + + waveInfo[wid].botCB = waveOutBotCB; + waveInfo[wid].topCB = waveOutBotCB + numCB -1; + waveInfo[wid].botOOL = waveOutBotOOL; + waveInfo[wid].topOOL = waveOutTopOOL; + waveInfo[wid].numCB = numCB; + waveInfo[wid].numBOOL = numBOOL; + waveInfo[wid].numTOOL = numTOOL; + + waveOutBotCB += numCB; + waveOutBotOOL += numBOOL; + waveOutTopOOL -= numTOOL; + } + + /* Must be room if got this far. */ + + CB = waveInfo[wid].botCB; + BOOL = waveInfo[wid].botOOL; + TOOL = waveInfo[wid].topOOL; + + wave2Cbs(PI_WAVE_MODE_ONE_SHOT, &CB, &BOOL, &TOOL, 0, 0, 0); + + /* Sanity check. */ + + if ( (numCB != (CB-waveInfo[wid].botCB)) || + (numBOOL != (BOOL-waveInfo[wid].botOOL)) || + (numTOOL != (waveInfo[wid].topOOL-TOOL)) ) + { + DBG(DBG_ALWAYS, "ERROR wid=%d CBs %d=%d BOOL %d=%d TOOL %d=%d", wid, + numCB, CB-waveInfo[wid].botCB, + numBOOL, BOOL-waveInfo[wid].botOOL, + numTOOL, waveInfo[wid].topOOL-TOOL); + } + + DBG(DBG_USER, "Wave Stats: wid=%d CBs %d BOOL %d TOOL %d", wid, + numCB, numBOOL, numTOOL); + + waveInfo[wid].deleted = 0; + + /* Consume waves. */ + + wfc[0] = 0; + wfc[1] = 0; + wfc[2] = 0; + + wfcur = 0; + + return wid; +} + +int gpioWaveCreatePad(int pctCB, int pctBOOL, int pctTOOL) +{ + int i, wid; + int numCB, numBOOL, numTOOL; + int CB, BOOL, TOOL; + + DBG(DBG_USER, "%d, %d, %d", pctCB, pctBOOL, pctTOOL); + + CHECK_INITED; + + if (pctCB < 0 || pctCB > 100) + SOFT_ERROR(PI_BAD_PARAM, "bad wave param, pctCB=(%d)", pctCB); + if (pctBOOL < 0 || pctBOOL > 100) + SOFT_ERROR(PI_BAD_PARAM, "bad wave param, pctBOOL=(%d)", pctBOOL); + if (pctTOOL < 0 || pctTOOL > 100) + SOFT_ERROR(PI_BAD_PARAM, "bad wave param, pctTOOL=(%d)", pctTOOL); + + if (wfc[wfcur] == 0) return PI_EMPTY_WAVEFORM; + + /* What resources are needed? */ + waveCBsOOLs(&numCB, &numBOOL, &numTOOL); + + /* Amount of pad required */ + CB = (NUM_WAVE_CBS - PI_WAVE_COUNT_PAGES*CBS_PER_OPAGE) * pctCB / 100; + BOOL = (NUM_WAVE_OOL - PI_WAVE_COUNT_PAGES*OOL_PER_OPAGE) * pctBOOL /100; + TOOL = (NUM_WAVE_OOL - PI_WAVE_COUNT_PAGES*OOL_PER_OPAGE) * pctTOOL /100; + + /* Reject if wave is too big */ + if (numCB > CB) return PI_TOO_MANY_CBS; + if (numBOOL > BOOL) return PI_TOO_MANY_OOL; + if (numTOOL > TOOL) return PI_TOO_MANY_OOL; + + /* Set the padding */ + numCB = CB; + numBOOL = BOOL; + numTOOL = TOOL; + + + wid = -1; + + /* Is there an exact fit with a deleted wave. */ + + for (i=0; i NUM_WAVE_CBS) + return PI_TOO_MANY_CBS; + + if ((numBOOL+waveOutBotOOL) > (waveOutTopOOL-numTOOL)) + return PI_TOO_MANY_OOL; + + if (wid >= PI_MAX_WAVES) + return PI_NO_WAVEFORM_ID; + + wid = waveOutCount++; + + waveInfo[wid].botCB = waveOutBotCB; + waveInfo[wid].topCB = waveOutBotCB + numCB -1; + waveInfo[wid].botOOL = waveOutBotOOL; + waveInfo[wid].topOOL = waveOutTopOOL; + waveInfo[wid].numCB = numCB; + waveInfo[wid].numBOOL = numBOOL; + waveInfo[wid].numTOOL = numTOOL; + + waveOutBotCB += numCB; + waveOutBotOOL += numBOOL; + waveOutTopOOL -= numTOOL; + } + + /* Must be room if got this far. */ + + CB = waveInfo[wid].botCB; + BOOL = waveInfo[wid].botOOL; + TOOL = waveInfo[wid].topOOL; + + wave2Cbs(PI_WAVE_MODE_ONE_SHOT, &CB, &BOOL, &TOOL, numCB, numBOOL, numTOOL); + + /* Sanity check. */ + + if ( (numCB != (CB-waveInfo[wid].botCB)) || + (numBOOL != (BOOL-waveInfo[wid].botOOL)) || + (numTOOL != (waveInfo[wid].topOOL-TOOL)) ) + { + DBG(DBG_ALWAYS, "ERROR wid=%d CBs %d=%d BOOL %d=%d TOOL %d=%d", wid, + numCB, CB-waveInfo[wid].botCB, + numBOOL, BOOL-waveInfo[wid].botOOL, + numTOOL, waveInfo[wid].topOOL-TOOL); + } + + DBG(DBG_USER, "Wave padding: wid=%d CBs %d BOOL %d TOOL %d", wid, + numCB, numBOOL, numTOOL); + + waveInfo[wid].deleted = 0; + + /* Consume waves. */ + + wfc[0] = 0; + wfc[1] = 0; + wfc[2] = 0; + + wfcur = 0; + + return wid; +} +/* ----------------------------------------------------------------------- */ + +int gpioWaveDelete(unsigned wave_id) +{ + DBG(DBG_USER, "wave id=%d", wave_id); + + CHECK_INITED; + + if ((wave_id >= waveOutCount) || waveInfo[wave_id].deleted) + SOFT_ERROR(PI_BAD_WAVE_ID, "bad wave id (%d)", wave_id); + + waveInfo[wave_id].deleted = 1; + + if (wave_id == (waveOutCount-1)) + { + /* top wave deleted, garbage collect any other deleted waves */ + + while ((wave_id > 0) && (waveInfo[wave_id-1].deleted)) --wave_id; + + waveOutBotCB = waveInfo[wave_id].botCB; + waveOutBotOOL = waveInfo[wave_id].botOOL; + waveOutTopOOL = waveInfo[wave_id].topOOL; + + waveOutCount = wave_id; + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveTxStart(unsigned wave_mode) +{ + /* This function is deprecated and has been removed. */ + + CHECK_INITED; + + SOFT_ERROR(PI_DEPRECATED, "deprected function removed"); +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveTxSend(unsigned wave_id, unsigned wave_mode) +{ + rawCbs_t *p=NULL; + + DBG(DBG_USER, "wave_id=%d wave_mode=%d", wave_id, wave_mode); + + CHECK_INITED; + + if ((wave_id >= waveOutCount) || waveInfo[wave_id].deleted) + SOFT_ERROR(PI_BAD_WAVE_ID, "bad wave id (%d)", wave_id); + + if (wave_mode > PI_WAVE_MODE_REPEAT_SYNC) + SOFT_ERROR(PI_BAD_WAVE_MODE, "bad wave mode (%d)", wave_mode); + + if (!waveClockInited) + { + stopHardwarePWM(); + initClock(0); /* initialise secondary clock */ + waveClockInited = 1; + PWMClockInited = 0; + } + + if (wave_mode < PI_WAVE_MODE_ONE_SHOT_SYNC) initKillDMA(dmaOut); + + p = rawWaveCBAdr(waveInfo[wave_id].topCB); + + if ((wave_mode & 1) == PI_WAVE_MODE_ONE_SHOT) + p->next = 0; + else + p->next = waveCbPOadr(waveInfo[wave_id].botCB+1); + + if (waveEndPtr && (wave_mode > PI_WAVE_MODE_REPEAT)) + { + *waveEndPtr = waveCbPOadr(waveInfo[wave_id].botCB+1); + + if (!dmaOut[DMA_CONBLK_AD]) + { + initDMAgo((uint32_t *)dmaOut, waveCbPOadr(waveInfo[wave_id].botCB)); + } + } + else + { + initDMAgo((uint32_t *)dmaOut, waveCbPOadr(waveInfo[wave_id].botCB)); + } + + waveEndPtr = &p->next; + + /* for compatability with the deprecated gpioWaveTxStart return the + number of cbs + */ + return (waveInfo[wave_id].topCB - waveInfo[wave_id].botCB) + 1; +} + + +/* ----------------------------------------------------------------------- */ + +static int chainGetCB(int n) +{ + int block, index; + + if (n < (WCB_CHAIN_CBS * PI_WAVE_COUNT_PAGES)) + { + block = n / WCB_CHAIN_CBS; + index = n % WCB_CHAIN_CBS; + return (block*CBS_PER_OPAGE) + WCB_COUNTER_CBS + index; + } + return -1; +} + +static void chainSetVal(int n, uint32_t val) +{ + int block, index; + uint32_t *p; + + if (n < (WCB_CHAIN_OOL * PI_WAVE_COUNT_PAGES)) + { + block = n / WCB_CHAIN_OOL; + index = n % WCB_CHAIN_OOL; + p = (uint32_t *) dmaOVirt[block] + (WCB_COUNTER_CBS+WCB_CHAIN_CBS) * 8; + p[index] = val; + } +} + +static uint32_t chainGetValPadr(int n) +{ + int block, index; + uint32_t *p; + + if (n < (WCB_CHAIN_OOL * PI_WAVE_COUNT_PAGES)) + { + block = n / WCB_CHAIN_OOL; + index = n % WCB_CHAIN_OOL; + p = (uint32_t *) dmaOBus[block] + (WCB_COUNTER_CBS+WCB_CHAIN_CBS) * 8; + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. + return (uint32_t)(uintptr_t) (p + index); + } + return 0; +} + +static uint32_t chainGetCntVal(int counter, int slot) +{ + uint32_t *p; + int page, offset; + page = counter / 2; + offset = (counter % 2 ? WCB_COUNTER_OOL : 0); + p = (uint32_t *) dmaOVirt[page] + (WCB_COUNTER_CBS+WCB_CHAIN_CBS) * 8; + return p[WCB_CHAIN_OOL+ offset + slot]; +} + +static void chainSetCntVal(int counter, int slot, uint32_t value) +{ + uint32_t *p; + int page, offset; + page = counter / 2; + offset = (counter % 2 ? WCB_COUNTER_OOL : 0); + p = (uint32_t *) dmaOVirt[page] + (WCB_COUNTER_CBS+WCB_CHAIN_CBS) * 8; + p[WCB_CHAIN_OOL + offset + slot] = value; +} + +static uint32_t chainGetCntValPadr(int counter, int slot) +{ + uint32_t *p; + int page, offset; + page = counter / 2; + offset = (counter % 2 ? WCB_COUNTER_OOL : 0); + p = (uint32_t *) dmaOBus[page] + (WCB_COUNTER_CBS+WCB_CHAIN_CBS) * 8; + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + return (uint32_t)(uintptr_t)(p + WCB_CHAIN_OOL + offset + slot); +} + +static int chainGetCntCB(int counter) +{ + int page, offset; + page = counter / 2; + offset = (counter % 2 ? WCB_CNT_CBS : 0); + return ((page * CBS_PER_OPAGE) + offset); +} + +static void chainMakeCounter( + unsigned counter, + unsigned blklen, + unsigned blocks, + unsigned count, + uint32_t repeat, + uint32_t next) +{ + rawCbs_t *p=NULL; + + int b, baseCB, dig; + uint32_t nxt; + + int botCB; + + botCB = chainGetCntCB(counter); + + baseCB = botCB; + + /* set up all the OOLs */ + for (b=0; b < (blocks*(blklen+1)); b++) chainSetCntVal(counter, b, repeat); + + for (b=0; binfo = NORMAL_DMA; + + p->src = chainGetCntValPadr(counter, b*(blklen+1)); + p->dst = (waveCbPOadr(botCB+1) + 20); + + p->length = 4; + p->next = waveCbPOadr(botCB); + + /* copy BOTTOM to TOP */ + + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA; + + p->src = chainGetCntValPadr(counter, b*(blklen+1)); + p->dst = chainGetCntValPadr(counter, (b*(blklen+1))+blklen); + + p->length = 4; + p->next = waveCbPOadr(botCB); + + /* shift all down one */ + + p = rawWaveCBAdr(botCB++); + + p->info = NORMAL_DMA|DMA_SRC_INC|DMA_DEST_INC; + + p->src = chainGetCntValPadr(counter, ((b*(blklen+1))+1)); + p->dst = chainGetCntValPadr(counter, ((b*(blklen+1))+0)); + + p->length = blklen*4; + p->next = repeat; + } + + /* reset the counter */ + + p = rawWaveCBAdr(botCB); + + p->info = NORMAL_DMA|DMA_SRC_INC|DMA_DEST_INC; + + p->src = chainGetCntValPadr(counter, blocks*(blklen+1)); + p->dst = chainGetCntValPadr(counter, 0); + + p->length = blocks*(blklen+1)*4; + p->next = next; + + b = 0; + + while (count && (binfo = NORMAL_DMA | TIMED_DMA(2); + p->dst = PCM_TIMER; + } + else + { + p->info = NORMAL_DMA | TIMED_DMA(5); + p->dst = PWM_TIMER; + } + + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->length = BPD * 20 / PI_WF_MICROS; /* 20 micros delay */ + p->next = waveCbPOadr(chainGetCB(cb)); + + counters = 0; + wid = -1; + + i = 0; + + while (i bufSize) + SOFT_ERROR(PI_BAD_CHAIN_CMD, + "incomplete chain command (at %d)", i); + + cmd = buf[i+1]; + + if (cmd == 0) /* loop begin */ + { + if (stk_lev >= (sizeof(stk_pos)/sizeof(int))) + SOFT_ERROR(PI_CHAIN_NESTING, + "chain counters nested too deep (at %d)", i); + + stk_pos[stk_lev++] = cb; + + i += 2; + } + else if (cmd == 1) /* loop end */ + { + if (counters >= WCB_COUNTERS) + SOFT_ERROR(PI_CHAIN_COUNTER, + "too many chain counters (at %d)", i); + + if ((i+4) > bufSize) + SOFT_ERROR(PI_BAD_CHAIN_CMD, + "incomplete chain command (at %d)", i); + + loop = 0; + if (--stk_lev >= 0) loop = stk_pos[stk_lev]; + + if ((loop < 1) || (loop == cb)) + SOFT_ERROR(PI_BAD_CHAIN_LOOP, + "empty chain loop (at %d)", i); + + cycles = ((unsigned)buf[i+3] << 8) + (unsigned)buf[i+2]; + + i += 4; + + if (cycles > PI_MAX_WAVE_CYCLES) + SOFT_ERROR(PI_CHAIN_LOOP_CNT, + "bad chain loop count (%d)", cycles); + + if (cycles == 0) + { + /* Skip the complete loop block. Change + the next pointing to the start of the + loop block to the current cb. + */ + p = rawWaveCBAdr(chainGetCB(loop)); + p->next = waveCbPOadr(chainGetCB(cb)); + } + else if (cycles == 1) + { + /* Nothing to do, no need for a counter. */ + } + else + { + chaincb = chainGetCB(cb++); + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + p = rawWaveCBAdr(chaincb); + + repeat = waveCbPOadr(chainGetCB(loop)); + + /* Need to check next cb as well. */ + + chaincb = chainGetCB(cb); + + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + next = waveCbPOadr(chainGetCB(cb)); + + /* dummy src and dest */ + p->info = NORMAL_DMA; + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->dst = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->length = 4; + p->next = waveCbPOadr(chainGetCntCB(counters)); + + chainMakeCounter(counters, blklen, blocks, + cycles-1, repeat, next); + + counters++; + } + } + else if (cmd == 2) /* delay us */ + { + if ((i+4) > bufSize) + SOFT_ERROR(PI_BAD_CHAIN_CMD, + "incomplete chain command (at %d)", i); + + cycles = ((unsigned)buf[i+3] << 8) + (unsigned)buf[i+2]; + + i += 4; + + if (cycles > PI_MAX_WAVE_DELAY) + SOFT_ERROR(PI_BAD_CHAIN_DELAY, + "bad chain delay micros (%d)", cycles); + + if (cycles) + { + delayLeft = cycles; + delayCBs = waveDelayCBs(delayLeft); + for (dcb=0; dcbinfo = NORMAL_DMA | TIMED_DMA(2); + p->dst = PCM_TIMER; + } + else + { + p->info = NORMAL_DMA | TIMED_DMA(5); + p->dst = PWM_TIMER; + } + + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + + p->length = BPD * delayLeft / PI_WF_MICROS; + + if ((gpioCfg.DMAsecondaryChannel >= DMA_LITE_FIRST) && + (p->length > DMA_LITE_MAX)) + { + p->length = DMA_LITE_MAX; + } + + delayLeft -= (p->length / BPD); + + p->next = waveCbPOadr(chainGetCB(cb)); + } + } + } + else if (cmd == 3) /* repeat loop forever */ + { + i += 2; + + loop = 0; + if (--stk_lev >= 0) loop = stk_pos[stk_lev]; + + if ((loop < 1) || (loop == cb)) + SOFT_ERROR(PI_BAD_CHAIN_LOOP, + "empty chain loop (at %d)", i); + + chaincb = chainGetCB(cb++); + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + if (i < bufSize) + SOFT_ERROR(PI_BAD_FOREVER, + "loop forever must be last command"); + + p = rawWaveCBAdr(chaincb); + + /* dummy src and dest */ + p->info = NORMAL_DMA; + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->dst = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->length = 4; + p->next = waveCbPOadr(chainGetCB(loop)); + endPtr = &p->next; + } + else + SOFT_ERROR(PI_BAD_CHAIN_CMD, + "unknown chain command (255 %d)", cmd); + } + else if ((wid >= waveOutCount) || waveInfo[wid].deleted) + SOFT_ERROR(PI_BAD_WAVE_ID, "undefined wave (%d)", wid); + else + { + chaincb = chainGetCB(cb++); + + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + p = rawWaveCBAdr(chaincb); + + chaincb = chainGetCB(cb); + + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + chainSetVal(cb-1, waveCbPOadr(chaincb)); + + /* patch next of wid topCB to next cb */ + + p->info = NORMAL_DMA; + p->src = chainGetValPadr(cb-1); /* this next */ + p->dst = waveCbPOadr(waveInfo[wid].topCB) + 20; /* wid next */ + p->length = 4; + p->next = waveCbPOadr(waveInfo[wid].botCB+1); + + i += 1; + } + } + + chaincb = chainGetCB(cb++); + + if (chaincb < 0) + SOFT_ERROR(PI_CHAIN_TOO_BIG, "chain is too long (%d)", cb); + + p = rawWaveCBAdr(chaincb); + + p->info = NORMAL_DMA; + + //cast twice to suppress warning, I belive this is ok as dmaOBus + //contains bus addresses not virtual addresses. --plugwash + p->src = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->dst = (uint32_t)(uintptr_t) (&dmaOBus[0]->periphData); + p->length = 4; + p->next = 0; + + if (!endPtr) endPtr = &p->next; + + initDMAgo((uint32_t *)dmaOut, waveCbPOadr(chainGetCB(0))); + + waveEndPtr = endPtr; + + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int gpioWaveTxBusy(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + if (dmaOut[DMA_CONBLK_AD]) + return 1; + else + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int gpioWaveTxAt(void) +{ + int i, cb; + + DBG(DBG_USER, ""); + + CHECK_INITED; + + cb = dmaNowAtOCB(); + + if (cb < 0) return -cb; + + for (i=0; i= waveInfo[i].botCB) && + (cb <= waveInfo[i].topCB) ) return i; + } + + return PI_WAVE_NOT_FOUND; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveTxStop(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + initKillDMA(dmaOut); + + waveEndPtr = NULL; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetMicros(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.micros; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetHighMicros(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.highMicros; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetMaxMicros(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.maxMicros; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetPulses(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.pulses; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetHighPulses(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.highPulses; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetMaxPulses(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.maxPulses; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetCbs(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.cbs; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetHighCbs(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.highCbs; +} + +/* ----------------------------------------------------------------------- */ + +int gpioWaveGetMaxCbs(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return wfStats.maxCbs; +} + +/* ----------------------------------------------------------------------- */ + +static int read_SDA(wfRx_t *w) +{ + myGpioSetMode(w->I.SDA, PI_INPUT); + return myGpioRead(w->I.SDA); +} + +static void set_SDA(wfRx_t *w) +{ + myGpioSetMode(w->I.SDA, PI_INPUT); +} + +static void clear_SDA(wfRx_t *w) +{ + myGpioSetMode(w->I.SDA, PI_OUTPUT); + myGpioWrite(w->I.SDA, 0); +} + +static void clear_SCL(wfRx_t *w) +{ + myGpioSetMode(w->I.SCL, PI_OUTPUT); + myGpioWrite(w->I.SCL, 0); +} + +static void I2C_delay(wfRx_t *w) +{ + myGpioDelay(w->I.delay); +} + +static void I2C_clock_stretch(wfRx_t *w) +{ + uint32_t now, max_stretch=100000; + + myGpioSetMode(w->I.SCL, PI_INPUT); + now = gpioTick(); + while ((myGpioRead(w->I.SCL) == 0) && ((gpioTick()-now) < max_stretch)); +} + +static void I2CStart(wfRx_t *w) +{ + if (w->I.started) + { + set_SDA(w); + I2C_delay(w); + I2C_clock_stretch(w); + I2C_delay(w); + } + + clear_SDA(w); + I2C_delay(w); + clear_SCL(w); + I2C_delay(w); + + w->I.started = 1; +} + +static void I2CStop(wfRx_t *w) +{ + clear_SDA(w); + I2C_delay(w); + I2C_clock_stretch(w); + I2C_delay(w); + set_SDA(w); + I2C_delay(w); + + w->I.started = 0; +} + +static void I2CPutBit(wfRx_t *w, int bit) +{ + if (bit) set_SDA(w); + else clear_SDA(w); + + I2C_delay(w); + I2C_clock_stretch(w); + I2C_delay(w); + clear_SCL(w); +} + +static int I2CGetBit(wfRx_t *w) +{ + int bit; + + set_SDA(w); /* let SDA float */ + I2C_delay(w); + I2C_clock_stretch(w); + bit = read_SDA(w); + I2C_delay(w); + clear_SCL(w); + + return bit; +} + +static int I2CPutByte(wfRx_t *w, int byte) +{ + int bit, nack; + + for(bit=0; bit<8; bit++) + { + I2CPutBit(w, byte & 0x80); + byte <<= 1; + } + + nack = I2CGetBit(w); + + return nack; +} + +static uint8_t I2CGetByte(wfRx_t *w, int nack) +{ + int bit, byte=0; + + for (bit=0; bit<8; bit++) + { + byte = (byte << 1) | I2CGetBit(w); + } + + I2CPutBit(w, nack); + + return byte; +} + +/*-------------------------------------------------------------------------*/ + +int bbI2COpen(unsigned SDA, unsigned SCL, unsigned baud) +{ + DBG(DBG_USER, "SDA=%d SCL=%d baud=%d", SDA, SCL, baud); + + CHECK_INITED; + + if (SDA > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad SDA (%d)", SDA); + + if (SCL > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad SCL (%d)", SCL); + + if ((baud < PI_BB_I2C_MIN_BAUD) || (baud > PI_BB_I2C_MAX_BAUD)) + SOFT_ERROR(PI_BAD_I2C_BAUD, + "SDA %d, bad baud rate (%d)", SDA, baud); + + if (wfRx[SDA].mode != PI_WFRX_NONE) + SOFT_ERROR(PI_GPIO_IN_USE, "gpio %d is already being used", SDA); + + if ((wfRx[SCL].mode != PI_WFRX_NONE) || (SCL == SDA)) + SOFT_ERROR(PI_GPIO_IN_USE, "gpio %d is already being used", SCL); + + wfRx[SDA].gpio = SDA; + wfRx[SDA].mode = PI_WFRX_I2C_SDA; + wfRx[SDA].baud = baud; + + wfRx[SDA].I.started = 0; + wfRx[SDA].I.SDA = SDA; + wfRx[SDA].I.SCL = SCL; + wfRx[SDA].I.delay = 500000 / baud; + wfRx[SDA].I.SDAMode = gpioGetMode(SDA); + wfRx[SDA].I.SCLMode = gpioGetMode(SCL); + + wfRx[SCL].gpio = SCL; + wfRx[SCL].mode = PI_WFRX_I2C_SCL; + + myGpioSetMode(SDA, PI_INPUT); + myGpioSetMode(SCL, PI_INPUT); + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int bbI2CClose(unsigned SDA) +{ + DBG(DBG_USER, "SDA=%d", SDA); + + CHECK_INITED; + + if (SDA > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", SDA); + + switch(wfRx[SDA].mode) + { + case PI_WFRX_I2C_SDA: + + myGpioSetMode(wfRx[SDA].I.SDA, wfRx[SDA].I.SDAMode); + myGpioSetMode(wfRx[SDA].I.SCL, wfRx[SDA].I.SCLMode); + + wfRx[wfRx[SDA].I.SDA].mode = PI_WFRX_NONE; + wfRx[wfRx[SDA].I.SCL].mode = PI_WFRX_NONE; + + break; + + default: + + SOFT_ERROR(PI_NOT_I2C_GPIO, "no I2C on gpio (%d)", SDA); + + break; + + } + + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int bbI2CZip( + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen) +{ + int i, ack, inPos, outPos, status, bytes; + int addr, flags, esc, setesc; + wfRx_t *w; + + DBG(DBG_USER, "gpio=%d inBuf=%s outBuf=%08"PRIXPTR" len=%d", + SDA, myBuf2Str(inLen, (char *)inBuf), (uintptr_t)outBuf, outLen); + + CHECK_INITED; + + if (SDA > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", SDA); + + if (wfRx[SDA].mode != PI_WFRX_I2C_SDA) + SOFT_ERROR(PI_NOT_I2C_GPIO, "no I2C on gpio (%d)", SDA); + + if (!inBuf || !inLen) + SOFT_ERROR(PI_BAD_POINTER, "input buffer can't be NULL"); + + if (!outBuf && outLen) + SOFT_ERROR(PI_BAD_POINTER, "output buffer can't be NULL"); + + w = &wfRx[SDA]; + + inPos = 0; + outPos = 0; + status = 0; + + addr = 0; + flags = 0; + esc = 0; + setesc = 0; + + wfRx_lock(SDA); + + while (!status && (inPos < inLen)) + { + DBG(DBG_INTERNAL, "status=%d inpos=%d inlen=%d cmd=%d addr=%d flags=%x", + status, inPos, inLen, inBuf[inPos], addr, flags); + + switch (inBuf[inPos++]) + { + case PI_I2C_END: + status = 1; + break; + + case PI_I2C_START: + I2CStart(w); + break; + + case PI_I2C_STOP: + I2CStop(w); + break; + + case PI_I2C_ADDR: + addr = myI2CGetPar(inBuf, &inPos, inLen, &esc); + if (addr < 0) status = PI_BAD_I2C_CMD; + break; + + case PI_I2C_FLAGS: + /* cheat to force two byte flags */ + esc = 1; + flags = myI2CGetPar(inBuf, &inPos, inLen, &esc); + if (flags < 0) status = PI_BAD_I2C_CMD; + break; + + case PI_I2C_ESC: + setesc = 1; + break; + + case PI_I2C_READ: + + bytes = myI2CGetPar(inBuf, &inPos, inLen, &esc); + + if (bytes >= 0) ack = I2CPutByte(w, (addr<<1)|1); + + if (bytes > 0) + { + if (!ack) + { + if ((bytes + outPos) <= outLen) + { + for (i=0; i<(bytes-1); i++) + { + outBuf[outPos++] = I2CGetByte(w, 0); + } + outBuf[outPos++] = I2CGetByte(w, 1); + } + else status = PI_BAD_I2C_RLEN; + } + else status = PI_I2C_READ_FAILED; + } + else status = PI_BAD_I2C_CMD; + break; + + case PI_I2C_WRITE: + + bytes = myI2CGetPar(inBuf, &inPos, inLen, &esc); + + if (bytes >= 0) ack = I2CPutByte(w, addr<<1); + + if (bytes > 0) + { + if (!ack) + { + if ((bytes + inPos) <= inLen) + { + for (i=0; i<(bytes-1); i++) + { + ack = I2CPutByte(w, inBuf[inPos++]); + if (ack) status = PI_I2C_WRITE_FAILED; + } + ack = I2CPutByte(w, inBuf[inPos++]); + } + else status = PI_BAD_I2C_WLEN; + } else status = PI_I2C_WRITE_FAILED; + } + else status = PI_BAD_I2C_CMD; + break; + + default: + status = PI_BAD_I2C_CMD; + } + + if (setesc) esc = 1; else esc = 0; + + setesc = 0; + } + + wfRx_unlock(SDA); + + if (status >= 0) status = outPos; + + return status; +} + +/* ----------------------------------------------------------------------- */ + +void bscInit(int mode) +{ + int sda, scl, mosi, miso, ce; + + bscsReg[BSC_CR]=0; /* clear device */ + bscsReg[BSC_RSR]=0; /* clear underrun and overrun errors */ + bscsReg[BSC_SLV]=0; /* clear I2C slave address */ + bscsReg[BSC_IMSC]=0xf; /* mask off all interrupts */ + bscsReg[BSC_ICR]=0x0f; /* clear all interrupts */ + + if (pi_is_2711) + { + sda = BSC_SDA_2711; + scl = BSC_SCL_SCLK_2711; + mosi = BSC_MOSI_2711; + miso = BSC_MISO_2711; + ce = BSC_CE_N_2711; + } + else + { + sda = BSC_SDA; + scl = BSC_SCL_SCLK; + mosi = BSC_MOSI; + miso = BSC_MISO; + ce = BSC_CE_N; + } + + + if (mode > 1) /* SPI uses all GPIO */ + { + gpioSetMode(scl, PI_ALT3); + gpioSetMode(mosi, PI_ALT3); + gpioSetMode(miso, PI_ALT3); + gpioSetMode(ce, PI_ALT3); + } + else + { + gpioSetMode(scl, PI_ALT3); + gpioSetMode(sda, PI_ALT3); + } +} + +void bscTerm(int mode) +{ + int sda, scl, mosi, miso, ce; + + bscsReg[BSC_CR] = 0; /* clear device */ + bscsReg[BSC_RSR]=0; /* clear underrun and overrun errors */ + bscsReg[BSC_SLV]=0; /* clear I2C slave address */ + + if (pi_is_2711) + { + sda = BSC_SDA_2711; + scl = BSC_SCL_SCLK_2711; + mosi = BSC_MOSI_2711; + miso = BSC_MISO_2711; + ce = BSC_CE_N_2711; + } + else + { + sda = BSC_SDA; + scl = BSC_SCL_SCLK; + mosi = BSC_MOSI; + miso = BSC_MISO; + ce = BSC_CE_N; + } + + + if (mode > 1) + { + gpioSetMode(scl, PI_INPUT); + gpioSetMode(mosi, PI_INPUT); + gpioSetMode(miso, PI_INPUT); + gpioSetMode(ce, PI_INPUT); + } + else + { + gpioSetMode(sda, PI_INPUT); + gpioSetMode(scl, PI_INPUT); + + } +} + +int bscXfer(bsc_xfer_t *xfer) +{ + static int bscMode = 0; + + int copied=0; + int active, mode; + + DBG(DBG_USER, "control=0x%X (sa=0x%X, cr=0x%X) tx=%d [%s]", + xfer->control, + ((xfer->control)>>16) & 127, + (xfer->control) & 0x3fff, + xfer->txCnt, + myBuf2Str(xfer->txCnt, (char *)xfer->txBuf)); + + CHECK_INITED; + + eventAlert[PI_EVENT_BSC].ignore = 1; + + if (xfer->control) + { + /* + bscMode (0=None, 1=I2C, 2=SPI) tracks which GPIO have been + set to BSC mode + */ + if (xfer->control & 2) mode = 2; /* SPI */ + else mode = 1; /* assume I2C */ + + if (mode > bscMode) + { + bscInit(mode); + bscMode = mode; + } + } + else + { + if (bscMode) bscTerm(bscMode); + bscMode = 0; + return 0; /* leave ignore set */ + } + + xfer->rxCnt = 0; + + bscsReg[BSC_SLV] = ((xfer->control)>>16) & 127; + bscsReg[BSC_CR] = (xfer->control) & 0x3fff; + bscsReg[BSC_RSR]=0; /* clear underrun and overrun errors */ + + active = 1; + + while (active) + { + active = 0; + + while ((copied < xfer->txCnt) && + (!(bscsReg[BSC_FR] & BSC_FR_TXFF))) + { + bscsReg[BSC_DR] = xfer->txBuf[copied++]; + active = 1; + } + + while ((xfer->rxCnt < BSC_FIFO_SIZE) && + (!(bscsReg[BSC_FR] & BSC_FR_RXFE))) + { + xfer->rxBuf[xfer->rxCnt++] = bscsReg[BSC_DR]; + active = 1; + } + + if (!active) + { + active = bscsReg[BSC_FR] & (BSC_FR_RXBUSY | BSC_FR_TXBUSY); + } + + if (active) myGpioSleep(0, 20); + } + + bscFR = bscsReg[BSC_FR] & 0xffff; + + eventAlert[PI_EVENT_BSC].ignore = 0; + + return (copied<<16) | bscFR; +} + +/* ----------------------------------------------------------------------- */ + +static void set_CS(wfRx_t *w) +{ + myGpioWrite(w->S.CS, PI_SPI_FLAGS_GET_CSPOL(w->S.spiFlags)); +} + +static void clear_CS(wfRx_t *w) +{ + myGpioWrite(w->S.CS, !PI_SPI_FLAGS_GET_CSPOL(w->S.spiFlags)); +} + +static void set_SCLK(wfRx_t *w) +{ + myGpioWrite(w->S.SCLK, !PI_SPI_FLAGS_GET_CPOL(w->S.spiFlags)); +} + +static void clear_SCLK(wfRx_t *w) +{ + myGpioWrite(w->S.SCLK, PI_SPI_FLAGS_GET_CPOL(w->S.spiFlags)); +} + +static void SPI_delay(wfRx_t *w) +{ + myGpioDelay(w->S.delay); +} + +static void bbSPIStart(wfRx_t *w) +{ + clear_SCLK(w); + + SPI_delay(w); + + set_CS(w); + + SPI_delay(w); +} + +static void bbSPIStop(wfRx_t *w) +{ + SPI_delay(w); + + clear_CS(w); + + SPI_delay(w); + + clear_SCLK(w); +} + +static uint8_t bbSPIXferByte(wfRx_t *w, char txByte) +{ + uint8_t bit, rxByte=0; + + if (PI_SPI_FLAGS_GET_CPHA(w->S.spiFlags)) + { + /* + CPHA = 1 + write on set clock + read on clear clock + */ + + for (bit=0; bit<8; bit++) + { + set_SCLK(w); + + if (PI_SPI_FLAGS_GET_TX_LSB(w->S.spiFlags)) + { + myGpioWrite(w->S.MOSI, txByte & 0x01); + txByte >>= 1; + } + else + { + myGpioWrite(w->S.MOSI, txByte & 0x80); + txByte <<= 1; + } + + SPI_delay(w); + + clear_SCLK(w); + + if (PI_SPI_FLAGS_GET_RX_LSB(w->S.spiFlags)) + { + rxByte = (rxByte >> 1) | myGpioRead(w->S.MISO) << 7; + } + else + { + rxByte = (rxByte << 1) | myGpioRead(w->S.MISO); + } + + SPI_delay(w); + } + } + else + { + /* + CPHA = 0 + read on set clock + write on clear clock + */ + + for (bit=0; bit<8; bit++) + { + if (PI_SPI_FLAGS_GET_TX_LSB(w->S.spiFlags)) + { + myGpioWrite(w->S.MOSI, txByte & 0x01); + txByte >>= 1; + } + else + { + myGpioWrite(w->S.MOSI, txByte & 0x80); + txByte <<= 1; + } + + SPI_delay(w); + + set_SCLK(w); + + if (PI_SPI_FLAGS_GET_RX_LSB(w->S.spiFlags)) + { + rxByte = (rxByte >> 1) | myGpioRead(w->S.MISO) << 7; + } + else + { + rxByte = (rxByte << 1) | myGpioRead(w->S.MISO); + } + + SPI_delay(w); + + clear_SCLK(w); + } + } + + return rxByte; +} + +/*-------------------------------------------------------------------------*/ + +int bbSPIOpen( + unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, + unsigned baud, unsigned spiFlags) +{ + int valid; + uint32_t bits; + + DBG(DBG_USER, "CS=%d MISO=%d MOSI=%d SCLK=%d baud=%d flags=%d", + CS, MISO, MOSI, SCLK, baud, spiFlags); + + CHECK_INITED; + + if (CS > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad CS (%d)", CS); + + if (MISO > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad MISO (%d)", MISO); + + if (MOSI > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad MOSI (%d)", MOSI); + + if (SCLK > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad SCLK (%d)", SCLK); + + if ((baud < PI_BB_SPI_MIN_BAUD) || (baud > PI_BB_SPI_MAX_BAUD)) + SOFT_ERROR(PI_BAD_SPI_BAUD, "CS %d, bad baud (%d)", CS, baud); + + if (wfRx[CS].mode != PI_WFRX_NONE) + SOFT_ERROR(PI_GPIO_IN_USE, + "CS %d is already being used, mode %d", CS, wfRx[CS].mode); + + valid = 0; + + /* check all GPIO unique */ + + bits = (1< PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", CS); + + switch(wfRx[CS].mode) + { + case PI_WFRX_SPI_CS: + + myGpioSetMode(wfRx[CS].S.CS, wfRx[CS].S.CSMode); + wfRx[CS].mode = PI_WFRX_NONE; + + SCLK = wfRx[CS].S.SCLK; + + if (--wfRx[SCLK].S.usage <= 0) + { + myGpioSetMode(wfRx[SCLK].S.MISO, wfRx[SCLK].S.MISOMode); + myGpioSetMode(wfRx[SCLK].S.MOSI, wfRx[SCLK].S.MOSIMode); + myGpioSetMode(wfRx[SCLK].S.SCLK, wfRx[SCLK].S.SCLKMode); + + wfRx[wfRx[SCLK].S.MISO].mode = PI_WFRX_NONE; + wfRx[wfRx[SCLK].S.MOSI].mode = PI_WFRX_NONE; + wfRx[wfRx[SCLK].S.SCLK].mode = PI_WFRX_NONE; + } + + break; + + default: + + SOFT_ERROR(PI_NOT_SPI_GPIO, "no SPI on gpio (%d)", CS); + + break; + + } + + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int bbSPIXfer( + unsigned CS, + char *inBuf, + char *outBuf, + unsigned count) +{ + int SCLK; + int pos; + wfRx_t *w; + + DBG(DBG_USER, "CS=%d inBuf=%s outBuf=%08"PRIXPTR" count=%d", + CS, myBuf2Str(count, (char *)inBuf), (uintptr_t)outBuf, count); + + CHECK_INITED; + + if (CS > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", CS); + + if (wfRx[CS].mode != PI_WFRX_SPI_CS) + SOFT_ERROR(PI_NOT_SPI_GPIO, "no SPI on gpio (%d)", CS); + + if (!inBuf || !count) + SOFT_ERROR(PI_BAD_POINTER, "input buffer can't be NULL"); + + if (!outBuf && count) + SOFT_ERROR(PI_BAD_POINTER, "output buffer can't be NULL"); + + SCLK = wfRx[CS].S.SCLK; + + wfRx[SCLK].S.CS = CS; + wfRx[SCLK].baud = wfRx[CS].baud; + wfRx[SCLK].S.delay = wfRx[CS].S.delay; + wfRx[SCLK].S.spiFlags = wfRx[CS].S.spiFlags; + + w = &wfRx[SCLK]; + + wfRx_lock(SCLK); + + bbSPIStart(w); + + for (pos=0; pos < count; pos++) + { + outBuf[pos] = bbSPIXferByte(w, inBuf[pos]); + } + + bbSPIStop(w); + + wfRx_unlock(SCLK); + + return count; +} + +/*-------------------------------------------------------------------------*/ + +int gpioSerialReadOpen(unsigned gpio, unsigned baud, unsigned data_bits) +{ + int bitTime, timeout; + + DBG(DBG_USER, "gpio=%d baud=%d data_bits=%d", gpio, baud, data_bits); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if ((baud < PI_BB_SER_MIN_BAUD) || (baud > PI_BB_SER_MAX_BAUD)) + SOFT_ERROR(PI_BAD_WAVE_BAUD, + "gpio %d, bad baud rate (%d)", gpio, baud); + + if ((data_bits < PI_MIN_WAVE_DATABITS) || + (data_bits > PI_MAX_WAVE_DATABITS)) + SOFT_ERROR(PI_BAD_DATABITS, + "gpio %d, bad data bits (%d)", gpio, data_bits); + + if (wfRx[gpio].mode != PI_WFRX_NONE) + SOFT_ERROR(PI_GPIO_IN_USE, "gpio %d is already being used", gpio); + + bitTime = (1000 * MILLION) / baud; /* nanos */ + + timeout = ((data_bits+2) * bitTime)/MILLION; /* millis */ + + if (timeout < 1) timeout = 1; + + wfRx[gpio].gpio = gpio; + wfRx[gpio].mode = PI_WFRX_SERIAL; + wfRx[gpio].baud = baud; + + wfRx[gpio].s.buf = malloc(SRX_BUF_SIZE); + wfRx[gpio].s.bufSize = SRX_BUF_SIZE; + wfRx[gpio].s.timeout = timeout; + wfRx[gpio].s.fullBit = bitTime; /* nanos */ + wfRx[gpio].s.halfBit = (bitTime/2)+500; /* nanos (500 for rounding) */ + wfRx[gpio].s.readPos = 0; + wfRx[gpio].s.writePos = 0; + wfRx[gpio].s.bit = -1; + wfRx[gpio].s.dataBits = data_bits; + wfRx[gpio].s.invert = PI_BB_SER_NORMAL; + + if (data_bits < 9) wfRx[gpio].s.bytes = 1; + else if (data_bits < 17) wfRx[gpio].s.bytes = 2; + else wfRx[gpio].s.bytes = 4; + + gpioSetAlertFunc(gpio, waveRxBit); + + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int gpioSerialReadInvert(unsigned gpio, unsigned invert) +{ + DBG(DBG_USER, "gpio=%d invert=%d", gpio, invert); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (wfRx[gpio].mode != PI_WFRX_SERIAL) + SOFT_ERROR(PI_NOT_SERIAL_GPIO, "no serial read on gpio (%d)", gpio); + + if ((invert < PI_BB_SER_NORMAL) || + (invert > PI_BB_SER_INVERT)) + SOFT_ERROR(PI_BAD_SER_INVERT, + "bad invert level for gpio %d (%d)", gpio, invert); + + wfRx[gpio].s.invert = invert; + + return 0; +} + +/*-------------------------------------------------------------------------*/ + +int gpioSerialRead(unsigned gpio, void *buf, size_t bufSize) +{ + unsigned bytes=0, wpos; + volatile wfRx_t *w; + + DBG(DBG_USER, "gpio=%d buf=%08"PRIXPTR" bufSize=%zd", gpio, (uintptr_t)buf, bufSize); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (bufSize == 0) + SOFT_ERROR(PI_BAD_SERIAL_COUNT, "buffer size can't be zero"); + + if (wfRx[gpio].mode != PI_WFRX_SERIAL) + SOFT_ERROR(PI_NOT_SERIAL_GPIO, "no serial read on gpio (%d)", gpio); + + w = &wfRx[gpio]; + + if (w->s.readPos != w->s.writePos) + { + wpos = w->s.writePos; + + if (wpos > w->s.readPos) bytes = wpos - w->s.readPos; + else bytes = w->s.bufSize - w->s.readPos; + + if (bytes > bufSize) bytes = bufSize; + + /* copy in multiples of the data size in bytes */ + + bytes = (bytes / w->s.bytes) * w->s.bytes; + + if (buf) memcpy(buf, w->s.buf+w->s.readPos, bytes); + + w->s.readPos += bytes; + + if (w->s.readPos >= w->s.bufSize) w->s.readPos = 0; + } + return bytes; +} + + +/*-------------------------------------------------------------------------*/ + +int gpioSerialReadClose(unsigned gpio) +{ + DBG(DBG_USER, "gpio=%d", gpio); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + switch(wfRx[gpio].mode) + { + case PI_WFRX_NONE: + + SOFT_ERROR(PI_NOT_SERIAL_GPIO, "no serial read on gpio (%d)", gpio); + + break; + + case PI_WFRX_SERIAL: + + free(wfRx[gpio].s.buf); + + gpioSetWatchdog(gpio, 0); /* switch off timeouts */ + + gpioSetAlertFunc(gpio, NULL); /* cancel alert */ + + wfRx[gpio].mode = PI_WFRX_NONE; + + break; + } + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +static int intEventSetFunc( + unsigned event, + void * f, + int user, + void * userdata) +{ + DBG(DBG_INTERNAL, "event=%d function=%08"PRIXPTR", user=%d, userdata=%08"PRIXPTR, + event, (uintptr_t)f, user, (uintptr_t)userdata); + + eventAlert[event].ex = user; + eventAlert[event].userdata = userdata; + + eventAlert[event].func = f; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int eventSetFunc(unsigned event, eventFunc_t f) +{ + DBG(DBG_USER, "event=%d function=%08"PRIXPTR, event, (uintptr_t)f); + + CHECK_INITED; + + if (event > PI_MAX_EVENT) + SOFT_ERROR(PI_BAD_EVENT_ID, "bad event (%d)", event); + + intEventSetFunc(event, f, 0, NULL); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int eventSetFuncEx(unsigned event, eventFuncEx_t f, void *userdata) +{ + DBG(DBG_USER, "event=%d function=%08"PRIxPTR" userdata=%08"PRIxPTR, + event, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED; + + if (event > PI_MAX_EVENT) + SOFT_ERROR(PI_BAD_EVENT_ID, "bad event (%d)", event); + + intEventSetFunc(event, f, 1, userdata); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int eventMonitor(unsigned handle, uint32_t bits) +{ + DBG(DBG_USER, "handle=%d bits=%08X", handle, bits); + + CHECK_INITED; + + if (handle >= PI_NOTIFY_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (gpioNotify[handle].state <= PI_NOTIFY_CLOSING) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + gpioNotify[handle].eventBits = bits; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int eventTrigger(unsigned event) +{ + DBG(DBG_USER, "event=%d", event); + + CHECK_INITED; + + if (event > PI_MAX_EVENT) + SOFT_ERROR(PI_BAD_EVENT_ID, "bad event (%d)", event); + + eventAlert[event].fired = 1; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +static int intGpioSetAlertFunc( + unsigned gpio, + void * f, + int user, + void * userdata) +{ + DBG(DBG_INTERNAL, "gpio=%d function=%08"PRIXPTR", user=%d, userdata=%08"PRIXPTR, + gpio, (uintptr_t)f, user, (uintptr_t)userdata); + + gpioAlert[gpio].ex = user; + gpioAlert[gpio].userdata = userdata; + + gpioAlert[gpio].func = f; + + if (f) + { + alertBits |= BIT; + } + else + { + alertBits &= ~BIT; + } + + monitorBits = alertBits | notifyBits | scriptBits | gpioGetSamples.bits; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioSetAlertFunc(unsigned gpio, gpioAlertFunc_t f) +{ + DBG(DBG_USER, "gpio=%d function=%08"PRIXPTR, gpio, (uintptr_t)f); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + intGpioSetAlertFunc(gpio, f, 0, NULL); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetAlertFuncEx(unsigned gpio, gpioAlertFuncEx_t f, void *userdata) +{ + DBG(DBG_USER, "gpio=%d function=%08"PRIXPTR" userdata=%08"PRIXPTR, + gpio, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + intGpioSetAlertFunc(gpio, f, 1, userdata); + + return 0; +} + +static void *pthISRThread(void *x) +{ + gpioISR_t *isr = x; + int fd; + int retval; + uint32_t tick; + int level; + uint32_t levels; + struct pollfd pfd; + char buf[64]; + + DBG(DBG_USER, "gpio=%d edge=%d timeout=%d f=%"PRIxPTR" u=%d data=%"PRIxPTR, + isr->gpio, isr->edge, isr->timeout, (uintptr_t)isr->func, + isr->ex, (uintptr_t)isr->userdata); + + sprintf(buf, "/sys/class/gpio/gpio%d/value", isr->gpio); + + isr->fd = -1; /* no fd assigned */ + + if ((fd = open(buf, O_RDONLY)) < 0) + { + DBG(DBG_ALWAYS, "gpio %d not exported", isr->gpio); + return NULL; + } + + isr->fd = fd; /* store fd so it can be closed */ + + pfd.fd = fd; + + pfd.events = POLLPRI; + + lseek(fd, 0, SEEK_SET); /* consume any prior interrupt */ + if (read(fd, buf, sizeof buf) == -1) { /* ignore errors */ } + + while (1) + { + retval = poll(&pfd, 1, isr->timeout); /* wait for interrupt */ + + tick = systReg[SYST_CLO]; + + levels = *(gpioReg + GPLEV0); + + if (retval >= 0) + { + lseek(fd, 0, SEEK_SET); /* consume interrupt */ + if (read(fd, buf, sizeof buf) == -1) { /* ignore errors */ } + + if (retval) + { + if (levels & (1<gpio)) level = PI_ON; else level = PI_OFF; + } + else level = PI_TIMEOUT; + + if (isr->ex) (isr->func)(isr->gpio, level, tick, isr->userdata); + else (isr->func)(isr->gpio, level, tick); + } + } + + return NULL; +} + + +/* ----------------------------------------------------------------------- */ + +static int intGpioSetISRFunc( + unsigned gpio, + unsigned edge, + int timeout, + void *f, + int user, + void *userdata) +{ + char buf[64]; + + char *edge_str[]={"rising\n", "falling\n", "both\n"}; + int fd; + int err; + + DBG(DBG_INTERNAL, + "gpio=%d edge=%d timeout=%d function=%08"PRIXPTR" user=%d userdata=%08"PRIXPTR, + gpio, edge, timeout, (uintptr_t)f, user, (uintptr_t)userdata); + + if (f) + { + if (!gpioISR[gpio].inited) /* export gpio if unexported */ + { + fd = open("/sys/class/gpio/export", O_WRONLY); + if (fd < 0) return PI_BAD_ISR_INIT; + + /* ignore write fail if already exported */ + sprintf(buf, "%d\n", gpio); + err = write(fd, buf, strlen(buf)); + close(fd); + + sprintf(buf, "/sys/class/gpio/gpio%d/direction", gpio); + fd = open(buf, O_WRONLY); + if (fd < 0) return PI_BAD_ISR_INIT; + + err = write(fd, "in\n", 3); + close(fd); + if (err != 3) return PI_BAD_ISR_INIT; + + gpioISR[gpio].gpio = gpio; + gpioISR[gpio].edge = -1; + gpioISR[gpio].timeout = -1; + + gpioISR[gpio].inited = 1; + } + + if (gpioISR[gpio].edge != edge) + { + sprintf(buf, "/sys/class/gpio/gpio%d/edge", gpio); + fd = open(buf, O_WRONLY); + if (fd < 0) return PI_BAD_ISR_INIT; + + err = write(fd, edge_str[edge], strlen(edge_str[edge])); + close(fd); + if (err != strlen(edge_str[edge])) return PI_BAD_ISR_INIT; + + gpioISR[gpio].edge = edge; + + if (gpioISR[gpio].pth != NULL) + pthread_kill(*gpioISR[gpio].pth, SIGCHLD); + } + + if (timeout <= 0) timeout = -1; + if (gpioISR[gpio].timeout != timeout) + { + gpioISR[gpio].timeout = timeout; + + if (gpioISR[gpio].pth != NULL) + pthread_kill(*gpioISR[gpio].pth, SIGCHLD); + } + + gpioISR[gpio].func = f; + gpioISR[gpio].ex = user; + gpioISR[gpio].userdata = userdata; + + if (gpioISR[gpio].pth == NULL) + gpioISR[gpio].pth = gpioStartThread(pthISRThread, &gpioISR[gpio]); + } + else /* null function, delete ISR, unexport gpio */ + { + if (gpioISR[gpio].pth) /* delete any existing ISR */ + { + gpioStopThread(gpioISR[gpio].pth); + + if (gpioISR[gpio].fd >= 0) + { + close(gpioISR[gpio].fd); + gpioISR[gpio].fd = -1; + } + + gpioISR[gpio].func = NULL; + gpioISR[gpio].pth = NULL; + } + + if (gpioISR[gpio].inited) /* unexport the gpio */ + { + fd = open("/sys/class/gpio/unexport", O_WRONLY); + if (fd < 0) return PI_BAD_ISR_INIT; + sprintf(buf, "%d\n", gpio); + err = write(fd, buf, strlen(buf)); + close(fd); + if (err != strlen(buf)) return PI_BAD_ISR_INIT; + gpioISR[gpio].inited = 0; + } + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioSetISRFunc( + unsigned gpio, + unsigned edge, + int timeout, + gpioISRFunc_t f) +{ + DBG(DBG_USER, "gpio=%d edge=%d timeout=%d function=%08"PRIXPTR, + gpio, edge, timeout, (uintptr_t)f); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (edge > EITHER_EDGE) + SOFT_ERROR(PI_BAD_EDGE, "bad ISR edge (%d)", edge); + + return intGpioSetISRFunc(gpio, edge, timeout, f, 0, NULL); +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetISRFuncEx( + unsigned gpio, + unsigned edge, + int timeout, + gpioAlertFuncEx_t f, + void *userdata) +{ + DBG(DBG_USER, "gpio=%d edge=%d timeout=%d function=%08"PRIXPTR" userdata=%08"PRIXPTR, + gpio, edge, timeout, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (edge > EITHER_EDGE) + SOFT_ERROR(PI_BAD_EDGE, "bad ISR edge (%d)", edge); + + return intGpioSetISRFunc(gpio, edge, timeout, f, 1, userdata); +} + +static void closeOrphanedNotifications(int slot, int fd) +{ + int i; + + /* Check for and close any orphaned notifications. */ + + for (i=0; i= PI_NOTIFY_OPENED) && + (gpioNotify[i].fd == fd)) + { + DBG(DBG_USER, "closed orphaned fd=%d (handle=%d)", fd, i); + gpioNotify[i].state = PI_NOTIFY_CLOSED; + intNotifyBits(); + } + } +} + +/* ----------------------------------------------------------------------- */ + +static void notifyMutex(int lock) +{ + static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + if (lock) pthread_mutex_lock(&mutex); + else pthread_mutex_unlock(&mutex); +} + +/* ----------------------------------------------------------------------- */ + +int gpioNotifyOpenWithSize(int bufSize) +{ + int i, slot, fd; + char name[32]; + + DBG(DBG_USER, "bufSize=%d", bufSize); + + CHECK_INITED; + + slot = -1; + + notifyMutex(1); + + for (i=0; i= PI_NOTIFY_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (gpioNotify[handle].state <= PI_NOTIFY_CLOSING) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + gpioNotify[handle].bits = bits; + + gpioNotify[handle].state = PI_NOTIFY_RUNNING; + + intNotifyBits(); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioNotifyPause (unsigned handle) +{ + DBG(DBG_USER, "handle=%d", handle); + + CHECK_INITED; + + if (handle >= PI_NOTIFY_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (gpioNotify[handle].state <= PI_NOTIFY_CLOSING) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + gpioNotify[handle].bits = 0; + + gpioNotify[handle].state = PI_NOTIFY_PAUSED; + + intNotifyBits(); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioNotifyClose(unsigned handle) +{ + char fifo[32]; + + DBG(DBG_USER, "handle=%d", handle); + + CHECK_INITED; + + if (handle >= PI_NOTIFY_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (gpioNotify[handle].state <= PI_NOTIFY_CLOSING) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + gpioNotify[handle].bits = 0; + + gpioNotify[handle].state = PI_NOTIFY_CLOSING; + + intNotifyBits(); + + if (gpioCfg.ifFlags & PI_DISABLE_ALERT) + { + if (gpioNotify[handle].pipe) + { + DBG(DBG_INTERNAL, "close notify pipe %d", gpioNotify[handle].fd); + close(gpioNotify[handle].fd); + + sprintf(fifo, "/dev/pigpio%d", handle); + + unlink(fifo); + } + + gpioNotify[handle].state = PI_NOTIFY_CLOSED; + } + else + { + /* actual close done in alert thread */ + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioTrigger(unsigned gpio, unsigned pulseLen, unsigned level) +{ + DBG(DBG_USER, "gpio=%d pulseLen=%d level=%d", gpio, pulseLen, level); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (level > PI_ON) + SOFT_ERROR(PI_BAD_LEVEL, "gpio %d, bad level (%d)", gpio, level); + + if ((pulseLen > PI_MAX_BUSY_DELAY) || (!pulseLen)) + SOFT_ERROR(PI_BAD_PULSELEN, + "gpio %d, bad pulseLen (%d)", gpio, pulseLen); + + if (level == PI_OFF) *(gpioReg + GPCLR0 + BANK) = BIT; + else *(gpioReg + GPSET0 + BANK) = BIT; + + myGpioDelay(pulseLen); + + if (level != PI_OFF) *(gpioReg + GPCLR0 + BANK) = BIT; + else *(gpioReg + GPSET0 + BANK) = BIT; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetWatchdog(unsigned gpio, unsigned timeout) +{ + DBG(DBG_USER, "gpio=%d timeout=%d", gpio, timeout); + + CHECK_INITED; + + if (gpio > PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (timeout > PI_MAX_WDOG_TIMEOUT) + SOFT_ERROR(PI_BAD_WDOG_TIMEOUT, + "gpio %d, bad timeout (%d)", gpio, timeout); + + gpioAlert[gpio].wdTick = systReg[SYST_CLO]; + gpioAlert[gpio].wdSteadyUs = timeout*1000; + + if (timeout) wdogBits |= (1< PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (steady > PI_MAX_STEADY) + SOFT_ERROR(PI_BAD_FILTER, "bad steady (%d)", steady); + + if (active > PI_MAX_ACTIVE) + SOFT_ERROR(PI_BAD_FILTER, "bad active (%d)", active); + + gpioAlert[gpio].nfTick1 = systReg[SYST_CLO]; + gpioAlert[gpio].nfTick2 = gpioAlert[gpio].nfTick1; + gpioAlert[gpio].nfSteadyUs = steady; + gpioAlert[gpio].nfActiveUs = active; + gpioAlert[gpio].nfActive = 0; + + if (steady) nFilterBits |= (1< PI_MAX_USER_GPIO) + SOFT_ERROR(PI_BAD_USER_GPIO, "bad gpio (%d)", gpio); + + if (steady > PI_MAX_STEADY) + SOFT_ERROR(PI_BAD_FILTER, "bad steady (%d)", steady); + + if (steady) + { + /* Initialise values next time we process alerts */ + gpioAlert[gpio].gfInitialised = 0; + } + + gpioAlert[gpio].gfSteadyUs = steady; + + if (steady) gFilterBits |= (1< PI_MAX_TIMER) + SOFT_ERROR(PI_BAD_TIMER, "bad timer id (%d)", id); + + if (f) + { + if ((millis < PI_MIN_MS) || (millis > PI_MAX_MS)) + SOFT_ERROR(PI_BAD_MS, "timer %d, bad millis (%d)", id, millis); + } + + intGpioSetTimerFunc(id, millis, f, 0, NULL); + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetTimerFuncEx(unsigned id, unsigned millis, gpioTimerFuncEx_t f, + void * userdata) +{ + DBG(DBG_USER, "id=%d millis=%d function=%08"PRIXPTR", userdata=%08"PRIXPTR, + id, millis, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED; + + if (id > PI_MAX_TIMER) + SOFT_ERROR(PI_BAD_TIMER, "bad timer id (%d)", id); + + if ((millis < PI_MIN_MS) || (millis > PI_MAX_MS)) + SOFT_ERROR(PI_BAD_MS, "timer %d, bad millis (%d)", id, millis); + + intGpioSetTimerFunc(id, millis, f, 1, userdata); + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +pthread_t *gpioStartThread(gpioThreadFunc_t f, void *userdata) +{ + pthread_t *pth; + pthread_attr_t pthAttr; + + DBG(DBG_USER, "f=%08"PRIXPTR", userdata=%08"PRIXPTR, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED_RET_NULL_PTR; + + pth = malloc(sizeof(pthread_t)); + + if (pth) + { + if (pthread_attr_init(&pthAttr)) + { + free(pth); + SOFT_ERROR(NULL, "pthread_attr_init failed"); + } + + if (pthread_attr_setstacksize(&pthAttr, STACK_SIZE)) + { + free(pth); + SOFT_ERROR(NULL, "pthread_attr_setstacksize failed"); + } + + if (pthread_create(pth, &pthAttr, f, userdata)) + { + free(pth); + SOFT_ERROR(NULL, "pthread_create failed"); + } + } + return pth; +} + +/* ----------------------------------------------------------------------- */ + +void gpioStopThread(pthread_t *pth) +{ + DBG(DBG_USER, "pth=%08"PRIXPTR, (uintptr_t)pth); + + CHECK_INITED_RET_NIL; + + if (pth) + { + if (pthread_self() == *pth) + { + free(pth); + pthread_exit(NULL); + } + else + { + pthread_cancel(*pth); + pthread_join(*pth, NULL); + free(pth); + } + } +} + +/* ----------------------------------------------------------------------- */ + +int gpioStoreScript(char *script) +{ + static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + gpioScript_t *s; + int status, slot, i; + + DBG(DBG_USER, "script=[%s]", script); + + CHECK_INITED; + + slot = -1; + + pthread_mutex_lock(&mutex); + + for (i=0; iscript, 0); + + if (status == 0) + { + s->request = PI_SCRIPT_HALT; + s->run_state = PI_SCRIPT_INITING; + + pthread_cond_init(&s->pthCond, NULL); + pthread_mutex_init(&s->pthMutex, NULL); + + s->id = slot; + + gpioScript[slot].state = PI_SCRIPT_IN_USE; + + s->pthIdp = gpioStartThread(pthScript, s); + + status = slot; + } + else + { + if (s->script.par) free(s->script.par); + s->script.par = NULL; + gpioScript[slot].state = PI_SCRIPT_FREE; + } + + return status; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioRunScript(unsigned script_id, unsigned numParam, uint32_t *param) +{ + int status = 0; + + DBG(DBG_USER, "script_id=%d numParam=%d param=%08"PRIXPTR, + script_id, numParam, (uintptr_t)param); + + CHECK_INITED; + + if (script_id >= PI_MAX_SCRIPTS) + SOFT_ERROR(PI_BAD_SCRIPT_ID, "bad script id(%d)", script_id); + + if (numParam > PI_MAX_SCRIPT_PARAMS) + SOFT_ERROR(PI_TOO_MANY_PARAM, "bad number of parameters(%d)", numParam); + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + pthread_mutex_lock(&gpioScript[script_id].pthMutex); + + if (gpioScript[script_id].run_state != PI_SCRIPT_INITING) + { + if ((numParam > 0) && (param != 0)) + { + memcpy(gpioScript[script_id].script.par, param, + sizeof(uint32_t) * numParam); + } + + gpioScript[script_id].request = PI_SCRIPT_RUN; + + pthread_cond_signal(&gpioScript[script_id].pthCond); + } + else + { + status = PI_SCRIPT_NOT_READY; + } + + pthread_mutex_unlock(&gpioScript[script_id].pthMutex); + + return status; + } + else + { + return PI_BAD_SCRIPT_ID; + } +} + + +/* ----------------------------------------------------------------------- */ + +int gpioUpdateScript(unsigned script_id, unsigned numParam, uint32_t *param) +{ + DBG(DBG_USER, "script_id=%d numParam=%d param=%08"PRIXPTR, + script_id, numParam, (uintptr_t)param); + + CHECK_INITED; + + if (script_id >= PI_MAX_SCRIPTS) + SOFT_ERROR(PI_BAD_SCRIPT_ID, "bad script id(%d)", script_id); + + if (numParam > PI_MAX_SCRIPT_PARAMS) + SOFT_ERROR(PI_TOO_MANY_PARAM, "bad number of parameters(%d)", numParam); + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + if ((numParam > 0) && (param != 0)) + { + memcpy(gpioScript[script_id].script.par, param, + sizeof(uint32_t) * numParam); + } + } + else + { + return PI_BAD_SCRIPT_ID; + } + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioScriptStatus(unsigned script_id, uint32_t *param) +{ + DBG(DBG_USER, "script_id=%d param=%08"PRIXPTR, script_id, (uintptr_t)param); + + CHECK_INITED; + + if (script_id >= PI_MAX_SCRIPTS) + SOFT_ERROR(PI_BAD_SCRIPT_ID, "bad script id(%d)", script_id); + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + if (param != NULL) + { + memcpy(param, gpioScript[script_id].script.par, + sizeof(uint32_t) * PI_MAX_SCRIPT_PARAMS); + } + + return gpioScript[script_id].run_state; + } + else return PI_BAD_SCRIPT_ID; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioStopScript(unsigned script_id) +{ + DBG(DBG_USER, "script_id=%d", script_id); + + CHECK_INITED; + + if (script_id >= PI_MAX_SCRIPTS) + SOFT_ERROR(PI_BAD_SCRIPT_ID, "bad script id(%d)", script_id); + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + pthread_mutex_lock(&gpioScript[script_id].pthMutex); + + gpioScript[script_id].request = PI_SCRIPT_HALT; + + if (gpioScript[script_id].run_state == PI_SCRIPT_WAITING) + { + pthread_cond_signal(&gpioScript[script_id].pthCond); + } + + pthread_mutex_unlock(&gpioScript[script_id].pthMutex); + + return 0; + } + else return PI_BAD_SCRIPT_ID; +} + +/* ----------------------------------------------------------------------- */ + +int gpioDeleteScript(unsigned script_id) +{ + DBG(DBG_USER, "script_id=%d", script_id); + + CHECK_INITED; + + if (script_id >= PI_MAX_SCRIPTS) + SOFT_ERROR(PI_BAD_SCRIPT_ID, "bad script id(%d)", script_id); + + if (gpioScript[script_id].state == PI_SCRIPT_IN_USE) + { + gpioScript[script_id].state = PI_SCRIPT_DYING; + + pthread_mutex_lock(&gpioScript[script_id].pthMutex); + + gpioScript[script_id].request = PI_SCRIPT_HALT; + + if (gpioScript[script_id].run_state == PI_SCRIPT_WAITING) + { + pthread_cond_signal(&gpioScript[script_id].pthCond); + } + + pthread_mutex_unlock(&gpioScript[script_id].pthMutex); + + while (gpioScript[script_id].run_state == PI_SCRIPT_RUNNING) + { + myGpioSleep(0, 5000); /* give script time to halt */ + } + + gpioStopThread(gpioScript[script_id].pthIdp); + + if (gpioScript[script_id].script.par) + free(gpioScript[script_id].script.par); + + gpioScript[script_id].script.par = NULL; + + gpioScript[script_id].state = PI_SCRIPT_FREE; + + return 0; + } + else return PI_BAD_SCRIPT_ID; +} + + + +/* ----------------------------------------------------------------------- */ + +int gpioSetSignalFunc(unsigned signum, gpioSignalFunc_t f) +{ + DBG(DBG_USER, "signum=%d function=%08"PRIXPTR, signum, (uintptr_t)f); + + CHECK_INITED; + + if (signum > PI_MAX_SIGNUM) + SOFT_ERROR(PI_BAD_SIGNUM, "bad signum (%d)", signum); + + gpioSignal[signum].ex = 0; + gpioSignal[signum].userdata = NULL; + + gpioSignal[signum].func = f; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSetSignalFuncEx(unsigned signum, gpioSignalFuncEx_t f, + void *userdata) +{ + DBG(DBG_USER, "signum=%d function=%08"PRIXPTR" userdata=%08"PRIXPTR, + signum, (uintptr_t)f, (uintptr_t)userdata); + + CHECK_INITED; + + if (signum > PI_MAX_SIGNUM) + SOFT_ERROR(PI_BAD_SIGNUM, "bad signum (%d)", signum); + + gpioSignal[signum].ex = 1; + gpioSignal[signum].userdata = userdata; + + gpioSignal[signum].func = f; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t gpioRead_Bits_0_31(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return (*(gpioReg + GPLEV0)); +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t gpioRead_Bits_32_53(void) +{ + DBG(DBG_USER, ""); + + CHECK_INITED; + + return (*(gpioReg + GPLEV1)); +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWrite_Bits_0_31_Clear(uint32_t bits) +{ + DBG(DBG_USER, "bits=%08X", bits); + + CHECK_INITED; + + *(gpioReg + GPCLR0) = bits; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWrite_Bits_32_53_Clear(uint32_t bits) +{ + DBG(DBG_USER, "bits=%08X", bits); + + CHECK_INITED; + + *(gpioReg + GPCLR1) = bits; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWrite_Bits_0_31_Set(uint32_t bits) +{ + DBG(DBG_USER, "bits=%08X", bits); + + CHECK_INITED; + + *(gpioReg + GPSET0) = bits; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioWrite_Bits_32_53_Set(uint32_t bits) +{ + DBG(DBG_USER, "bits=%08X", bits); + + CHECK_INITED; + + *(gpioReg + GPSET1) = bits; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioHardwareClock(unsigned gpio, unsigned frequency) +{ + int cctl[] = {CLK_GP0_CTL, CLK_GP1_CTL, CLK_GP2_CTL}; + int cdiv[] = {CLK_GP0_DIV, CLK_GP1_DIV, CLK_GP2_DIV}; + int csrc[CLK_SRCS] = {CLK_CTL_SRC_OSC, CLK_CTL_SRC_PLLD}; + uint32_t cfreq[CLK_SRCS]={clk_osc_freq, clk_plld_freq}; + unsigned clock, mode, mash; + int password = 0; + double f; + clkInf_t clkInf={0,0,0}; + + DBG(DBG_USER, "gpio=%d frequency=%d", gpio, frequency); + + CHECK_INITED; + + if ((gpio >> 24) == 0x5A) password = 1; + + gpio &= 0xFFFFFF; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (!clkDef[gpio]) + SOFT_ERROR(PI_NOT_HCLK_GPIO, "bad gpio for clock (%d)", gpio); + + if (((frequency < hw_clk_min_freq) || + (frequency > hw_clk_max_freq)) && + (frequency)) + SOFT_ERROR(PI_BAD_HCLK_FREQ, + "bad hardware clock frequency %d-%d: (%d)", + hw_clk_min_freq, hw_clk_max_freq, frequency); + + clock = (clkDef[gpio] >> 4) & 3; + + if ((clock == 1) && (!password)) + SOFT_ERROR(PI_BAD_HCLK_PASS, + "Need password to use clock 1 (%d)", gpio); + + mode = clkDef[gpio] & 7; + mash = frequency < PI_MASH_MAX_FREQ ? 1 : 0; + + if (frequency) + { + if (chooseBestClock(&clkInf, frequency, CLK_SRCS, cfreq)) + { + if (clkInf.frac == 0) mash = 0; + + initHWClk(cctl[clock], cdiv[clock], + csrc[clkInf.clock], clkInf.div, clkInf.frac, mash); + + myGpioSetMode(gpio, mode); + + gpioInfo[gpio].is = GPIO_HW_CLK; + + f = (double) cfreq[clkInf.clock] / + ((double)clkInf.div + ((double)clkInf.frac / 4096.0)); + + hw_clk_freq[clock] = (f + 0.5); + + DBG(DBG_USER, "cf=%d div=%d frac=%d mash=%d", + cfreq[clkInf.clock], clkInf.div, clkInf.frac, mash); + } + else + { + SOFT_ERROR(PI_BAD_HCLK_FREQ, + "bad hardware clock frequency %d-%d: (%d)", + hw_clk_min_freq, hw_clk_max_freq, frequency); + } + } + else + { + /* frequency 0, stop clock */ + clkReg[cctl[clock]] = BCM_PASSWD | CLK_CTL_KILL; + + if (gpioInfo[gpio].is == GPIO_HW_CLK) + gpioInfo[gpio].is = GPIO_UNDEFINED; + } + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioHardwarePWM( + unsigned gpio, unsigned frequency, unsigned dutycycle) +{ + uint32_t old_PWM_CTL; + unsigned pwm, mode; + uint32_t real_range, real_dutycycle; + + DBG(DBG_USER, "gpio=%d frequency=%d dutycycle=%d", + gpio, frequency, dutycycle); + + CHECK_INITED; + + if (gpio > PI_MAX_GPIO) + SOFT_ERROR(PI_BAD_GPIO, "bad gpio (%d)", gpio); + + if (!PWMDef[gpio]) + SOFT_ERROR(PI_NOT_HPWM_GPIO, "bad gpio for PWM (%d)", gpio); + + if (dutycycle > PI_HW_PWM_RANGE) + SOFT_ERROR(PI_BAD_HPWM_DUTY, "bad PWM dutycycle (%d)", dutycycle); + + if (((frequency < PI_HW_PWM_MIN_FREQ) || + (frequency > hw_pwm_max_freq)) && + (frequency)) + SOFT_ERROR(PI_BAD_HPWM_FREQ, + "bad hardware PWM frequency %d-%d: (%d)", + PI_HW_PWM_MIN_FREQ, hw_pwm_max_freq, frequency); + + + if (gpioCfg.clockPeriph == PI_CLOCK_PWM) + SOFT_ERROR(PI_HPWM_ILLEGAL, "illegal, PWM in use for main clock"); + + pwm = (PWMDef[gpio] >> 4) & 3; + mode = PWMDef[gpio] & 7; + + if (frequency) + { + real_range = ((double)clk_plld_freq / (2.0 * frequency)) + 0.5; + real_dutycycle = ((uint64_t)dutycycle * real_range) / PI_HW_PWM_RANGE; + + /* record the set PWM frequency and dutycycle */ + + hw_pwm_freq[pwm] = + ((double)clk_plld_freq / ( 2.0 * real_range)) + 0.5; + + hw_pwm_duty[pwm] = dutycycle; + + hw_pwm_real_range[pwm] = real_range; + + /* Abort any waveform transmission in progress */ + + if (gpioWaveTxBusy()) gpioWaveTxStop(); + + waveClockInited = 0; + + /* preserve channel enable only and mark space mode */ + + old_PWM_CTL = pwmReg[PWM_CTL] & + (PWM_CTL_PWEN1 | PWM_CTL_MSEN1 | PWM_CTL_PWEN2 | PWM_CTL_MSEN2); + + if (!PWMClockInited) + { + pwmReg[PWM_CTL] = 0; + + myGpioDelay(10); + + initHWClk(CLK_PWMCTL, CLK_PWMDIV, CLK_CTL_SRC_PLLD, 2, 0, 0); + + PWMClockInited = 1; + } + + if (pwm == 0) + { + pwmReg[PWM_RNG1] = real_range; + myGpioDelay(10); + pwmReg[PWM_DAT1] = real_dutycycle; + myGpioDelay(10); + + pwmReg[PWM_CTL] = (old_PWM_CTL | PWM_CTL_PWEN1 | PWM_CTL_MSEN1); + } + else + { + pwmReg[PWM_RNG2] = real_range; + myGpioDelay(10); + pwmReg[PWM_DAT2] = real_dutycycle; + myGpioDelay(10); + + pwmReg[PWM_CTL] = (old_PWM_CTL | PWM_CTL_PWEN2 | PWM_CTL_MSEN2); + } + + if (gpioInfo[gpio].is != GPIO_HW_PWM) + { + switchFunctionOff(gpio); + + myGpioSetMode(gpio, mode); + + gpioInfo[gpio].is = GPIO_HW_PWM; + } + } + else + { + /* frequency 0, stop PWM */ + + if (gpioInfo[gpio].is == GPIO_HW_PWM) + { + if (pwm == 0) pwmReg[PWM_CTL] &= (~PWM_CTL_PWEN1); + else pwmReg[PWM_CTL] &= (~PWM_CTL_PWEN2); + + gpioInfo[gpio].is = GPIO_UNDEFINED; + } + } + + return 0; +} + + +int gpioSetPad(unsigned pad, unsigned padStrength) +{ + DBG(DBG_USER, "pad=%d padStrength=%d", pad, padStrength); + + CHECK_INITED; + + if (pad > PI_MAX_PAD) + SOFT_ERROR(PI_BAD_PAD, "bad pad number (%d)", pad); + + if ((padStrength < PI_MIN_PAD_STRENGTH) || + (padStrength > PI_MAX_PAD_STRENGTH)) + SOFT_ERROR(PI_BAD_STRENGTH, "bad pad drive strength (%d)", pad); + + /* 1-16 -> 0-7 */ + + padStrength += 1; + padStrength /= 2; + padStrength -= 1; + + padsReg[11+pad] = BCM_PASSWD | 0x18 | (padStrength & 7) ; + + return 0; +} + +int gpioGetPad(unsigned pad) +{ + int strength; + + DBG(DBG_USER, "pad=%d", pad); + + CHECK_INITED; + + if (pad > PI_MAX_PAD) + SOFT_ERROR(PI_BAD_PAD, "bad pad (%d)", pad); + + strength = padsReg[11+pad] & 7; + + strength *= 2; + strength += 2; + + return strength; +} + +int shell(char *scriptName, char *scriptString) +{ + int status; + char buf[4096]; + + DBG(DBG_USER, "name=%s string=%s", scriptName, scriptString); + + CHECK_INITED; + + if (!myScriptNameValid(scriptName)) + SOFT_ERROR(PI_BAD_SCRIPT_NAME, "bad script name (%s)", scriptName); + + snprintf(buf, sizeof(buf), + "/opt/pigpio/cgi/%s %s", scriptName, scriptString); + + DBG(DBG_USER, "%s", buf); + + status = system(buf); + + if (status < 0) status = PI_BAD_SHELL_STATUS; + + return status; +} + + +int fileApprove(char *filename) +{ + char match[PI_MAX_PATH]; + char buffer[PI_MAX_PATH]; + char line[PI_MAX_PATH]; + char mperm=0; + char perm; + char term; + FILE *f; + + buffer[0] = 0; + match[0] = 0; + + if (myPathBad(filename)) return PI_FILE_NONE; + + f = fopen("/opt/pigpio/access", "r"); + + if (!f) return PI_FILE_NONE; + + while (!feof(f)) + { + buffer[0] = 0; + perm = 0; + term = 0; + if (fgets(line, sizeof(line), f)) + { + sscanf(line, " %511s %c%c", buffer, &perm, &term); + if (term == 10) + { + if (myPathBad(buffer)) continue; /* disallow risky lines */ + + if (fnmatch(buffer, filename, 0) == 0) + { + if (match[0]) + { + if (fnmatch(match, buffer, 0) == 0) + { + strcpy(match, buffer); + mperm = perm; + } + } + else + { + strcpy(match, buffer); + mperm = perm; + } + } + } + } + } + + fclose(f); + + if (match[0]) + { + switch (toupper(mperm)) + { + case 'R': return PI_FILE_READ; + case 'W': return PI_FILE_WRITE; + case 'U': return PI_FILE_RW; + default : return PI_FILE_NONE; + } + } + + return PI_FILE_NONE; +} + +int fileOpen(char *file, unsigned mode) +{ + static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER; + int fd=-1; + int i, slot, oflag, omode, pmode, rmode; + struct stat statbuf; + + DBG(DBG_USER, "file=%s mode=%d", file, mode); + + CHECK_INITED; + + if ( (mode < PI_FILE_MIN) || + (mode > PI_FILE_MAX) || + ((mode & PI_FILE_RW) == 0) ) + SOFT_ERROR(PI_BAD_FILE_MODE, "bad mode (%d)", mode); + + pmode = fileApprove(file); // 0=NONE, 1=READ, 2=WRITE, 3=RW + rmode = mode & PI_FILE_RW; // 0=NONE, 1=READ, 2=WRITE, 3=RW + + if (((pmode & rmode) != rmode) || (rmode == PI_FILE_NONE)) + SOFT_ERROR(PI_NO_FILE_ACCESS, "no permission to access file (%s)", file); + + if ((mode > 3) && ((mode & PI_FILE_WRITE) == 0)) + SOFT_ERROR(PI_NO_FILE_ACCESS, "no permission to write file (%s)", file); + + slot = -1; + + pthread_mutex_lock(&mutex); + + for (i=0; i= PI_FILE_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (fileInfo[handle].state != PI_FILE_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (fileInfo[handle].fd >= 0) close(fileInfo[handle].fd); + + fileInfo[handle].fd = -1; + fileInfo[handle].state = PI_FILE_CLOSED; + + return 0; +} + +int fileWrite(unsigned handle, char *buf, unsigned count) +{ + int w; + + DBG(DBG_USER, "handle=%d count=%d [%s]", + handle, count, myBuf2Str(count, buf)); + + CHECK_INITED; + + if (handle >= PI_FILE_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (fileInfo[handle].state != PI_FILE_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (!count) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + if (!(fileInfo[handle].mode & PI_FILE_WRITE)) + SOFT_ERROR(PI_FILE_NOT_WOPEN, "file not opened for write"); + + w = write(fileInfo[handle].fd, buf, count); + + if (w != count) + { + if (w == -1) DBG(DBG_USER, "write failed with errno %d", errno); + + return PI_BAD_FILE_WRITE; + } + return 0; +} + +int fileRead(unsigned handle, char *buf, unsigned count) +{ + int r; + + DBG(DBG_USER, "handle=%d count=%d buf=0x%"PRIXPTR, handle, count, (uintptr_t)buf); + + CHECK_INITED; + + if (handle >= PI_FILE_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (fileInfo[handle].state != PI_FILE_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (!count) + SOFT_ERROR(PI_BAD_PARAM, "bad count (%d)", count); + + if (!(fileInfo[handle].mode & PI_FILE_READ)) + SOFT_ERROR(PI_FILE_NOT_ROPEN, "file not opened for read"); + + r = read(fileInfo[handle].fd, buf, count); + + if (r == -1) + { + DBG(DBG_USER, "read failed with errno %d", errno); + return PI_BAD_FILE_READ; + } + else + { + buf[r] = 0; + return r; + } +} + + +int fileSeek(unsigned handle, int32_t seekOffset, int seekFrom) +{ + int whence, s; + + DBG(DBG_USER, "handle=%d offset=%d from=%d", + handle, seekOffset, seekFrom); + + CHECK_INITED; + + if (handle >= PI_FILE_SLOTS) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + if (fileInfo[handle].state != PI_FILE_OPENED) + SOFT_ERROR(PI_BAD_HANDLE, "bad handle (%d)", handle); + + switch (seekFrom) + { + case PI_FROM_START: + whence = SEEK_SET; + break; + + case PI_FROM_CURRENT: + whence = SEEK_CUR; + break; + + case PI_FROM_END: + whence = SEEK_END; + break; + + default: + SOFT_ERROR(PI_BAD_FILE_SEEK, "bad seek from (%d)", seekFrom); + } + + s = lseek(fileInfo[handle].fd, seekOffset, whence); + + if (s == -1) + { + DBG(DBG_USER, "seek failed with errno %d", errno); + return PI_BAD_FILE_SEEK; + } + + return s; +} + +int fileList(char *fpat, char *buf, unsigned count) +{ + int len, bufpos; + glob_t pglob; + int i; + + DBG(DBG_USER, "fpat=%s count=%d buf=%"PRIxPTR, fpat, count, (uintptr_t)buf); + + CHECK_INITED; + + if ((fileApprove(fpat) & PI_FILE_READ) != PI_FILE_READ) + SOFT_ERROR(PI_NO_FILE_ACCESS, "no permission to access file (%s)", fpat); + + bufpos = 0; + + if (glob(fpat, GLOB_MARK, NULL, &pglob) == 0) + { + for (i=0; i PI_TIME_ABSOLUTE) + SOFT_ERROR(PI_BAD_TIMETYPE, "bad timetype (%d)", timetype); + + if (timetype == PI_TIME_ABSOLUTE) + { + clock_gettime(CLOCK_REALTIME, &ts); + *seconds = ts.tv_sec; + *micros = ts.tv_nsec/1000; + } + else + { + clock_gettime(CLOCK_REALTIME, &ts); + + TIMER_SUB(&ts, &libStarted, &ts); + + *seconds = ts.tv_sec; + *micros = ts.tv_nsec/1000; + } + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioSleep(unsigned timetype, int seconds, int micros) +{ + struct timespec ts, rem; + + DBG(DBG_USER, "timetype=%d seconds=%d micros=%d", + timetype, seconds, micros); + + CHECK_INITED; + + if (timetype > PI_TIME_ABSOLUTE) + SOFT_ERROR(PI_BAD_TIMETYPE, "bad timetype (%d)", timetype); + + if (seconds < 0) + SOFT_ERROR(PI_BAD_SECONDS, "bad seconds (%d)", seconds); + + if ((micros < 0) || (micros > 999999)) + SOFT_ERROR(PI_BAD_MICROS, "bad micros (%d)", micros); + + ts.tv_sec = seconds; + ts.tv_nsec = micros * 1000; + + if (timetype == PI_TIME_ABSOLUTE) + { + while (clock_nanosleep(CLOCK_REALTIME, TIMER_ABSTIME, &ts, &rem)); + } + else + { + while (clock_nanosleep(CLOCK_REALTIME, 0, &ts, &rem)) + { + /* copy remaining time to ts */ + ts.tv_sec = rem.tv_sec; + ts.tv_nsec = rem.tv_nsec; + } + } + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t gpioDelay(uint32_t micros) +{ + uint32_t start; + + DBG(DBG_USER, "microseconds=%u", micros); + + CHECK_INITED; + + start = systReg[SYST_CLO]; + + if (micros <= PI_MAX_BUSY_DELAY) + while ((systReg[SYST_CLO] - start) <= micros); + else + gpioSleep(PI_TIME_RELATIVE, (micros/MILLION), (micros%MILLION)); + + return (systReg[SYST_CLO] - start); +} + + +/* ----------------------------------------------------------------------- */ + +uint32_t gpioTick(void) +{ + CHECK_INITED; + + return systReg[SYST_CLO]; +} + + +/* ----------------------------------------------------------------------- */ + +unsigned gpioVersion(void) +{ + DBG(DBG_USER, ""); + + return PIGPIO_VERSION; +} + + +/* ----------------------------------------------------------------------- */ + +/* +2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 +5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 + +W W S M M M B B B B P P P P T T T T T T T T R R R R + +W warranty void if either bit is set + +S 0=old (bits 0-22 are revision number) 1=new (following fields apply) + +M 0=256 1=512 2=1024 3=2GB 4=4GB + +B 0=Sony 1=Egoman 2=Embest 3=Sony Japan 4=Embest 5=Stadium + +P 0=2835, 1=2836, 2=2837 3=2711 + +T 0=A 1=B 2=A+ 3=B+ 4=Pi2B 5=Alpha 6=CM1 8=Pi3B 9=Zero a=CM3 c=Zero W + d=3B+ e=3A+ 10=CM3+ 11=4B + +R PCB board revision + +*/ + +unsigned gpioHardwareRevision(void) +{ + static unsigned rev = 0; + + FILE * filp; + char buf[512]; + char term; + + DBG(DBG_USER, ""); + + if (rev) return rev; + + filp = fopen ("/proc/cpuinfo", "r"); + + + if (filp != NULL) + { + while (fgets(buf, sizeof(buf), filp) != NULL) + { + if (!strncasecmp("revision\t:", buf, 10)) + { + if (sscanf(buf+10, "%x%c", &rev, &term) == 2) + { + if (term != '\n') rev = 0; + } + } + } + fclose(filp); + } + + /* (some) arm64 operating systems get revision number here */ + + if (rev == 0) + { + DBG(DBG_USER, "searching /proc/device-tree for revision"); + filp = fopen ("/proc/device-tree/system/linux,revision", "r"); + + if (filp != NULL) + { + uint32_t tmp; + if (fread(&tmp,1 , 4, filp) == 4) + { + /* + for some reason the value returned by reading + this /proc entry seems to be big endian, + convert it. + */ + rev = ntohl(tmp); + rev &= 0xFFFFFF; /* mask out warranty bit */ + } + fclose(filp); + } + } + + piCores = 0; + pi_ispi = 0; + rev &= 0xFFFFFF; /* mask out warranty bit */ + + /* Decode revision code */ + + if ((rev & 0x800000) == 0) /* old rev code */ + { + if ((rev > 0) && (rev < 0x0016)) /* all BCM2835 */ + { + pi_ispi = 1; + piCores = 1; + pi_peri_phys = 0x20000000; + pi_dram_bus = 0x40000000; + pi_mem_flag = 0x0C; + } + else + { + DBG(DBG_ALWAYS, "unknown revision=%x", rev); + rev = 0; + } + } + else /* new rev code */ + { + switch ((rev >> 12) & 0xF) /* just interested in BCM model */ + { + + case 0x0: /* BCM2835 */ + pi_ispi = 1; + piCores = 1; + pi_peri_phys = 0x20000000; + pi_dram_bus = 0x40000000; + pi_mem_flag = 0x0C; + break; + + case 0x1: /* BCM2836 */ + case 0x2: /* BCM2837 */ + pi_ispi = 1; + piCores = 4; + pi_peri_phys = 0x3F000000; + pi_dram_bus = 0xC0000000; + pi_mem_flag = 0x04; + break; + + case 0x3: /* BCM2711 */ + pi_ispi = 1; + piCores = 4; + pi_peri_phys = 0xFE000000; + pi_dram_bus = 0xC0000000; + pi_mem_flag = 0x04; + pi_is_2711 = 1; + clk_osc_freq = CLK_OSC_FREQ_2711; + clk_plld_freq = CLK_PLLD_FREQ_2711; + hw_pwm_max_freq = PI_HW_PWM_MAX_FREQ_2711; + hw_clk_min_freq = PI_HW_CLK_MIN_FREQ_2711; + hw_clk_max_freq = PI_HW_CLK_MAX_FREQ_2711; + break; + + default: + DBG(DBG_ALWAYS, "unknown rev code (%x)", rev); + rev=0; + pi_ispi = 0; + break; + } + } + + DBG(DBG_USER, "revision=%x", rev); + DBG(DBG_USER, "pi_peri_phys=%x", pi_peri_phys); + DBG(DBG_USER, "pi_dram_bus=%x", pi_dram_bus); + DBG(DBG_USER, "pi_mem_flag=%x", pi_mem_flag); + + return rev; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgBufferSize(unsigned millis) +{ + DBG(DBG_USER, "millis=%d", millis); + + CHECK_NOT_INITED; + + if ((millis < PI_BUF_MILLIS_MIN) || (millis > PI_BUF_MILLIS_MAX)) + SOFT_ERROR(PI_BAD_BUF_MILLIS, "bad millis (%d)", millis); + + gpioCfg.bufferMilliseconds = millis; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgClock(unsigned micros, unsigned peripheral, unsigned source) +{ + DBG(DBG_USER, "micros=%d peripheral=%d", micros, peripheral); + + CHECK_NOT_INITED; + + if ((micros < 1) || (micros > 10)) + SOFT_ERROR(PI_BAD_CLK_MICROS, "bad micros (%d)", micros); + + if (!clkCfg[micros].valid) + SOFT_ERROR(PI_BAD_CLK_MICROS, "bad micros (%d)", micros); + + if (peripheral > PI_CLOCK_PCM) + SOFT_ERROR(PI_BAD_CLK_PERIPH, "bad peripheral (%d)", peripheral); + + gpioCfg.clockMicros = micros; + gpioCfg.clockPeriph = peripheral; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgDMAchannel(unsigned DMAchannel) +{ + DBG(DBG_USER, "channel=%d", DMAchannel); + + CHECK_NOT_INITED; + + if ((DMAchannel < PI_MIN_DMA_CHANNEL) || (DMAchannel > PI_MAX_DMA_CHANNEL)) + SOFT_ERROR(PI_BAD_CHANNEL, "bad channel (%d)", DMAchannel); + + gpioCfg.DMAprimaryChannel = DMAchannel; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgDMAchannels(unsigned primaryChannel, unsigned secondaryChannel) +{ + DBG(DBG_USER, "primary channel=%d, secondary channel=%d", + primaryChannel, secondaryChannel); + + CHECK_NOT_INITED; + + if (primaryChannel > PI_MAX_DMA_CHANNEL) + SOFT_ERROR(PI_BAD_PRIM_CHANNEL, "bad primary channel (%d)", + primaryChannel); + + if ((secondaryChannel > PI_MAX_DMA_CHANNEL) || + ((secondaryChannel == primaryChannel) && + (secondaryChannel != PI_DEFAULT_DMA_NOT_SET))) + SOFT_ERROR(PI_BAD_SECO_CHANNEL, "bad secondary channel (%d)", + secondaryChannel); + + gpioCfg.DMAprimaryChannel = primaryChannel; + gpioCfg.DMAsecondaryChannel = secondaryChannel; + + return 0; +} + + +/*-------------------------------------------------------------------------*/ + +int gpioCfgPermissions(uint64_t updateMask) +{ + DBG(DBG_USER, "gpio update mask=%"PRIX64, updateMask); + + CHECK_NOT_INITED; + + gpioMask = updateMask; + + gpioMaskSet = 1; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgInterfaces(unsigned ifFlags) +{ + DBG(DBG_USER, "ifFlags=%X", ifFlags); + + CHECK_NOT_INITED; + + if (ifFlags > 15) + SOFT_ERROR(PI_BAD_IF_FLAGS, "bad ifFlags (%X)", ifFlags); + + gpioCfg.ifFlags = ifFlags; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioCfgSocketPort(unsigned port) +{ + DBG(DBG_USER, "port=%d", port); + + CHECK_NOT_INITED; + + if ((port < PI_MIN_SOCKET_PORT) || (port > PI_MAX_SOCKET_PORT)) + SOFT_ERROR(PI_BAD_SOCKET_PORT, "bad port (%d)", port); + + gpioCfg.socketPort = port; + + return 0; +} + + +/* ----------------------------------------------------------------------- */ + +int gpioCfgMemAlloc(unsigned memAllocMode) +{ + DBG(DBG_USER, "memAllocMode=%d", memAllocMode); + + CHECK_NOT_INITED; + + if (memAllocMode > PI_MEM_ALLOC_MAILBOX) + SOFT_ERROR( + PI_BAD_MALLOC_MODE, "bad mem alloc mode (%d)", memAllocMode); + + gpioCfg.memAllocMode = memAllocMode; + + return 0; +} + +/* ----------------------------------------------------------------------- */ + +int gpioCfgNetAddr(int numSockAddr, uint32_t *sockAddr) +{ + int i; + + DBG(DBG_USER, "numSockAddr=%d sockAddr=%08"PRIXPTR, + numSockAddr, (uintptr_t)sockAddr); + + CHECK_NOT_INITED; + + if (numSockAddr <= 0) numSockNetAddr = 0; + else + { + if (numSockAddr >= MAX_CONNECT_ADDRESSES) + numSockAddr = MAX_CONNECT_ADDRESSES; + + for (i=0; i>4) & 0xF; + return 0; +} + + +/* include any user customisations */ + +#include "custom.cext" + diff --git a/pigpio-master/pigpio.h b/pigpio-master/pigpio.h new file mode 100644 index 0000000..1b8e51c --- /dev/null +++ b/pigpio-master/pigpio.h @@ -0,0 +1,6572 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +#ifndef PIGPIO_H +#define PIGPIO_H + +#include +#include +#include + +#define PIGPIO_VERSION 79 + +/*TEXT + +pigpio is a C library for the Raspberry which allows control of the GPIO. + +*Features* + +o hardware timed PWM on any of GPIO 0-31 + +o hardware timed servo pulses on any of GPIO 0-31 + +o callbacks when any of GPIO 0-31 change state + +o callbacks at timed intervals + +o reading/writing all of the GPIO in a bank as one operation + +o individually setting GPIO modes, reading and writing + +o notifications when any of GPIO 0-31 change state + +o the construction of output waveforms with microsecond timing + +o rudimentary permission control over GPIO + +o a simple interface to start and stop new threads + +o I2C, SPI, and serial link wrappers + +o creating and running scripts + +*GPIO* + +ALL GPIO are identified by their Broadcom number. + +*Credits* + +The PWM and servo pulses are timed using the DMA and PWM peripherals. + +This use was inspired by Richard Hirst's servoblaster kernel module. + +*Usage* + +Include in your source files. + +Assuming your source is in prog.c use the following command to build and +run the executable. + +. . +gcc -Wall -pthread -o prog prog.c -lpigpio -lrt +sudo ./prog +. . + +For examples of usage see the C programs within the pigpio archive file. + +*Notes* + +All the functions which return an int return < 0 on error. + +[*gpioInitialise*] must be called before all other library functions +with the following exceptions: + +. . +[*gpioCfg**] +[*gpioVersion*] +[*gpioHardwareRevision*] +. . + +If the library is not initialised all but the [*gpioCfg**], +[*gpioVersion*], and [*gpioHardwareRevision*] functions will +return error PI_NOT_INITIALISED. + +If the library is initialised the [*gpioCfg**] functions will return +error PI_INITIALISED. + +If you intend to rely on signals sent to your application, you should +turn off the internal signal handling as shown in this example: + +. . +int cfg = gpioCfgGetInternals(); +cfg |= PI_CFG_NOSIGHANDLER; // (1<<10) +gpioCfgSetInternals(cfg); +int status = gpioInitialise(); +. . + +TEXT*/ + +/*OVERVIEW + +ESSENTIAL + +gpioInitialise Initialise library +gpioTerminate Stop library + +BASIC + +gpioSetMode Set a GPIO mode +gpioGetMode Get a GPIO mode + +gpioSetPullUpDown Set/clear GPIO pull up/down resistor + +gpioRead Read a GPIO +gpioWrite Write a GPIO + +PWM_(overrides_servo_commands_on_same_GPIO) + +gpioPWM Start/stop PWM pulses on a GPIO +gpioSetPWMfrequency Configure PWM frequency for a GPIO +gpioSetPWMrange Configure PWM range for a GPIO + +gpioGetPWMdutycycle Get dutycycle setting on a GPIO +gpioGetPWMfrequency Get configured PWM frequency for a GPIO +gpioGetPWMrange Get configured PWM range for a GPIO + +gpioGetPWMrealRange Get underlying PWM range for a GPIO + +Servo_(overrides_PWM_commands_on_same_GPIO) + +gpioServo Start/stop servo pulses on a GPIO + +gpioGetServoPulsewidth Get pulsewidth setting on a GPIO + +INTERMEDIATE + +gpioTrigger Send a trigger pulse to a GPIO + +gpioSetWatchdog Set a watchdog on a GPIO + +gpioRead_Bits_0_31 Read all GPIO in bank 1 +gpioRead_Bits_32_53 Read all GPIO in bank 2 + +gpioWrite_Bits_0_31_Clear Clear selected GPIO in bank 1 +gpioWrite_Bits_32_53_Clear Clear selected GPIO in bank 2 + +gpioWrite_Bits_0_31_Set Set selected GPIO in bank 1 +gpioWrite_Bits_32_53_Set Set selected GPIO in bank 2 + +gpioSetAlertFunc Request a GPIO level change callback +gpioSetAlertFuncEx Request a GPIO change callback, extended + +gpioSetTimerFunc Request a regular timed callback +gpioSetTimerFuncEx Request a regular timed callback, extended + +gpioStartThread Start a new thread +gpioStopThread Stop a previously started thread + +ADVANCED + +gpioNotifyOpen Request a notification handle +gpioNotifyClose Close a notification +gpioNotifyOpenWithSize Request a notification with sized pipe +gpioNotifyBegin Start notifications for selected GPIO +gpioNotifyPause Pause notifications + +gpioHardwareClock Start hardware clock on supported GPIO + +gpioHardwarePWM Start hardware PWM on supported GPIO + +gpioGlitchFilter Set a glitch filter on a GPIO +gpioNoiseFilter Set a noise filter on a GPIO + +gpioSetPad Sets a pads drive strength +gpioGetPad Gets a pads drive strength + +shell Executes a shell command + +gpioSetISRFunc Request a GPIO interrupt callback +gpioSetISRFuncEx Request a GPIO interrupt callback, extended + +gpioSetSignalFunc Request a signal callback +gpioSetSignalFuncEx Request a signal callback, extended + +gpioSetGetSamplesFunc Requests a GPIO samples callback +gpioSetGetSamplesFuncEx Requests a GPIO samples callback, extended + +Custom + +gpioCustom1 User custom function 1 +gpioCustom2 User custom function 2 + +Events + +eventMonitor Sets the events to monitor +eventSetFunc Request an event callback +eventSetFuncEx Request an event callback, extended + +eventTrigger Trigger an event + +Scripts + +gpioStoreScript Store a script +gpioRunScript Run a stored script +gpioUpdateScript Set a scripts parameters +gpioScriptStatus Get script status and parameters +gpioStopScript Stop a running script +gpioDeleteScript Delete a stored script + +I2C + +i2cOpen Opens an I2C device +i2cClose Closes an I2C device + +i2cWriteQuick SMBus write quick + +i2cReadByte SMBus read byte +i2cWriteByte SMBus write byte + +i2cReadByteData SMBus read byte data +i2cWriteByteData SMBus write byte data + +i2cReadWordData SMBus read word data +i2cWriteWordData SMBus write word data + +i2cReadBlockData SMBus read block data +i2cWriteBlockData SMBus write block data + +i2cReadI2CBlockData SMBus read I2C block data +i2cWriteI2CBlockData SMBus write I2C block data + +i2cReadDevice Reads the raw I2C device +i2cWriteDevice Writes the raw I2C device + +i2cProcessCall SMBus process call +i2cBlockProcessCall SMBus block process call + +i2cSwitchCombined Sets or clears the combined flag + +i2cSegments Performs multiple I2C transactions + +i2cZip Performs multiple I2C transactions + +I2C_BIT_BANG + +bbI2COpen Opens GPIO for bit banging I2C +bbI2CClose Closes GPIO for bit banging I2C + +bbI2CZip Performs bit banged I2C transactions + +I2C/SPI_SLAVE + +bscXfer I2C/SPI as slave transfer + +SERIAL + +serOpen Opens a serial device +serClose Closes a serial device + +serReadByte Reads a byte from a serial device +serWriteByte Writes a byte to a serial device + +serRead Reads bytes from a serial device +serWrite Writes bytes to a serial device + +serDataAvailable Returns number of bytes ready to be read + +SERIAL_BIT_BANG_(read_only) + +gpioSerialReadOpen Opens a GPIO for bit bang serial reads +gpioSerialReadClose Closes a GPIO for bit bang serial reads + +gpioSerialReadInvert Configures normal/inverted for serial reads + +gpioSerialRead Reads bit bang serial data from a GPIO + +SPI + +spiOpen Opens a SPI device +spiClose Closes a SPI device + +spiRead Reads bytes from a SPI device +spiWrite Writes bytes to a SPI device +spiXfer Transfers bytes with a SPI device + +SPI_BIT_BANG + +bbSPIOpen Opens GPIO for bit banging SPI +bbSPIClose Closes GPIO for bit banging SPI + +bbSPIXfer Performs bit banged SPI transactions + +FILES + +fileOpen Opens a file +fileClose Closes a file + +fileRead Reads bytes from a file +fileWrite Writes bytes to a file + +fileSeek Seeks to a position within a file + +fileList List files which match a pattern + +WAVES + +gpioWaveClear Deletes all waveforms + +gpioWaveAddNew Starts a new waveform +gpioWaveAddGeneric Adds a series of pulses to the waveform +gpioWaveAddSerial Adds serial data to the waveform + +gpioWaveCreate Creates a waveform from added data +gpioWaveCreatePad Creates a waveform of fixed size from added data +gpioWaveDelete Deletes a waveform + +gpioWaveTxSend Transmits a waveform + +gpioWaveChain Transmits a chain of waveforms + +gpioWaveTxAt Returns the current transmitting waveform + +gpioWaveTxBusy Checks to see if the waveform has ended + +gpioWaveTxStop Aborts the current waveform + +gpioWaveGetCbs Length in CBs of the current waveform +gpioWaveGetHighCbs Length of longest waveform so far +gpioWaveGetMaxCbs Absolute maximum allowed CBs + +gpioWaveGetMicros Length in micros of the current waveform +gpioWaveGetHighMicros Length of longest waveform so far +gpioWaveGetMaxMicros Absolute maximum allowed micros + +gpioWaveGetPulses Length in pulses of the current waveform +gpioWaveGetHighPulses Length of longest waveform so far +gpioWaveGetMaxPulses Absolute maximum allowed pulses + +UTILITIES + +gpioDelay Delay for a number of microseconds + +gpioTick Get current tick (microseconds) + +gpioHardwareRevision Get hardware revision +gpioVersion Get the pigpio version + +getBitInBytes Get the value of a bit +putBitInBytes Set the value of a bit + +gpioTime Get current time +gpioSleep Sleep for specified time + +time_sleep Sleeps for a float number of seconds +time_time Float number of seconds since the epoch + +CONFIGURATION + +gpioCfgBufferSize Configure the GPIO sample buffer size +gpioCfgClock Configure the GPIO sample rate +gpioCfgDMAchannel Configure the DMA channel (DEPRECATED) +gpioCfgDMAchannels Configure the DMA channels +gpioCfgPermissions Configure the GPIO access permissions +gpioCfgInterfaces Configure user interfaces +gpioCfgSocketPort Configure socket port +gpioCfgMemAlloc Configure DMA memory allocation mode +gpioCfgNetAddr Configure allowed network addresses + +gpioCfgGetInternals Get internal configuration settings +gpioCfgSetInternals Set internal configuration settings + +EXPERT + +rawWaveAddSPI Not intended for general use +rawWaveAddGeneric Not intended for general use +rawWaveCB Not intended for general use +rawWaveCBAdr Not intended for general use +rawWaveGetOOL Not intended for general use +rawWaveSetOOL Not intended for general use +rawWaveGetOut Not intended for general use +rawWaveSetOut Not intended for general use +rawWaveGetIn Not intended for general use +rawWaveSetIn Not intended for general use +rawWaveInfo Not intended for general use +rawDumpWave Not intended for general use +rawDumpScript Not intended for general use + +OVERVIEW*/ + +#define PI_INPFIFO "/dev/pigpio" +#define PI_OUTFIFO "/dev/pigout" +#define PI_ERRFIFO "/dev/pigerr" + +#define PI_ENVPORT "PIGPIO_PORT" +#define PI_ENVADDR "PIGPIO_ADDR" + +#define PI_LOCKFILE "/var/run/pigpio.pid" + +#define PI_I2C_COMBINED "/sys/module/i2c_bcm2708/parameters/combined" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct +{ + uint16_t func; + uint16_t size; +} gpioHeader_t; + +typedef struct +{ + size_t size; + void *ptr; + uint32_t data; +} gpioExtent_t; + +typedef struct +{ + uint32_t tick; + uint32_t level; +} gpioSample_t; + +typedef struct +{ + uint16_t seqno; + uint16_t flags; + uint32_t tick; + uint32_t level; +} gpioReport_t; + +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; +} gpioPulse_t; + +#define WAVE_FLAG_READ 1 +#define WAVE_FLAG_TICK 2 + +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; + uint32_t flags; +} rawWave_t; + +/* +CBs are used in order from the lowest numbered CB up to +the maximum NUM_WAVE_CBS. + +OOLS are used from the bottom climbing up and from +the top climbing down. + +The GPIO on and off settings climb up from the bottom (botOOL/numBOOL). + +The level and tick read values are stored in descending locations +from the top (topOOL/numTOOL). +*/ + +typedef struct +{ + uint16_t botCB; /* first CB used by wave */ + uint16_t topCB; /* last CB used by wave */ + uint16_t botOOL; /* first bottom OOL used by wave */ + /* botOOL to botOOL + numBOOL - 1 are in use */ + uint16_t topOOL; /* last top OOL used by wave */ + /* topOOL - numTOOL to topOOL are in use.*/ + uint16_t deleted; + uint16_t numCB; + uint16_t numBOOL; + uint16_t numTOOL; +} rawWaveInfo_t; + +typedef struct +{ + int clk; /* GPIO for clock */ + int mosi; /* GPIO for MOSI */ + int miso; /* GPIO for MISO */ + int ss_pol; /* slave select off state */ + int ss_us; /* delay after slave select */ + int clk_pol; /* clock off state */ + int clk_pha; /* clock phase */ + int clk_us; /* clock micros */ +} rawSPI_t; + +typedef struct { /* linux/arch/arm/mach-bcm2708/include/mach/dma.h */ + uint32_t info; + uint32_t src; + uint32_t dst; + uint32_t length; + uint32_t stride; + uint32_t next; + uint32_t pad[2]; +} rawCbs_t; + +typedef struct +{ + uint16_t addr; /* slave address */ + uint16_t flags; + uint16_t len; /* msg length */ + uint8_t *buf; /* pointer to msg data */ +} pi_i2c_msg_t; + +/* BSC FIFO size */ + +#define BSC_FIFO_SIZE 512 + +typedef struct +{ + uint32_t control; /* Write */ + int rxCnt; /* Read only */ + char rxBuf[BSC_FIFO_SIZE]; /* Read only */ + int txCnt; /* Write */ + char txBuf[BSC_FIFO_SIZE]; /* Write */ +} bsc_xfer_t; + + +typedef void (*gpioAlertFunc_t) (int gpio, + int level, + uint32_t tick); + +typedef void (*gpioAlertFuncEx_t) (int gpio, + int level, + uint32_t tick, + void *userdata); + +typedef void (*eventFunc_t) (int event, + uint32_t tick); + +typedef void (*eventFuncEx_t) (int event, + uint32_t tick, + void *userdata); + +typedef void (*gpioISRFunc_t) (int gpio, + int level, + uint32_t tick); + +typedef void (*gpioISRFuncEx_t) (int gpio, + int level, + uint32_t tick, + void *userdata); + +typedef void (*gpioTimerFunc_t) (void); + +typedef void (*gpioTimerFuncEx_t) (void *userdata); + +typedef void (*gpioSignalFunc_t) (int signum); + +typedef void (*gpioSignalFuncEx_t) (int signum, + void *userdata); + +typedef void (*gpioGetSamplesFunc_t) (const gpioSample_t *samples, + int numSamples); + +typedef void (*gpioGetSamplesFuncEx_t) (const gpioSample_t *samples, + int numSamples, + void *userdata); + +typedef void *(gpioThreadFunc_t) (void *); + + +/* gpio: 0-53 */ + +#define PI_MIN_GPIO 0 +#define PI_MAX_GPIO 53 + +/* user_gpio: 0-31 */ + +#define PI_MAX_USER_GPIO 31 + +/* level: 0-1 */ + +#define PI_OFF 0 +#define PI_ON 1 + +#define PI_CLEAR 0 +#define PI_SET 1 + +#define PI_LOW 0 +#define PI_HIGH 1 + +/* level: only reported for GPIO time-out, see gpioSetWatchdog */ + +#define PI_TIMEOUT 2 + +/* mode: 0-7 */ + +#define PI_INPUT 0 +#define PI_OUTPUT 1 +#define PI_ALT0 4 +#define PI_ALT1 5 +#define PI_ALT2 6 +#define PI_ALT3 7 +#define PI_ALT4 3 +#define PI_ALT5 2 + +/* pud: 0-2 */ + +#define PI_PUD_OFF 0 +#define PI_PUD_DOWN 1 +#define PI_PUD_UP 2 + +/* dutycycle: 0-range */ + +#define PI_DEFAULT_DUTYCYCLE_RANGE 255 + +/* range: 25-40000 */ + +#define PI_MIN_DUTYCYCLE_RANGE 25 +#define PI_MAX_DUTYCYCLE_RANGE 40000 + +/* pulsewidth: 0, 500-2500 */ + +#define PI_SERVO_OFF 0 +#define PI_MIN_SERVO_PULSEWIDTH 500 +#define PI_MAX_SERVO_PULSEWIDTH 2500 + +/* hardware PWM */ + +#define PI_HW_PWM_MIN_FREQ 1 +#define PI_HW_PWM_MAX_FREQ 125000000 +#define PI_HW_PWM_MAX_FREQ_2711 187500000 +#define PI_HW_PWM_RANGE 1000000 + +/* hardware clock */ + +#define PI_HW_CLK_MIN_FREQ 4689 +#define PI_HW_CLK_MIN_FREQ_2711 13184 +#define PI_HW_CLK_MAX_FREQ 250000000 +#define PI_HW_CLK_MAX_FREQ_2711 375000000 + +#define PI_NOTIFY_SLOTS 32 + +#define PI_NTFY_FLAGS_EVENT (1 <<7) +#define PI_NTFY_FLAGS_ALIVE (1 <<6) +#define PI_NTFY_FLAGS_WDOG (1 <<5) +#define PI_NTFY_FLAGS_BIT(x) (((x)<<0)&31) + +#define PI_WAVE_BLOCKS 4 +#define PI_WAVE_MAX_PULSES (PI_WAVE_BLOCKS * 3000) +#define PI_WAVE_MAX_CHARS (PI_WAVE_BLOCKS * 300) + +#define PI_BB_I2C_MIN_BAUD 50 +#define PI_BB_I2C_MAX_BAUD 500000 + +#define PI_BB_SPI_MIN_BAUD 50 +#define PI_BB_SPI_MAX_BAUD 250000 + +#define PI_BB_SER_MIN_BAUD 50 +#define PI_BB_SER_MAX_BAUD 250000 + +#define PI_BB_SER_NORMAL 0 +#define PI_BB_SER_INVERT 1 + +#define PI_WAVE_MIN_BAUD 50 +#define PI_WAVE_MAX_BAUD 1000000 + +#define PI_SPI_MIN_BAUD 32000 +#define PI_SPI_MAX_BAUD 125000000 + +#define PI_MIN_WAVE_DATABITS 1 +#define PI_MAX_WAVE_DATABITS 32 + +#define PI_MIN_WAVE_HALFSTOPBITS 2 +#define PI_MAX_WAVE_HALFSTOPBITS 8 + +#define PI_WAVE_MAX_MICROS (30 * 60 * 1000000) /* half an hour */ + +#define PI_MAX_WAVES 250 + +#define PI_MAX_WAVE_CYCLES 65535 +#define PI_MAX_WAVE_DELAY 65535 + +#define PI_WAVE_COUNT_PAGES 10 + +/* wave tx mode */ + +#define PI_WAVE_MODE_ONE_SHOT 0 +#define PI_WAVE_MODE_REPEAT 1 +#define PI_WAVE_MODE_ONE_SHOT_SYNC 2 +#define PI_WAVE_MODE_REPEAT_SYNC 3 + +/* special wave at return values */ + +#define PI_WAVE_NOT_FOUND 9998 /* Transmitted wave not found. */ +#define PI_NO_TX_WAVE 9999 /* No wave being transmitted. */ + +/* Files, I2C, SPI, SER */ + +#define PI_FILE_SLOTS 16 +#define PI_I2C_SLOTS 512 +#define PI_SPI_SLOTS 32 +#define PI_SER_SLOTS 16 + +#define PI_MAX_I2C_ADDR 0x7F + +#define PI_NUM_AUX_SPI_CHANNEL 3 +#define PI_NUM_STD_SPI_CHANNEL 2 + +#define PI_MAX_I2C_DEVICE_COUNT (1<<16) +#define PI_MAX_SPI_DEVICE_COUNT (1<<16) + +/* max pi_i2c_msg_t per transaction */ + +#define PI_I2C_RDRW_IOCTL_MAX_MSGS 42 + +/* flags for i2cTransaction, pi_i2c_msg_t */ + +#define PI_I2C_M_WR 0x0000 /* write data */ +#define PI_I2C_M_RD 0x0001 /* read data */ +#define PI_I2C_M_TEN 0x0010 /* ten bit chip address */ +#define PI_I2C_M_RECV_LEN 0x0400 /* length will be first received byte */ +#define PI_I2C_M_NO_RD_ACK 0x0800 /* if I2C_FUNC_PROTOCOL_MANGLING */ +#define PI_I2C_M_IGNORE_NAK 0x1000 /* if I2C_FUNC_PROTOCOL_MANGLING */ +#define PI_I2C_M_REV_DIR_ADDR 0x2000 /* if I2C_FUNC_PROTOCOL_MANGLING */ +#define PI_I2C_M_NOSTART 0x4000 /* if I2C_FUNC_PROTOCOL_MANGLING */ + +/* bbI2CZip and i2cZip commands */ + +#define PI_I2C_END 0 +#define PI_I2C_ESC 1 +#define PI_I2C_START 2 +#define PI_I2C_COMBINED_ON 2 +#define PI_I2C_STOP 3 +#define PI_I2C_COMBINED_OFF 3 +#define PI_I2C_ADDR 4 +#define PI_I2C_FLAGS 5 +#define PI_I2C_READ 6 +#define PI_I2C_WRITE 7 + +/* SPI */ + +#define PI_SPI_FLAGS_BITLEN(x) ((x&63)<<16) +#define PI_SPI_FLAGS_RX_LSB(x) ((x&1)<<15) +#define PI_SPI_FLAGS_TX_LSB(x) ((x&1)<<14) +#define PI_SPI_FLAGS_3WREN(x) ((x&15)<<10) +#define PI_SPI_FLAGS_3WIRE(x) ((x&1)<<9) +#define PI_SPI_FLAGS_AUX_SPI(x) ((x&1)<<8) +#define PI_SPI_FLAGS_RESVD(x) ((x&7)<<5) +#define PI_SPI_FLAGS_CSPOLS(x) ((x&7)<<2) +#define PI_SPI_FLAGS_MODE(x) ((x&3)) + +/* BSC registers */ + +#define BSC_DR 0 +#define BSC_RSR 1 +#define BSC_SLV 2 +#define BSC_CR 3 +#define BSC_FR 4 +#define BSC_IFLS 5 +#define BSC_IMSC 6 +#define BSC_RIS 7 +#define BSC_MIS 8 +#define BSC_ICR 9 +#define BSC_DMACR 10 +#define BSC_TDR 11 +#define BSC_GPUSTAT 12 +#define BSC_HCTRL 13 +#define BSC_DEBUG_I2C 14 +#define BSC_DEBUG_SPI 15 + +#define BSC_CR_TESTFIFO 2048 +#define BSC_CR_RXE 512 +#define BSC_CR_TXE 256 +#define BSC_CR_BRK 128 +#define BSC_CR_CPOL 16 +#define BSC_CR_CPHA 8 +#define BSC_CR_I2C 4 +#define BSC_CR_SPI 2 +#define BSC_CR_EN 1 + +#define BSC_FR_RXBUSY 32 +#define BSC_FR_TXFE 16 +#define BSC_FR_RXFF 8 +#define BSC_FR_TXFF 4 +#define BSC_FR_RXFE 2 +#define BSC_FR_TXBUSY 1 + +/* BSC GPIO */ + +#define BSC_SDA 18 +#define BSC_MOSI 20 +#define BSC_SCL_SCLK 19 +#define BSC_MISO 18 +#define BSC_CE_N 21 + +#define BSC_SDA_2711 10 +#define BSC_MOSI_2711 9 +#define BSC_SCL_SCLK_2711 11 +#define BSC_MISO_2711 10 +#define BSC_CE_N_2711 8 + +/* Longest busy delay */ + +#define PI_MAX_BUSY_DELAY 100 + +/* timeout: 0-60000 */ + +#define PI_MIN_WDOG_TIMEOUT 0 +#define PI_MAX_WDOG_TIMEOUT 60000 + +/* timer: 0-9 */ + +#define PI_MIN_TIMER 0 +#define PI_MAX_TIMER 9 + +/* millis: 10-60000 */ + +#define PI_MIN_MS 10 +#define PI_MAX_MS 60000 + +#define PI_MAX_SCRIPTS 32 + +#define PI_MAX_SCRIPT_TAGS 50 +#define PI_MAX_SCRIPT_VARS 150 +#define PI_MAX_SCRIPT_PARAMS 10 + +/* script status */ + +#define PI_SCRIPT_INITING 0 +#define PI_SCRIPT_HALTED 1 +#define PI_SCRIPT_RUNNING 2 +#define PI_SCRIPT_WAITING 3 +#define PI_SCRIPT_FAILED 4 + +/* signum: 0-63 */ + +#define PI_MIN_SIGNUM 0 +#define PI_MAX_SIGNUM 63 + +/* timetype: 0-1 */ + +#define PI_TIME_RELATIVE 0 +#define PI_TIME_ABSOLUTE 1 + +#define PI_MAX_MICS_DELAY 1000000 /* 1 second */ +#define PI_MAX_MILS_DELAY 60000 /* 60 seconds */ + +/* cfgMillis */ + +#define PI_BUF_MILLIS_MIN 100 +#define PI_BUF_MILLIS_MAX 10000 + +/* cfgMicros: 1, 2, 4, 5, 8, or 10 */ + +/* cfgPeripheral: 0-1 */ + +#define PI_CLOCK_PWM 0 +#define PI_CLOCK_PCM 1 + +/* DMA channel: 0-15, 15 is unset */ + +#define PI_MIN_DMA_CHANNEL 0 +#define PI_MAX_DMA_CHANNEL 15 + +/* port */ + +#define PI_MIN_SOCKET_PORT 1024 +#define PI_MAX_SOCKET_PORT 32000 + + +/* ifFlags: */ + +#define PI_DISABLE_FIFO_IF 1 +#define PI_DISABLE_SOCK_IF 2 +#define PI_LOCALHOST_SOCK_IF 4 +#define PI_DISABLE_ALERT 8 + +/* memAllocMode */ + +#define PI_MEM_ALLOC_AUTO 0 +#define PI_MEM_ALLOC_PAGEMAP 1 +#define PI_MEM_ALLOC_MAILBOX 2 + +/* filters */ + +#define PI_MAX_STEADY 300000 +#define PI_MAX_ACTIVE 1000000 + +/* gpioCfgInternals */ + +#define PI_CFG_DBG_LEVEL 0 /* bits 0-3 */ +#define PI_CFG_ALERT_FREQ 4 /* bits 4-7 */ +#define PI_CFG_RT_PRIORITY (1<<8) +#define PI_CFG_STATS (1<<9) +#define PI_CFG_NOSIGHANDLER (1<<10) + +#define PI_CFG_ILLEGAL_VAL (1<<11) + + +/* gpioISR */ + +#define RISING_EDGE 0 +#define FALLING_EDGE 1 +#define EITHER_EDGE 2 + + +/* pads */ + +#define PI_MAX_PAD 2 + +#define PI_MIN_PAD_STRENGTH 1 +#define PI_MAX_PAD_STRENGTH 16 + +/* files */ + +#define PI_FILE_NONE 0 +#define PI_FILE_MIN 1 +#define PI_FILE_READ 1 +#define PI_FILE_WRITE 2 +#define PI_FILE_RW 3 +#define PI_FILE_APPEND 4 +#define PI_FILE_CREATE 8 +#define PI_FILE_TRUNC 16 +#define PI_FILE_MAX 31 + +#define PI_FROM_START 0 +#define PI_FROM_CURRENT 1 +#define PI_FROM_END 2 + +/* Allowed socket connect addresses */ + +#define MAX_CONNECT_ADDRESSES 256 + +/* events */ + +#define PI_MAX_EVENT 31 + +/* Event auto generated on BSC slave activity */ + +#define PI_EVENT_BSC 31 + +/*F*/ +int gpioInitialise(void); +/*D +Initialises the library. + +Returns the pigpio version number if OK, otherwise PI_INIT_FAILED. + +gpioInitialise must be called before using the other library functions +with the following exceptions: + +. . +[*gpioCfg**] +[*gpioVersion*] +[*gpioHardwareRevision*] +. . + +... +if (gpioInitialise() < 0) +{ + // pigpio initialisation failed. +} +else +{ + // pigpio initialised okay. +} +... +D*/ + + +/*F*/ +void gpioTerminate(void); +/*D +Terminates the library. + +Returns nothing. + +Call before program exit. + +This function resets the used DMA channels, releases memory, and +terminates any running threads. + +... +gpioTerminate(); +... +D*/ + + +/*F*/ +int gpioSetMode(unsigned gpio, unsigned mode); +/*D +Sets the GPIO mode, typically input or output. + +. . +gpio: 0-53 +mode: 0-7 +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_MODE. + +Arduino style: pinMode. + +... +gpioSetMode(17, PI_INPUT); // Set GPIO17 as input. + +gpioSetMode(18, PI_OUTPUT); // Set GPIO18 as output. + +gpioSetMode(22,PI_ALT0); // Set GPIO22 to alternative mode 0. +... + +See [[http://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2835/BCM2835-ARM-Peripherals.pdf]] page 102 for an overview of the modes. +D*/ + + +/*F*/ +int gpioGetMode(unsigned gpio); +/*D +Gets the GPIO mode. + +. . +gpio: 0-53 +. . + +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. + +... +if (gpioGetMode(17) != PI_ALT0) +{ + gpioSetMode(17, PI_ALT0); // set GPIO17 to ALT0 +} +... +D*/ + + +/*F*/ +int gpioSetPullUpDown(unsigned gpio, unsigned pud); +/*D +Sets or clears resistor pull ups or downs on the GPIO. + +. . +gpio: 0-53 + pud: 0-2 +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_PUD. + +... +gpioSetPullUpDown(17, PI_PUD_UP); // Sets a pull-up. + +gpioSetPullUpDown(18, PI_PUD_DOWN); // Sets a pull-down. + +gpioSetPullUpDown(23, PI_PUD_OFF); // Clear any pull-ups/downs. +... +D*/ + + +/*F*/ +int gpioRead (unsigned gpio); +/*D +Reads the GPIO level, on or off. + +. . +gpio: 0-53 +. . + +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. + +Arduino style: digitalRead. + +... +printf("GPIO24 is level %d", gpioRead(24)); +... +D*/ + + +/*F*/ +int gpioWrite(unsigned gpio, unsigned level); +/*D +Sets the GPIO level, on or off. + +. . + gpio: 0-53 +level: 0-1 +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO or PI_BAD_LEVEL. + +If PWM or servo pulses are active on the GPIO they are switched off. + +Arduino style: digitalWrite + +... +gpioWrite(24, 1); // Set GPIO24 high. +... +D*/ + + +/*F*/ +int gpioPWM(unsigned user_gpio, unsigned dutycycle); +/*D +Starts PWM on the GPIO, dutycycle between 0 (off) and range (fully on). +Range defaults to 255. + +. . +user_gpio: 0-31 +dutycycle: 0-range +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_DUTYCYCLE. + +Arduino style: analogWrite + +This and the servo functionality use the DMA and PWM or PCM peripherals +to control and schedule the pulse lengths and dutycycles. + +The [*gpioSetPWMrange*] function may be used to change the default +range of 255. + +... +gpioPWM(17, 255); // Sets GPIO17 full on. + +gpioPWM(18, 128); // Sets GPIO18 half on. + +gpioPWM(23, 0); // Sets GPIO23 full off. +... +D*/ + + +/*F*/ +int gpioGetPWMdutycycle(unsigned user_gpio); +/*D +Returns the PWM dutycycle setting for the GPIO. + +. . +user_gpio: 0-31 +. . + +Returns between 0 (off) and range (fully on) if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see [*gpioGetPWMrange*]). + +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +Normal PWM range defaults to 255. +D*/ + + +/*F*/ +int gpioSetPWMrange(unsigned user_gpio, unsigned range); +/*D +Selects the dutycycle range to be used for the GPIO. Subsequent calls +to gpioPWM will use a dutycycle between 0 (off) and range (fully on). + +. . +user_gpio: 0-31 + range: 25-40000 +. . + +Returns the real range for the given GPIO's frequency if OK, +otherwise PI_BAD_USER_GPIO or PI_BAD_DUTYRANGE. + +If PWM is currently active on the GPIO its dutycycle will be scaled +to reflect the new range. + +The real range, the number of steps between fully off and fully +on for each frequency, is given in the following table. + +. . + 25, 50, 100, 125, 200, 250, 400, 500, 625, + 800, 1000, 1250, 2000, 2500, 4000, 5000, 10000, 20000 +. . + +The real value set by [*gpioPWM*] is (dutycycle * real range) / range. + +... +gpioSetPWMrange(24, 2000); // Now 2000 is fully on + // 1000 is half on + // 500 is quarter on, etc. +... +D*/ + + +/*F*/ +int gpioGetPWMrange(unsigned user_gpio); +/*D +Returns the dutycycle range used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +. . +user_gpio: 0-31 +. . + +If a hardware clock or hardware PWM is active on the GPIO +the reported range will be 1000000 (1M). + +... +r = gpioGetPWMrange(23); +... +D*/ + + +/*F*/ +int gpioGetPWMrealRange(unsigned user_gpio); +/*D +Returns the real range used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +. . +user_gpio: 0-31 +. . + +If a hardware clock is active on the GPIO the reported real +range will be 1000000 (1M). + +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +... +rr = gpioGetPWMrealRange(17); +... +D*/ + + +/*F*/ +int gpioSetPWMfrequency(unsigned user_gpio, unsigned frequency); +/*D +Sets the frequency in hertz to be used for the GPIO. + +. . +user_gpio: 0-31 +frequency: >=0 +. . + +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO. + +If PWM is currently active on the GPIO it will be +switched off and then back on at the new frequency. + +Each GPIO can be independently set to one of 18 different PWM +frequencies. + +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). + +The frequencies for each sample rate are: + +. . + Hertz + + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 + 1250 1000 800 500 400 250 200 100 50 + + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 + 625 500 400 250 200 125 100 50 25 + + 4: 10000 5000 2500 2000 1250 1000 625 500 400 + 313 250 200 125 100 63 50 25 13 +sample + rate + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 + 250 200 160 100 80 50 40 20 10 + + 8: 5000 2500 1250 1000 625 500 313 250 200 + 156 125 100 63 50 31 25 13 6 + + 10: 4000 2000 1000 800 500 400 250 200 160 + 125 100 80 50 40 25 20 10 5 +. . + +... +gpioSetPWMfrequency(23, 0); // Set GPIO23 to lowest frequency. + +gpioSetPWMfrequency(24, 500); // Set GPIO24 to 500Hz. + +gpioSetPWMfrequency(25, 100000); // Set GPIO25 to highest frequency. +... +D*/ + + +/*F*/ +int gpioGetPWMfrequency(unsigned user_gpio); +/*D +Returns the frequency (in hertz) used for the GPIO if OK, otherwise +PI_BAD_USER_GPIO. + +. . +user_gpio: 0-31 +. . + +For normal PWM the frequency will be that defined for the GPIO by +[*gpioSetPWMfrequency*]. + +If a hardware clock is active on the GPIO the reported frequency +will be that set by [*gpioHardwareClock*]. + +If hardware PWM is active on the GPIO the reported frequency +will be that set by [*gpioHardwarePWM*]. + +... +f = gpioGetPWMfrequency(23); // Get frequency used for GPIO23. +... +D*/ + + +/*F*/ +int gpioServo(unsigned user_gpio, unsigned pulsewidth); +/*D +Starts servo pulses on the GPIO, 0 (off), 500 (most anti-clockwise) to +2500 (most clockwise). + +. . + user_gpio: 0-31 +pulsewidth: 0, 500-2500 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_PULSEWIDTH. + +The range supported by servos varies and should probably be determined +by experiment. A value of 1500 should always be safe and represents +the mid-point of rotation. You can DAMAGE a servo if you command it +to move beyond its limits. + +The following causes an on pulse of 1500 microseconds duration to be +transmitted on GPIO 17 at a rate of 50 times per second. This will +command a servo connected to GPIO 17 to rotate to its mid-point. + +... +gpioServo(17, 1000); // Move servo to safe position anti-clockwise. + +gpioServo(23, 1500); // Move servo to centre position. + +gpioServo(25, 2000); // Move servo to safe position clockwise. +... + +OTHER UPDATE RATES: + +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +. . +PWM Hz 50 100 200 400 500 +1E6/Hz 20000 10000 5000 2500 2000 +. . + +Firstly set the desired PWM frequency using [*gpioSetPWMfrequency*]. + +Then set the PWM range using [*gpioSetPWMrange*] to 1E6/frequency. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +E.g. If you want to update a servo connected to GPIO25 at 400Hz + +. . +gpioSetPWMfrequency(25, 400); + +gpioSetPWMrange(25, 2500); +. . + +Thereafter use the PWM command to move the servo, +e.g. gpioPWM(25, 1500) will set a 1500 us pulse. +D*/ + + +/*F*/ +int gpioGetServoPulsewidth(unsigned user_gpio); +/*D +Returns the servo pulsewidth setting for the GPIO. + +. . +user_gpio: 0-31 +. . + +Returns 0 (off), 500 (most anti-clockwise) to 2500 (most clockwise) +if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. +D*/ + + +/*F*/ +int gpioSetAlertFunc(unsigned user_gpio, gpioAlertFunc_t f); +/*D +Registers a function to be called (a callback) when the specified +GPIO changes state. + +. . +user_gpio: 0-31 + f: the callback function +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO. + +One callback may be registered per GPIO. + +The callback is passed the GPIO, the new level, and the tick. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +level 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes +. . + +The alert may be cancelled by passing NULL as the function. + +The GPIO are sampled at a rate set when the library is started. + +If a value isn't specifically set the default of 5 us is used. + +The number of samples per second is given in the following table. + +. . + samples + per sec + + 1 1,000,000 + 2 500,000 +sample 4 250,000 +rate 5 200,000 +(us) 8 125,000 + 10 100,000 +. . + +Level changes shorter than the sample rate may be missed. + +The thread which calls the alert functions is triggered nominally +1000 times per second. The active alert functions will be called +once per level change since the last time the thread was activated. +i.e. The active alert functions will get all level changes but there +will be a latency. + +If you want to track the level of more than one GPIO do so by +maintaining the state in the callback. Do not use [*gpioRead*]. +Remember the event that triggered the callback may have +happened several milliseconds before and the GPIO may have +changed level many times since then. + +The tick value is the time stamp of the sample in microseconds, see +[*gpioTick*] for more details. + +... +void aFunction(int gpio, int level, uint32_t tick) +{ + printf("GPIO %d became %d at %d", gpio, level, tick); +} + +// call aFunction whenever GPIO 4 changes state + +gpioSetAlertFunc(4, aFunction); +... +D*/ + + +/*F*/ +int gpioSetAlertFuncEx( + unsigned user_gpio, gpioAlertFuncEx_t f, void *userdata); +/*D +Registers a function to be called (a callback) when the specified +GPIO changes state. + +. . +user_gpio: 0-31 + f: the callback function + userdata: pointer to arbitrary user data +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO. + +One callback may be registered per GPIO. + +The callback is passed the GPIO, the new level, the tick, and +the userdata pointer. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +level 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes + +userdata pointer Pointer to an arbitrary object +. . + +See [*gpioSetAlertFunc*] for further details. + +Only one of [*gpioSetAlertFunc*] or [*gpioSetAlertFuncEx*] can be +registered per GPIO. +D*/ + + +/*F*/ +int gpioSetISRFunc( + unsigned gpio, unsigned edge, int timeout, gpioISRFunc_t f); +/*D +Registers a function to be called (a callback) whenever the specified +GPIO interrupt occurs. + +. . + gpio: 0-53 + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE +timeout: interrupt timeout in milliseconds (<=0 to cancel) + f: the callback function +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_EDGE, +or PI_BAD_ISR_INIT. + +One function may be registered per GPIO. + +The function is passed the GPIO, the current level, and the +current tick. The level will be PI_TIMEOUT if the optional +interrupt timeout expires. + +. . +Parameter Value Meaning + +GPIO 0-53 The GPIO which has changed state + +level 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (interrupt timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes +. . + +The underlying Linux sysfs GPIO interface is used to provide +the interrupt services. + +The first time the function is called, with a non-NULL f, the +GPIO is exported, set to be an input, and set to interrupt +on the given edge and timeout. + +Subsequent calls, with a non-NULL f, can vary one or more of the +edge, timeout, or function. + +The ISR may be cancelled by passing a NULL f, in which case the +GPIO is unexported. + +The tick is that read at the time the process was informed of +the interrupt. This will be a variable number of microseconds +after the interrupt occurred. Typically the latency will be of +the order of 50 microseconds. The latency is not guaranteed +and will vary with system load. + +The level is that read at the time the process was informed of +the interrupt, or PI_TIMEOUT if the optional interrupt timeout +expired. It may not be the same as the expected edge as +interrupts happening in rapid succession may be missed by the +kernel (i.e. this mechanism can not be used to capture several +interrupts only a few microseconds apart). +D*/ + + +/*F*/ +int gpioSetISRFuncEx( + unsigned gpio, + unsigned edge, + int timeout, + gpioISRFuncEx_t f, + void *userdata); +/*D +Registers a function to be called (a callback) whenever the specified +GPIO interrupt occurs. + +. . + gpio: 0-53 + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE + timeout: interrupt timeout in milliseconds (<=0 to cancel) + f: the callback function +userdata: pointer to arbitrary user data +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_EDGE, +or PI_BAD_ISR_INIT. + +The function is passed the GPIO, the current level, the +current tick, and the userdata pointer. + +. . +Parameter Value Meaning + +GPIO 0-53 The GPIO which has changed state + +level 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (interrupt timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes + +userdata pointer Pointer to an arbitrary object +. . + +Only one of [*gpioSetISRFunc*] or [*gpioSetISRFuncEx*] can be +registered per GPIO. + +See [*gpioSetISRFunc*] for further details. +D*/ + + +/*F*/ +int gpioNotifyOpen(void); +/*D +This function requests a free notification handle. + +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +A notification is a method for being notified of GPIO state changes +via a pipe or socket. + +Pipe notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). E.g. if the +function returns 15 then the notifications must be read +from /dev/pigpio15. + +Socket notifications are returned to the socket which requested the +handle. + +... +h = gpioNotifyOpen(); + +if (h >= 0) +{ + sprintf(str, "/dev/pigpio%d", h); + + fd = open(str, O_RDONLY); + + if (fd >= 0) + { + // Okay. + } + else + { + // Error. + } +} +else +{ + // Error. +} +... +D*/ + + +/*F*/ +int gpioNotifyOpenWithSize(int bufSize); +/*D +This function requests a free notification handle. + +It differs from [*gpioNotifyOpen*] in that the pipe size may be +specified, whereas [*gpioNotifyOpen*] uses the default pipe size. + +See [*gpioNotifyOpen*] for further details. +D*/ + + +/*F*/ +int gpioNotifyBegin(unsigned handle, uint32_t bits); +/*D +This function starts notifications on a previously opened handle. + +. . +handle: >=0, as returned by [*gpioNotifyOpen*] + bits: a bit mask indicating the GPIO of interest +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +The notification sends state changes for each GPIO whose corresponding +bit in bits is set. + +Each notification occupies 12 bytes in the fifo and has the +following structure. + +. . +typedef struct +{ + uint16_t seqno; + uint16_t flags; + uint32_t tick; + uint32_t level; +} gpioReport_t; +. . + +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +flags: three flags are defined, PI_NTFY_FLAGS_WDOG, +PI_NTFY_FLAGS_ALIVE, and PI_NTFY_FLAGS_EVENT. + +If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +If bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +If bit 7 is set (PI_NTFY_FLAGS_EVENT) then bits 0-4 of the flags +indicate an event which has been triggered. + +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +level: indicates the level of each GPIO. If bit 1<=0, as returned by [*gpioNotifyOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +Notifications for the handle are suspended until [*gpioNotifyBegin*] +is called again. + +... +gpioNotifyPause(h); +... +D*/ + + +/*F*/ +int gpioNotifyClose(unsigned handle); +/*D +This function stops notifications on a previously opened handle +and releases the handle for reuse. + +. . +handle: >=0, as returned by [*gpioNotifyOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +... +gpioNotifyClose(h); +... +D*/ + + +/*F*/ +int gpioWaveClear(void); +/*D +This function clears all waveforms and any data added by calls to the +[*gpioWaveAdd**] functions. + +Returns 0 if OK. + +... +gpioWaveClear(); +... +D*/ + + +/*F*/ +int gpioWaveAddNew(void); +/*D +This function starts a new empty waveform. + +You wouldn't normally need to call this function as it is automatically +called after a waveform is created with the [*gpioWaveCreate*] function. + +Returns 0 if OK. + +... +gpioWaveAddNew(); +... +D*/ + + +/*F*/ +int gpioWaveAddGeneric(unsigned numPulses, gpioPulse_t *pulses); +/*D +This function adds a number of pulses to the current waveform. + +. . +numPulses: the number of pulses + pulses: an array of pulses +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +The pulses are interleaved in time order within the existing waveform +(if any). + +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist of a delay. + +... +// Construct and send a 30 microsecond square wave. + +gpioSetMode(gpio, PI_OUTPUT); + +pulse[0].gpioOn = (1<= 0) +{ + gpioWaveTxSend(wave_id, PI_WAVE_MODE_REPEAT); + + // Transmit for 30 seconds. + + sleep(30); + + gpioWaveTxStop(); +} +else +{ + // Wave create failed. +} +... +D*/ + + +/*F*/ +int gpioWaveAddSerial + (unsigned user_gpio, + unsigned baud, + unsigned data_bits, + unsigned stop_bits, + unsigned offset, + unsigned numBytes, + char *str); +/*D +This function adds a waveform representing serial data to the +existing waveform (if any). The serial data starts offset +microseconds from the start of the waveform. + +. . +user_gpio: 0-31 + baud: 50-1000000 +data_bits: 1-32 +stop_bits: 2-8 + offset: >=0 + numBytes: >=1 + str: an array of chars (which may contain nulls) +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOPBITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +NOTES: + +The serial data is formatted as one start bit, data_bits data bits, and +stop_bits/2 stop bits. + +It is legal to add serial data streams with different baud rates to +the same waveform. + +numBytes is the number of bytes of data in str. + +The bytes required for each character depend upon data_bits. + +For data_bits 1-8 there will be one byte per character. +For data_bits 9-16 there will be two bytes per character. +For data_bits 17-32 there will be four bytes per character. + +... +#define MSG_LEN 8 + +int i; +char *str; +char data[MSG_LEN]; + +str = "Hello world!"; + +gpioWaveAddSerial(4, 9600, 8, 2, 0, strlen(str), str); + +for (i=0; i=0, as returned by [*gpioWaveCreate*] +. . + +Wave ids are allocated in order, 0, 1, 2, etc. + +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. +D*/ + + +/*F*/ +int gpioWaveTxSend(unsigned wave_id, unsigned wave_mode); +/*D +This function transmits the waveform with id wave_id. The mode +determines whether the waveform is sent once or cycles endlessly. +The SYNC variants wait for the current waveform to reach the +end of a cycle or finish before starting the new waveform. + +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +NOTE: Any hardware PWM started by [*gpioHardwarePWM*] will be cancelled. + +. . + wave_id: >=0, as returned by [*gpioWaveCreate*] +wave_mode: PI_WAVE_MODE_ONE_SHOT, PI_WAVE_MODE_REPEAT, + PI_WAVE_MODE_ONE_SHOT_SYNC, PI_WAVE_MODE_REPEAT_SYNC +. . + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + + +/*F*/ +int gpioWaveChain(char *buf, unsigned bufSize); +/*D +This function transmits a chain of waveforms. + +NOTE: Any hardware PWM started by [*gpioHardwarePWM*] will be cancelled. + +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of [*wave_id*]s and optional command +codes and related data. + +. . + buf: pointer to the wave_ids and optional command codes +bufSize: the number of bytes in buf +. . + +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +Delays between waves may be added with the delay command. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +Loop Start @ 255 0 @ Identify start of a wave block +Loop Repeat @ 255 1 x y @ loop x + y*256 times +Delay @ 255 2 x y @ delay x + y*256 microseconds +Loop Forever @ 255 3 @ loop forever + +If present Loop Forever must be the last entry in the chain. + +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +... +#include +#include + +#define WAVES 5 +#define GPIO 4 + +int main(int argc, char *argv[]) +{ + int i, wid[WAVES]; + + if (gpioInitialise()<0) return -1; + + gpioSetMode(GPIO, PI_OUTPUT); + + printf("start piscope, press return"); getchar(); + + for (i=0; i=0 +. . + +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +The bytes returned for each character depend upon the number of +data bits [*data_bits*] specified in the [*gpioSerialReadOpen*] command. + +For [*data_bits*] 1-8 there will be one byte per character. +For [*data_bits*] 9-16 there will be two bytes per character. +For [*data_bits*] 17-32 there will be four bytes per character. +D*/ + + +/*F*/ +int gpioSerialReadClose(unsigned user_gpio); +/*D +This function closes a GPIO for bit bang reading of serial data. + +. . +user_gpio: 0-31, previously opened with [*gpioSerialReadOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. +D*/ + +/*F*/ +int i2cOpen(unsigned i2cBus, unsigned i2cAddr, unsigned i2cFlags); +/*D +This returns a handle for the device at the address on the I2C bus. + +. . + i2cBus: >=0 + i2cAddr: 0-0x7F +i2cFlags: 0 +. . + +No flags are currently defined. This parameter should be set to zero. + +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +The GPIO used are given in the following table. + + @ SDA @ SCL +I2C 0 @ 0 @ 1 +I2C 1 @ 2 @ 3 + +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +. . +S (1 bit) : Start bit +P (1 bit) : Stop bit +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +A, NA (1 bit) : Accept and not accept bit. +Addr (7 bits): I2C 7 bit address. +i2cReg (8 bits): Command byte, a byte which often selects a register. +Data (8 bits): A data byte. +Count (8 bits): A byte defining the length of a block operation. + +[..]: Data sent by the device. +. . +D*/ + + +/*F*/ +int i2cClose(unsigned handle); +/*D +This closes the I2C device associated with the handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + + +/*F*/ +int i2cWriteQuick(unsigned handle, unsigned bit); +/*D +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + bit: 0-1, the value to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Quick command. SMBus 2.0 5.5.1 +. . +S Addr bit [A] P +. . +D*/ + + +/*F*/ +int i2cWriteByte(unsigned handle, unsigned bVal); +/*D +This sends a single byte to the device associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + bVal: 0-0xFF, the value to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Send byte. SMBus 2.0 5.5.2 +. . +S Addr Wr [A] bVal [A] P +. . +D*/ + + +/*F*/ +int i2cReadByte(unsigned handle); +/*D +This reads a single byte from the device associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +Receive byte. SMBus 2.0 5.5.3 +. . +S Addr Rd [A] [Data] NA P +. . +D*/ + + +/*F*/ +int i2cWriteByteData(unsigned handle, unsigned i2cReg, unsigned bVal); +/*D +This writes a single byte to the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write + bVal: 0-0xFF, the value to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write byte. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] i2cReg [A] bVal [A] P +. . +D*/ + + +/*F*/ +int i2cWriteWordData(unsigned handle, unsigned i2cReg, unsigned wVal); +/*D +This writes a single 16 bit word to the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write + wVal: 0-0xFFFF, the value to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write word. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] i2cReg [A] wValLow [A] wValHigh [A] P +. . +D*/ + + +/*F*/ +int i2cReadByteData(unsigned handle, unsigned i2cReg); +/*D +This reads a single byte from the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to read +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read byte. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] i2cReg [A] S Addr Rd [A] [Data] NA P +. . +D*/ + + +/*F*/ +int i2cReadWordData(unsigned handle, unsigned i2cReg); +/*D +This reads a single 16 bit word from the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to read +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read word. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] i2cReg [A] S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + + +/*F*/ +int i2cProcessCall(unsigned handle, unsigned i2cReg, unsigned wVal); +/*D +This writes 16 bits of data to the specified register of the device +associated with handle and reads 16 bits of data in return. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write/read + wVal: 0-0xFFFF, the value to write +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Process call. SMBus 2.0 5.5.6 +. . +S Addr Wr [A] i2cReg [A] wValLow [A] wValHigh [A] + S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + + +/*F*/ +int i2cWriteBlockData( +unsigned handle, unsigned i2cReg, char *buf, unsigned count); +/*D +This writes up to 32 bytes to the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write + buf: an array with the data to send + count: 1-32, the number of bytes to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Block write. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] i2cReg [A] count [A] + buf0 [A] buf1 [A] ... [A] bufn [A] P +. . +D*/ + + +/*F*/ +int i2cReadBlockData(unsigned handle, unsigned i2cReg, char *buf); +/*D +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to read + buf: an array to receive the read data +. . + +The amount of returned data is set by the device. + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Block read. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] i2cReg [A] + S Addr Rd [A] [Count] A [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + + +/*F*/ +int i2cBlockProcessCall( +unsigned handle, unsigned i2cReg, char *buf, unsigned count); +/*D +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write/read + buf: an array with the data to send and to receive the read data + count: 1-32, the number of bytes to write +. . + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +The SMBus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +Block write-block read. SMBus 2.0 5.5.8 +. . +S Addr Wr [A] i2cReg [A] count [A] buf0 [A] ... bufn [A] + S Addr Rd [A] [Count] A [buf0] A ... [bufn] A P +. . +D*/ + + +/*F*/ +int i2cReadI2CBlockData( +unsigned handle, unsigned i2cReg, char *buf, unsigned count); +/*D +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to read + buf: an array to receive the read data + count: 1-32, the number of bytes to read +. . + +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +. . +S Addr Wr [A] i2cReg [A] + S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + + +/*F*/ +int i2cWriteI2CBlockData( +unsigned handle, unsigned i2cReg, char *buf, unsigned count); +/*D +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] +i2cReg: 0-255, the register to write + buf: the data to write + count: 1-32, the number of bytes to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +. . +S Addr Wr [A] i2cReg [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +. . +D*/ + +/*F*/ +int i2cReadDevice(unsigned handle, char *buf, unsigned count); +/*D +This reads count bytes from the raw device into buf. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + buf: an array to receive the read data bytes + count: >0, the number of bytes to read +. . + +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. + +. . +S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + + +/*F*/ +int i2cWriteDevice(unsigned handle, char *buf, unsigned count); +/*D +This writes count bytes from buf to the raw device. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + buf: an array containing the data bytes to write + count: >0, the number of bytes to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +. . +S Addr Wr [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +. . +D*/ + +/*F*/ +void i2cSwitchCombined(int setting); +/*D +This sets the I2C (i2c-bcm2708) module "use combined transactions" +parameter on or off. + +. . +setting: 0 to set the parameter off, non-zero to set it on +. . + + +NOTE: when the flag is on a write followed by a read to the same +slave address will use a repeated start (rather than a stop/start). +D*/ + +/*F*/ +int i2cSegments(unsigned handle, pi_i2c_msg_t *segs, unsigned numSegs); +/*D +This function executes multiple I2C segments in one transaction by +calling the I2C_RDWR ioctl. + +. . + handle: >=0, as returned by a call to [*i2cOpen*] + segs: an array of I2C segments +numSegs: >0, the number of I2C segments +. . + +Returns the number of segments if OK, otherwise PI_BAD_I2C_SEG. +D*/ + +/*F*/ +int i2cZip( + unsigned handle, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +On @ 2 @ Switch combined flag on +Off @ 3 @ Switch combined flag off +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53, write 0x32, read 6 bytes +Set address 0x1E, write 0x03, read 6 bytes +Set address 0x68, write 0x1B, read 8 bytes +End + +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +0x00 +... +D*/ + +/*F*/ +int bbI2COpen(unsigned SDA, unsigned SCL, unsigned baud); +/*D +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +o baud rates as low as 50 +o repeated starts +o clock stretching +o I2C on any pair of spare GPIO + +. . + SDA: 0-31 + SCL: 0-31 +baud: 50-500000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +NOTE: + +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. +D*/ + +/*F*/ +int bbI2CClose(unsigned SDA); +/*D +This function stops bit banging I2C on a pair of GPIO previously +opened with [*bbI2COpen*]. + +. . +SDA: 0-31, the SDA GPIO used in a prior call to [*bbI2COpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. +D*/ + +/*F*/ +int bbI2CZip( + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . + SDA: 0-31 (as used in a prior call to [*bbI2COpen*]) + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +Start @ 2 @ Start condition +Stop @ 3 @ Stop condition +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +No flags are currently defined. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53 +start, write 0x32, (re)start, read 6 bytes, stop +Set address 0x1E +start, write 0x03, (re)start, read 6 bytes, stop +Set address 0x68 +start, write 0x1B, (re)start, read 8 bytes, stop +End + +0x04 0x53 +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 + +0x04 0x1E +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 + +0x04 0x68 +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 + +0x00 +... +D*/ + +/*F*/ +int bscXfer(bsc_xfer_t *bsc_xfer); +/*D +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +The function sets the BSC mode, writes any data in +the transmit buffer to the BSC transmit FIFO, and +copies any data in the BSC receive FIFO to the +receive buffer. + +. . +bsc_xfer:= a structure defining the transfer + +typedef struct +{ + uint32_t control; // Write + int rxCnt; // Read only + char rxBuf[BSC_FIFO_SIZE]; // Read only + int txCnt; // Write + char txBuf[BSC_FIFO_SIZE]; // Write +} bsc_xfer_t; +. . + +To start a transfer set control (see below), copy the bytes to +be added to the transmit FIFO (if any) to txBuf and set txCnt to +the number of copied bytes. + +Upon return rxCnt will be set to the number of received bytes placed +in rxBuf. + +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +GPIO used for models other than those based on the BCM2711. + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 18 @ 19 @ - @ - @ - @ - +SPI @ - @ - @ 20 @ 19 @ 18 @ 21 + +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 10 @ 11 @ - @ - @ - @ - +SPI @ - @ - @ 9 @ 11 @ 10 @ 8 + +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +The returned function value is the status of the transfer (see below). + +If there was an error the status will be less than zero +(and will contain the error code). + +The most significant word of the returned status contains the number +of bytes actually copied from txBuf to the BSC transmit FIFO (may be +less than requested if the FIFO already contained untransmitted data). + +control consists of the following bits. + +. . +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +. . + +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +aaaaaaa @ defines the I2C slave address (only relevant in I2C mode) +IT @ invert transmit status flags +HC @ enable host control +TF @ enable test FIFO +IR @ invert receive status flags +RE @ enable receive +TE @ enable transmit +BK @ abort operation and clear FIFOs +EC @ send control register as first I2C byte +ES @ send status register as first I2C byte +PL @ set SPI polarity high +PH @ set SPI phase high +I2 @ enable I2C mode +SP @ enable SPI mode +EN @ enable BSC peripheral + +The returned status has the following format + +. . +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + S S S S S R R R R R T T T T T RB TE RF TF RE TB +. . + +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +SSSSS @ number of bytes successfully copied to transmit FIFO +RRRRR @ number of bytes in receive FIFO +TTTTT @ number of bytes in transmit FIFO +RB @ receive busy +TE @ transmit FIFO empty +RF @ receive FIFO full +TF @ transmit FIFO full +RE @ receive FIFO empty +TB @ transmit busy + +The following example shows how to configure the BSC peripheral as +an I2C slave with address 0x13 and send four bytes. + +... +bsc_xfer_t xfer; + +xfer.control = (0x13<<16) | 0x305; + +memcpy(xfer.txBuf, "ABCD", 4); +xfer.txCnt = 4; + +status = bscXfer(&xfer); + +if (status >= 0) +{ + // process transfer +} +... + +The BSC slave in SPI mode deserializes data from the MOSI pin into its +receiver/FIFO when the LSB of the first byte is a 0. No data is output on +the MISO pin. When the LSB of the first byte on MOSI is a 1, the +transmitter/FIFO data is serialized onto the MISO pin while all other data +on the MOSI pin is ignored. + +The BK bit of the BSC control register is non-functional when in the SPI +mode. The transmitter along with its FIFO can be dequeued by successively +disabling and re-enabling the TE bit on the BSC control register while in +SPI mode. +D*/ + +/*F*/ +int bbSPIOpen( + unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, + unsigned baud, unsigned spiFlags); +/*D +This function selects a set of GPIO for bit banging SPI with +a specified baud rate and mode. + +. . + CS: 0-31 + MISO: 0-31 + MOSI: 0-31 + SCLK: 0-31 + baud: 50-250000 +spiFlags: see below +. . + +spiFlags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +. . + +mm defines the SPI mode, defaults to 0 + +. . +Mode CPOL CPHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +p is 0 if CS is active low (default) and 1 for active high. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +The other bits in flags should be set to zero. + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_SPI_BAUD, or +PI_GPIO_IN_USE. + +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +... +bbSPIOpen(10, MISO, MOSI, SCLK, 10000, 0); // device 1 +bbSPIOpen(11, MISO, MOSI, SCLK, 20000, 3); // device 2 +... +D*/ + +/*F*/ +int bbSPIClose(unsigned CS); +/*D +This function stops bit banging SPI on a set of GPIO +opened with [*bbSPIOpen*]. + +. . +CS: 0-31, the CS GPIO used in a prior call to [*bbSPIOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SPI_GPIO. +D*/ + +/*F*/ +int bbSPIXfer( + unsigned CS, + char *inBuf, + char *outBuf, + unsigned count); +/*D +This function executes a bit banged SPI transfer. + +. . + CS: 0-31 (as used in a prior call to [*bbSPIOpen*]) + inBuf: pointer to buffer to hold data to be sent +outBuf: pointer to buffer to hold returned data + count: size of data transfer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_SPI_GPIO or PI_BAD_POINTER. + +... +// gcc -Wall -pthread -o bbSPIx_test bbSPIx_test.c -lpigpio +// sudo ./bbSPIx_test + + +#include + +#include "pigpio.h" + +#define CE0 5 +#define CE1 6 +#define MISO 13 +#define MOSI 19 +#define SCLK 12 + +int main(int argc, char *argv[]) +{ + int i, count, set_val, read_val; + unsigned char inBuf[3]; + char cmd1[] = {0, 0}; + char cmd2[] = {12, 0}; + char cmd3[] = {1, 128, 0}; + + if (gpioInitialise() < 0) + { + fprintf(stderr, "pigpio initialisation failed.\n"); + return 1; + } + + bbSPIOpen(CE0, MISO, MOSI, SCLK, 10000, 0); // MCP4251 DAC + bbSPIOpen(CE1, MISO, MOSI, SCLK, 20000, 3); // MCP3008 ADC + + for (i=0; i<256; i++) + { + cmd1[1] = i; + + count = bbSPIXfer(CE0, cmd1, (char *)inBuf, 2); // > DAC + + if (count == 2) + { + count = bbSPIXfer(CE0, cmd2, (char *)inBuf, 2); // < DAC + + if (count == 2) + { + set_val = inBuf[1]; + + count = bbSPIXfer(CE1, cmd3, (char *)inBuf, 3); // < ADC + + if (count == 3) + { + read_val = ((inBuf[1]&3)<<8) | inBuf[2]; + printf("%d %d\n", set_val, read_val); + } + } + } + } + + bbSPIClose(CE0); + bbSPIClose(CE1); + + gpioTerminate(); + + return 0; +} +... +D*/ + +/*F*/ +int spiOpen(unsigned spiChan, unsigned baud, unsigned spiFlags); +/*D +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +The Pi has two SPI peripherals: main and auxiliary. + +The main SPI has two chip selects (channels), the auxiliary has +three. + +The auxiliary SPI is available on all models but the A and B. + +The GPIO used are given in the following table. + + @ MISO @ MOSI @ SCLK @ CE0 @ CE1 @ CE2 +Main SPI @ 9 @ 10 @ 11 @ 8 @ 7 @ - +Aux SPI @ 19 @ 20 @ 21 @ 18 @ 17 @ 16 + +. . + spiChan: 0-1 (0-2 for the auxiliary SPI) + baud: 32K-125M (values above 30M are unlikely to work) +spiFlags: see below +. . + +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +spiFlags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +. . + +mm defines the SPI mode. + +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +. . +Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +px is 0 if CEx is active low (default) and 1 for active high. + +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +A is 0 for the main SPI, 1 for the auxiliary SPI. + +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +The [*spiRead*], [*spiWrite*], and [*spiXfer*] functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +For bits 1-8 there will be one byte per word. +For bits 9-16 there will be two bytes per word. +For bits 17-32 there will be four bytes per word. + +Multi-byte transfers are made in least significant byte first order. + +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +The other bits in flags should be set to zero. +D*/ + +/*F*/ +int spiClose(unsigned handle); +/*D +This functions closes the SPI device identified by the handle. + +. . +handle: >=0, as returned by a call to [*spiOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + + +/*F*/ +int spiRead(unsigned handle, char *buf, unsigned count); +/*D +This function reads count bytes of data from the SPI +device associated with the handle. + +. . +handle: >=0, as returned by a call to [*spiOpen*] + buf: an array to receive the read data bytes + count: the number of bytes to read +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + + +/*F*/ +int spiWrite(unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +. . +handle: >=0, as returned by a call to [*spiOpen*] + buf: the data bytes to write + count: the number of bytes to write +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int spiXfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count); +/*D +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +. . +handle: >=0, as returned by a call to [*spiOpen*] + txBuf: the data bytes to write + rxBuf: the received data bytes + count: the number of bytes to transfer +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + + +/*F*/ +int serOpen(char *sertty, unsigned baud, unsigned serFlags); +/*D +This function opens a serial device at a specified baud rate +and with specified flags. The device name must start with +/dev/tty or /dev/serial. + +. . + sertty: the serial device to open + baud: the baud rate in bits per second, see below +serFlags: 0 +. . + +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +No flags are currently defined. This parameter should be set to zero. +D*/ + + +/*F*/ +int serClose(unsigned handle); +/*D +This function closes the serial device associated with handle. + +. . +handle: >=0, as returned by a call to [*serOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int serWriteByte(unsigned handle, unsigned bVal); +/*D +This function writes bVal to the serial port associated with handle. + +. . +handle: >=0, as returned by a call to [*serOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + +/*F*/ +int serReadByte(unsigned handle); +/*D +This function reads a byte from the serial port associated with handle. + +. . +handle: >=0, as returned by a call to [*serOpen*] +. . + +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +If no data is ready PI_SER_READ_NO_DATA is returned. +D*/ + +/*F*/ +int serWrite(unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes from buf to the the serial port +associated with handle. + +. . +handle: >=0, as returned by a call to [*serOpen*] + buf: the array of bytes to write + count: the number of bytes to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + + +/*F*/ +int serRead(unsigned handle, char *buf, unsigned count); +/*D +This function reads up count bytes from the the serial port +associated with handle and writes them to buf. + +. . +handle: >=0, as returned by a call to [*serOpen*] + buf: an array to receive the read data + count: the maximum number of bytes to read +. . + +Returns the number of bytes read (>0=) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_SER_READ_NO_DATA. + +If no data is ready zero is returned. +D*/ + + +/*F*/ +int serDataAvailable(unsigned handle); +/*D +This function returns the number of bytes available +to be read from the device associated with handle. + +. . +handle: >=0, as returned by a call to [*serOpen*] +. . + +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. +D*/ + + +/*F*/ +int gpioTrigger(unsigned user_gpio, unsigned pulseLen, unsigned level); +/*D +This function sends a trigger pulse to a GPIO. The GPIO is set to +level for pulseLen microseconds and then reset to not level. + +. . +user_gpio: 0-31 + pulseLen: 1-100 + level: 0,1 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_LEVEL, +or PI_BAD_PULSELEN. +D*/ + + +/*F*/ +int gpioSetWatchdog(unsigned user_gpio, unsigned timeout); +/*D +Sets a watchdog for a GPIO. + +. . +user_gpio: 0-31 + timeout: 0-60000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_BAD_WDOG_TIMEOUT. + +The watchdog is nominally in milliseconds. + +One watchdog may be registered per GPIO. + +The watchdog may be cancelled by setting timeout to 0. + +Until cancelled a timeout will be reported every timeout milliseconds +after the last GPIO activity. + +In particular: + +1) any registered alert function for the GPIO will be called with + the level set to PI_TIMEOUT. + +2) any notification for the GPIO will have a report written to the + fifo with the flags set to indicate a watchdog timeout. + +... +void aFunction(int gpio, int level, uint32_t tick) +{ + printf("GPIO %d became %d at %d", gpio, level, tick); +} + +// call aFunction whenever GPIO 4 changes state +gpioSetAlertFunc(4, aFunction); + +// or approximately every 5 millis +gpioSetWatchdog(4, 5); +... +D*/ + + +/*F*/ +int gpioNoiseFilter(unsigned user_gpio, unsigned steady, unsigned active); +/*D +Sets a noise filter on a GPIO. + +Level changes on the GPIO are ignored until a level which has +been stable for [*steady*] microseconds is detected. Level changes +on the GPIO are then reported for [*active*] microseconds after +which the process repeats. + +. . +user_gpio: 0-31 + steady: 0-300000 + active: 0-1000000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +This filter affects the GPIO samples returned to callbacks set up +with [*gpioSetAlertFunc*], [*gpioSetAlertFuncEx*], [*gpioSetGetSamplesFunc*], +and [*gpioSetGetSamplesFuncEx*]. + +It does not affect interrupts set up with [*gpioSetISRFunc*], +[*gpioSetISRFuncEx*], or levels read by [*gpioRead*], +[*gpioRead_Bits_0_31*], or [*gpioRead_Bits_32_53*]. + +Level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. +D*/ + + +/*F*/ +int gpioGlitchFilter(unsigned user_gpio, unsigned steady); +/*D +Sets a glitch filter on a GPIO. + +Level changes on the GPIO are not reported unless the level +has been stable for at least [*steady*] microseconds. The +level is then reported. Level changes of less than [*steady*] +microseconds are ignored. + +. . +user_gpio: 0-31 + steady: 0-300000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +This filter affects the GPIO samples returned to callbacks set up +with [*gpioSetAlertFunc*], [*gpioSetAlertFuncEx*], [*gpioSetGetSamplesFunc*], +and [*gpioSetGetSamplesFuncEx*]. + +It does not affect interrupts set up with [*gpioSetISRFunc*], +[*gpioSetISRFuncEx*], or levels read by [*gpioRead*], +[*gpioRead_Bits_0_31*], or [*gpioRead_Bits_32_53*]. + +Each (stable) edge will be timestamped [*steady*] microseconds +after it was first detected. +D*/ + + +/*F*/ +int gpioSetGetSamplesFunc(gpioGetSamplesFunc_t f, uint32_t bits); +/*D +Registers a function to be called (a callback) every millisecond +with the latest GPIO samples. + +. . + f: the function to call +bits: the GPIO of interest +. . + +Returns 0 if OK. + +The function is passed a pointer to the samples (an array of +[*gpioSample_t*]), and the number of samples. + +Only one function can be registered. + +The callback may be cancelled by passing NULL as the function. + +The samples returned will be the union of bits, plus any active alerts, +plus any active notifications. + +e.g. if there are alerts for GPIO 7, 8, and 9, notifications for GPIO +8, 10, 23, 24, and bits is (1<<23)|(1<<17) then samples for GPIO +7, 8, 9, 10, 17, 23, and 24 will be reported. +D*/ + + +/*F*/ +int gpioSetGetSamplesFuncEx( + gpioGetSamplesFuncEx_t f, uint32_t bits, void *userdata); +/*D +Registers a function to be called (a callback) every millisecond +with the latest GPIO samples. + +. . + f: the function to call + bits: the GPIO of interest +userdata: a pointer to arbitrary user data +. . + +Returns 0 if OK. + +The function is passed a pointer to the samples (an array of +[*gpioSample_t*]), the number of samples, and the userdata pointer. + +Only one of [*gpioGetSamplesFunc*] or [*gpioGetSamplesFuncEx*] can be +registered. + +See [*gpioSetGetSamplesFunc*] for further details. +D*/ + + +/*F*/ +int gpioSetTimerFunc(unsigned timer, unsigned millis, gpioTimerFunc_t f); +/*D +Registers a function to be called (a callback) every millis milliseconds. + +. . + timer: 0-9 +millis: 10-60000 + f: the function to call +. . + +Returns 0 if OK, otherwise PI_BAD_TIMER, PI_BAD_MS, or PI_TIMER_FAILED. + +10 timers are supported numbered 0 to 9. + +One function may be registered per timer. + +The timer may be cancelled by passing NULL as the function. + +... +void bFunction(void) +{ + printf("two seconds have elapsed"); +} + +// call bFunction every 2000 milliseconds +gpioSetTimerFunc(0, 2000, bFunction); +... +D*/ + + +/*F*/ +int gpioSetTimerFuncEx( + unsigned timer, unsigned millis, gpioTimerFuncEx_t f, void *userdata); +/*D +Registers a function to be called (a callback) every millis milliseconds. + +. . + timer: 0-9. + millis: 10-60000 + f: the function to call +userdata: a pointer to arbitrary user data +. . + +Returns 0 if OK, otherwise PI_BAD_TIMER, PI_BAD_MS, or PI_TIMER_FAILED. + +The function is passed the userdata pointer. + +Only one of [*gpioSetTimerFunc*] or [*gpioSetTimerFuncEx*] can be +registered per timer. + +See [*gpioSetTimerFunc*] for further details. +D*/ + + +/*F*/ +pthread_t *gpioStartThread(gpioThreadFunc_t f, void *userdata); +/*D +Starts a new thread of execution with f as the main routine. + +. . + f: the main function for the new thread +userdata: a pointer to arbitrary user data +. . + +Returns a pointer to pthread_t if OK, otherwise NULL. + +The function is passed the single argument arg. + +The thread can be cancelled by passing the pointer to pthread_t to +[*gpioStopThread*]. + +... +#include +#include + +void *myfunc(void *arg) +{ + while (1) + { + printf("%s", arg); + sleep(1); + } +} + +int main(int argc, char *argv[]) +{ + pthread_t *p1, *p2, *p3; + + if (gpioInitialise() < 0) return 1; + + p1 = gpioStartThread(myfunc, "thread 1"); sleep(3); + + p2 = gpioStartThread(myfunc, "thread 2"); sleep(3); + + p3 = gpioStartThread(myfunc, "thread 3"); sleep(3); + + gpioStopThread(p3); sleep(3); + + gpioStopThread(p2); sleep(3); + + gpioStopThread(p1); sleep(3); + + gpioTerminate(); +} +... +D*/ + + +/*F*/ +void gpioStopThread(pthread_t *pth); +/*D +Cancels the thread pointed at by pth. + +. . +pth: a thread pointer returned by [*gpioStartThread*] +. . + +No value is returned. + +The thread to be stopped should have been started with [*gpioStartThread*]. +D*/ + + +/*F*/ +int gpioStoreScript(char *script); +/*D +This function stores a null terminated script for later execution. + +See [[http://abyz.me.uk/rpi/pigpio/pigs.html#Scripts]] for details. + +. . +script: the text of the script +. . + +The function returns a script id if the script is valid, +otherwise PI_BAD_SCRIPT. +D*/ + + +/*F*/ +int gpioRunScript(unsigned script_id, unsigned numPar, uint32_t *param); +/*D +This function runs a stored script. + +. . +script_id: >=0, as returned by [*gpioStoreScript*] + numPar: 0-10, the number of parameters + param: an array of parameters +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. +D*/ + + + +/*F*/ +int gpioUpdateScript(unsigned script_id, unsigned numPar, uint32_t *param); +/*D +This function sets the parameters of a script. The script may or +may not be running. The first numPar parameters of the script are +overwritten with the new values. + +. . +script_id: >=0, as returned by [*gpioStoreScript*] + numPar: 0-10, the number of parameters + param: an array of parameters +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. +D*/ + + +/*F*/ +int gpioScriptStatus(unsigned script_id, uint32_t *param); +/*D +This function returns the run status of a stored script as well as +the current values of parameters 0 to 9. + +. . +script_id: >=0, as returned by [*gpioStoreScript*] + param: an array to hold the returned 10 parameters +. . + +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +The run status may be + +. . +PI_SCRIPT_INITING +PI_SCRIPT_HALTED +PI_SCRIPT_RUNNING +PI_SCRIPT_WAITING +PI_SCRIPT_FAILED +. . + +The current value of script parameters 0 to 9 are returned in param. +D*/ + + +/*F*/ +int gpioStopScript(unsigned script_id); +/*D +This function stops a running script. + +. . +script_id: >=0, as returned by [*gpioStoreScript*] +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + + +/*F*/ +int gpioDeleteScript(unsigned script_id); +/*D +This function deletes a stored script. + +. . +script_id: >=0, as returned by [*gpioStoreScript*] +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + + +/*F*/ +int gpioSetSignalFunc(unsigned signum, gpioSignalFunc_t f); +/*D +Registers a function to be called (a callback) when a signal occurs. + +. . +signum: 0-63 + f: the callback function +. . + +Returns 0 if OK, otherwise PI_BAD_SIGNUM. + +The function is passed the signal number. + +One function may be registered per signal. + +The callback may be cancelled by passing NULL. + +By default all signals are treated as fatal and cause the library +to call gpioTerminate and then exit. +D*/ + + +/*F*/ +int gpioSetSignalFuncEx( + unsigned signum, gpioSignalFuncEx_t f, void *userdata); +/*D +Registers a function to be called (a callback) when a signal occurs. + +. . + signum: 0-63 + f: the callback function +userdata: a pointer to arbitrary user data +. . + +Returns 0 if OK, otherwise PI_BAD_SIGNUM. + +The function is passed the signal number and the userdata pointer. + +Only one of gpioSetSignalFunc or gpioSetSignalFuncEx can be +registered per signal. + +See gpioSetSignalFunc for further details. +D*/ + + +/*F*/ +uint32_t gpioRead_Bits_0_31(void); +/*D +Returns the current level of GPIO 0-31. +D*/ + + +/*F*/ +uint32_t gpioRead_Bits_32_53(void); +/*D +Returns the current level of GPIO 32-53. +D*/ + + +/*F*/ +int gpioWrite_Bits_0_31_Clear(uint32_t bits); +/*D +Clears GPIO 0-31 if the corresponding bit in bits is set. + +. . +bits: a bit mask of GPIO to clear +. . + +Returns 0 if OK. + +... +// To clear (set to 0) GPIO 4, 7, and 15 +gpioWrite_Bits_0_31_Clear( (1<<4) | (1<<7) | (1<<15) ); +... +D*/ + + +/*F*/ +int gpioWrite_Bits_32_53_Clear(uint32_t bits); +/*D +Clears GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +. . +bits: a bit mask of GPIO to clear +. . + +Returns 0 if OK. +D*/ + + +/*F*/ +int gpioWrite_Bits_0_31_Set(uint32_t bits); +/*D +Sets GPIO 0-31 if the corresponding bit in bits is set. + +. . +bits: a bit mask of GPIO to set +. . + +Returns 0 if OK. +D*/ + + +/*F*/ +int gpioWrite_Bits_32_53_Set(uint32_t bits); +/*D +Sets GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +. . +bits: a bit mask of GPIO to set +. . + +Returns 0 if OK. + +... +// To set (set to 1) GPIO 32, 40, and 53 +gpioWrite_Bits_32_53_Set((1<<(32-32)) | (1<<(40-32)) | (1<<(53-32))); +... +D*/ + +/*F*/ +int gpioHardwareClock(unsigned gpio, unsigned clkfreq); +/*D +Starts a hardware clock on a GPIO at the specified frequency. +Frequencies above 30MHz are unlikely to work. + +. . + gpio: see description +clkfreq: 0 (off) or 4689-250M (13184-375M for the BCM2711) +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_NOT_HCLK_GPIO, +PI_BAD_HCLK_FREQ,or PI_BAD_HCLK_PASS. + +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +The GPIO must be one of the following. + +. . +4 clock 0 All models +5 clock 1 All models but A and B (reserved for system use) +6 clock 2 All models but A and B +20 clock 0 All models but A and B +21 clock 1 All models but A and Rev.2 B (reserved for system use) + +32 clock 0 Compute module only +34 clock 0 Compute module only +42 clock 1 Compute module only (reserved for system use) +43 clock 2 Compute module only +44 clock 1 Compute module only (reserved for system use) +. . + +Access to clock 1 is protected by a password as its use will likely +crash the Pi. The password is given by or'ing 0x5A000000 with the +GPIO number. +D*/ + +/*F*/ +int gpioHardwarePWM(unsigned gpio, unsigned PWMfreq, unsigned PWMduty); +/*D +Starts hardware PWM on a GPIO at the specified frequency and dutycycle. +Frequencies above 30MHz are unlikely to work. + +NOTE: Any waveform started by [*gpioWaveTxSend*], or +[*gpioWaveChain*] will be cancelled. + +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden by a call to +[*gpioCfgClock*]. + +. . + gpio: see description +PWMfreq: 0 (off) or 1-125M (1-187.5M for the BCM2711) +PWMduty: 0 (off) to 1000000 (1M)(fully on) +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_NOT_HPWM_GPIO, +PI_BAD_HPWM_DUTY, PI_BAD_HPWM_FREQ, or PI_HPWM_ILLEGAL. + +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +The GPIO must be one of the following. + +. . +12 PWM channel 0 All models but A and B +13 PWM channel 1 All models but A and B +18 PWM channel 0 All models +19 PWM channel 1 All models but A and B + +40 PWM channel 0 Compute module only +41 PWM channel 1 Compute module only +45 PWM channel 1 Compute module only +52 PWM channel 0 Compute module only +53 PWM channel 1 Compute module only +. . + +The actual number of steps beween off and fully on is the +integral part of 250M/PWMfreq (375M/PWMfreq for the BCM2711). + +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +There will only be a million steps for a PWMfreq of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. PWMduty is +automatically scaled to take this into account. +D*/ + +/*F*/ +int gpioTime(unsigned timetype, int *seconds, int *micros); +/*D +Updates the seconds and micros variables with the current time. + +. . +timetype: 0 (relative), 1 (absolute) + seconds: a pointer to an int to hold seconds + micros: a pointer to an int to hold microseconds +. . + +Returns 0 if OK, otherwise PI_BAD_TIMETYPE. + +If timetype is PI_TIME_ABSOLUTE updates seconds and micros with the +number of seconds and microseconds since the epoch (1st January 1970). + +If timetype is PI_TIME_RELATIVE updates seconds and micros with the +number of seconds and microseconds since the library was initialised. + +... +int secs, mics; + +// print the number of seconds since the library was started +gpioTime(PI_TIME_RELATIVE, &secs, &mics); +printf("library started %d.%03d seconds ago", secs, mics/1000); +... +D*/ + + +/*F*/ +int gpioSleep(unsigned timetype, int seconds, int micros); +/*D +Sleeps for the number of seconds and microseconds specified by seconds +and micros. + +. . +timetype: 0 (relative), 1 (absolute) + seconds: seconds to sleep + micros: microseconds to sleep +. . + +Returns 0 if OK, otherwise PI_BAD_TIMETYPE, PI_BAD_SECONDS, +or PI_BAD_MICROS. + +If timetype is PI_TIME_ABSOLUTE the sleep ends when the number of seconds +and microseconds since the epoch (1st January 1970) has elapsed. System +clock changes are taken into account. + +If timetype is PI_TIME_RELATIVE the sleep is for the specified number +of seconds and microseconds. System clock changes do not effect the +sleep length. + +For short delays (say, 50 microseonds or less) use [*gpioDelay*]. + +... +gpioSleep(PI_TIME_RELATIVE, 2, 500000); // sleep for 2.5 seconds + +gpioSleep(PI_TIME_RELATIVE, 0, 100000); // sleep for 0.1 seconds + +gpioSleep(PI_TIME_RELATIVE, 60, 0); // sleep for one minute +... +D*/ + + +/*F*/ +uint32_t gpioDelay(uint32_t micros); +/*D +Delays for at least the number of microseconds specified by micros. + +. . +micros: the number of microseconds to sleep +. . + +Returns the actual length of the delay in microseconds. + +Delays of 100 microseconds or less use busy waits. +D*/ + + +/*F*/ +uint32_t gpioTick(void); +/*D +Returns the current system tick. + +Tick is the number of microseconds since system boot. + +As tick is an unsigned 32 bit quantity it wraps around after +2^32 microseconds, which is approximately 1 hour 12 minutes. + +You don't need to worry about the wrap around as long as you +take a tick (uint32_t) from another tick, i.e. the following +code will always provide the correct difference. + +... +uint32_t startTick, endTick; +int diffTick; + +startTick = gpioTick(); + +// do some processing + +endTick = gpioTick(); + +diffTick = endTick - startTick; + +printf("some processing took %d microseconds", diffTick); +... +D*/ + + +/*F*/ +unsigned gpioHardwareRevision(void); +/*D +Returns the hardware revision. + +If the hardware revision can not be found or is not a valid hexadecimal +number the function returns 0. + +The hardware revision is the last few characters on the Revision line of +/proc/cpuinfo. + +The revision number can be used to determine the assignment of GPIO +to pins (see [*gpio*]). + +There are at least three types of board. + +Type 1 boards have hardware revision numbers of 2 and 3. + +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +Type 3 boards have hardware revision numbers of 16 or greater. + +for "Revision : 0002" the function returns 2. +for "Revision : 000f" the function returns 15. +for "Revision : 000g" the function returns 0. +D*/ + + +/*F*/ +unsigned gpioVersion(void); +/*D +Returns the pigpio version. +D*/ + + +/*F*/ +int gpioGetPad(unsigned pad); +/*D +This function returns the pad drive strength in mA. + +. . +pad: 0-2, the pad to get +. . + +Returns the pad drive strength if OK, otherwise PI_BAD_PAD. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +strength = gpioGetPad(1); // get pad 1 strength +... +D*/ + + +/*F*/ +int gpioSetPad(unsigned pad, unsigned padStrength); +/*D +This function sets the pad drive strength in mA. + +. . + pad: 0-2, the pad to set +padStrength: 1-16 mA +. . + +Returns 0 if OK, otherwise PI_BAD_PAD, or PI_BAD_STRENGTH. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +gpioSetPad(0, 16); // set pad 0 strength to 16 mA +... +D*/ + +/*F*/ +int eventMonitor(unsigned handle, uint32_t bits); +/*D +This function selects the events to be reported on a previously +opened handle. + +. . +handle: >=0, as returned by [*gpioNotifyOpen*] + bits: a bit mask indicating the events of interest +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +A report is sent each time an event is triggered providing the +corresponding bit in bits is set. + +See [*gpioNotifyBegin*] for the notification format. + +... +// Start reporting events 3, 6, and 7. + +// bit 76543210 +// (0xC8 = 0b11001000) + +eventMonitor(h, 0xC8); +... + +D*/ + +/*F*/ +int eventSetFunc(unsigned event, eventFunc_t f); +/*D +Registers a function to be called (a callback) when the specified +event occurs. + +. . +event: 0-31 + f: the callback function +. . + +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +One function may be registered per event. + +The function is passed the event, and the tick. + +The callback may be cancelled by passing NULL as the function. +D*/ + +/*F*/ +int eventSetFuncEx(unsigned event, eventFuncEx_t f, void *userdata); +/*D +Registers a function to be called (a callback) when the specified +event occurs. + +. . + event: 0-31 + f: the callback function +userdata: pointer to arbitrary user data +. . + +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +One function may be registered per event. + +The function is passed the event, the tick, and the ueserdata pointer. + +The callback may be cancelled by passing NULL as the function. + +Only one of [*eventSetFunc*] or [*eventSetFuncEx*] can be +registered per event. +D*/ + +/*F*/ +int eventTrigger(unsigned event); +/*D +This function signals the occurrence of an event. + +. . +event: 0-31, the event +. . + +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +An event is a signal used to inform one or more consumers +to start an action. Each consumer which has registered an interest +in the event (e.g. by calling [*eventSetFunc*]) will be informed by +a callback. + +One event, PI_EVENT_BSC (31) is predefined. This event is +auto generated on BSC slave activity. + +The meaning of other events is arbitrary. + +Note that other than its id and its tick there is no data associated +with an event. +D*/ + + +/*F*/ +int shell(char *scriptName, char *scriptString); +/*D +This function uses the system call to execute a shell script +with the given string as its parameter. + +. . + scriptName: the name of the script, only alphanumeric characters, + '-' and '_' are allowed in the name +scriptString: the string to pass to the script +. . + +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +scriptName must exist in /opt/pigpio/cgi and must be executable. + +The returned exit status is normally 256 times that set by the +shell script exit function. If the script can't be found 32512 will +be returned. + +The following table gives some example returned statuses. + +Script exit status @ Returned system call status +1 @ 256 +5 @ 1280 +10 @ 2560 +200 @ 51200 +script not found @ 32512 + +... +// pass two parameters, hello and world +status = shell("scr1", "hello world"); + +// pass three parameters, hello, string with spaces, and world +status = shell("scr1", "hello 'string with spaces' world"); + +// pass one parameter, hello string with spaces world +status = shell("scr1", "\"hello string with spaces world\""); +... +D*/ + +#pragma GCC diagnostic push + +#pragma GCC diagnostic ignored "-Wcomment" + +/*F*/ +int fileOpen(char *file, unsigned mode); +/*D +This function returns a handle to a file opened in a specified mode. + +. . +file: the file to open +mode: the file open mode +. . + +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, PI_NO_FILE_ACCESS, +PI_BAD_FILE_MODE, PI_FILE_OPEN_FAILED, or PI_FILE_IS_A_DIR. + +File + +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +Suppose /opt/pigpio/access contains the following entries + +. . +/home/* n +/home/pi/shared/dir_1/* w +/home/pi/shared/dir_2/* r +/home/pi/shared/dir_3/* u +/home/pi/shared/dir_1/file.txt n +. . + +Files may be written in directory dir_1 with the exception +of file.txt. + +Files may be read in directory dir_2. + +Files may be read and written in directory dir_3. + +If a directory allows read, write, or read/write access then files may +be created in that directory. + +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +. . +a path containing .. +a path containing only wildcards (*?) +a path containing less than two non-wildcard parts +. . + +Mode + +The mode may have the following values. + +Macro @ Value @ Meaning +PI_FILE_READ @ 1 @ open file for reading +PI_FILE_WRITE @ 2 @ open file for writing +PI_FILE_RW @ 3 @ open file for reading and writing + +The following values may be or'd into the mode. + +Macro @ Value @ Meaning +PI_FILE_APPEND @ 4 @ Writes append data to the end of the file +PI_FILE_CREATE @ 8 @ The file is created if it doesn't exist +PI_FILE_TRUNC @ 16 @ The file is truncated + +Newly created files are owned by root with permissions owner read and write. + +... +#include +#include + +int main(int argc, char *argv[]) +{ + int handle, c; + char buf[60000]; + + if (gpioInitialise() < 0) return 1; + + // assumes /opt/pigpio/access contains the following line + // /ram/*.c r + + handle = fileOpen("/ram/pigpio.c", PI_FILE_READ); + + if (handle >= 0) + { + while ((c=fileRead(handle, buf, sizeof(buf)-1))) + { + buf[c] = 0; + printf("%s", buf); + } + + fileClose(handle); + } + + gpioTerminate(); +} +... +D*/ + +#pragma GCC diagnostic pop + +/*F*/ +int fileClose(unsigned handle); +/*D +This function closes the file associated with handle. + +. . +handle: >=0, as returned by a call to [*fileOpen*] +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +... +fileClose(h); +... +D*/ + + +/*F*/ +int fileWrite(unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes from buf to the the file +associated with handle. + +. . +handle: >=0, as returned by a call to [*fileOpen*] + buf: the array of bytes to write + count: the number of bytes to write +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, +PI_FILE_NOT_WOPEN, or PI_BAD_FILE_WRITE. + +... +status = fileWrite(h, buf, count); +if (status == 0) +{ + // okay +} +else +{ + // error +} +... +D*/ + + +/*F*/ +int fileRead(unsigned handle, char *buf, unsigned count); +/*D +This function reads up to count bytes from the the file +associated with handle and writes them to buf. + +. . +handle: >=0, as returned by a call to [*fileOpen*] + buf: an array to receive the read data + count: the maximum number of bytes to read +. . + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, PI_FILE_NOT_ROPEN, or PI_BAD_FILE_WRITE. + +... +if (fileRead(h, buf, sizeof(buf)) > 0) +{ + // process read data +} +... +D*/ + + +/*F*/ +int fileSeek(unsigned handle, int32_t seekOffset, int seekFrom); +/*D +This function seeks to a position within the file associated +with handle. + +. . + handle: >=0, as returned by a call to [*fileOpen*] +seekOffset: the number of bytes to move. Positive offsets + move forward, negative offsets backwards. + seekFrom: one of PI_FROM_START (0), PI_FROM_CURRENT (1), + or PI_FROM_END (2) +. . + +Returns the new byte position within the file (>=0) if OK, otherwise PI_BAD_HANDLE, or PI_BAD_FILE_SEEK. + +... +fileSeek(0, 20, PI_FROM_START); // Seek to start plus 20 + +size = fileSeek(0, 0, PI_FROM_END); // Seek to end, return size + +pos = fileSeek(0, 0, PI_FROM_CURRENT); // Return current position +... +D*/ + +#pragma GCC diagnostic push + +#pragma GCC diagnostic ignored "-Wcomment" + +/*F*/ +int fileList(char *fpat, char *buf, unsigned count); +/*D +This function returns a list of files which match a pattern. The +pattern may contain wildcards. + +. . + fpat: file pattern to match + buf: an array to receive the matching file names +count: the maximum number of bytes to read +. . + +Returns the number of returned bytes if OK, otherwise PI_NO_FILE_ACCESS, +or PI_NO_FILE_MATCH. + +The pattern must match an entry in /opt/pigpio/access. The pattern +may contain wildcards. See [*fileOpen*]. + +NOTE + +The returned value is not the number of files, it is the number +of bytes in the buffer. The file names are separated by newline +characters. + +... +#include +#include + +int main(int argc, char *argv[]) +{ + int c; + char buf[1000]; + + if (gpioInitialise() < 0) return 1; + + // assumes /opt/pigpio/access contains the following line + // /ram/*.c r + + c = fileList("/ram/p*.c", buf, sizeof(buf)); + + if (c >= 0) + { + // terminate string + buf[c] = 0; + printf("%s", buf); + } + + gpioTerminate(); +} +... +D*/ + +#pragma GCC diagnostic pop + + +/*F*/ +int gpioCfgBufferSize(unsigned cfgMillis); +/*D +Configures pigpio to buffer cfgMillis milliseconds of GPIO samples. + +This function is only effective if called before [*gpioInitialise*]. + +. . +cfgMillis: 100-10000 +. . + +The default setting is 120 milliseconds. + +The intention is to allow for bursts of data and protection against +other processes hogging cpu time. + +I haven't seen a process locked out for more than 100 milliseconds. + +Making the buffer bigger uses a LOT of memory at the more frequent +sampling rates as shown in the following table in MBs. + +. . + buffer milliseconds + 120 250 500 1sec 2sec 4sec 8sec + + 1 16 31 55 107 --- --- --- + 2 10 18 31 55 107 --- --- +sample 4 8 12 18 31 55 107 --- + rate 5 8 10 14 24 45 87 --- + (us) 8 6 8 12 18 31 55 107 + 10 6 8 10 14 24 45 87 +. . +D*/ + + +/*F*/ +int gpioCfgClock( + unsigned cfgMicros, unsigned cfgPeripheral, unsigned cfgSource); +/*D +Configures pigpio to use a particular sample rate timed by a specified +peripheral. + +This function is only effective if called before [*gpioInitialise*]. + +. . + cfgMicros: 1, 2, 4, 5, 8, 10 +cfgPeripheral: 0 (PWM), 1 (PCM) + cfgSource: deprecated, value is ignored +. . + +The timings are provided by the specified peripheral (PWM or PCM). + +The default setting is 5 microseconds using the PCM peripheral. + +The approximate CPU percentage used for each sample rate is: + +. . +sample cpu + rate % + + 1 25 + 2 16 + 4 11 + 5 10 + 8 15 + 10 14 +. . + +A sample rate of 5 microseconds seeems to be the sweet spot. +D*/ + + +/*F*/ +int gpioCfgDMAchannel(unsigned DMAchannel); /* DEPRECATED */ +/*D +Configures pigpio to use the specified DMA channel. + +This function is only effective if called before [*gpioInitialise*]. + +. . +DMAchannel: 0-14 +. . + +The default setting is to use channel 14. +D*/ + + +/*F*/ +int gpioCfgDMAchannels(unsigned primaryChannel, unsigned secondaryChannel); +/*D +Configures pigpio to use the specified DMA channels. + +This function is only effective if called before [*gpioInitialise*]. + +. . + primaryChannel: 0-14 +secondaryChannel: 0-14 +. . + +The default setting depends on whether the Pi has a BCM2711 chip or +not (currently only the Pi4B has a BCM2711). + +The default setting for a non-BCM2711 is to use channel 14 for the +primary channel and channel 6 for the secondary channel. + +The default setting for a BCM2711 is to use channel 7 for the +primary channel and channel 6 for the secondary channel. + +The secondary channel is only used for the transmission of waves. + +If possible use one of channels 0 to 6 for the secondary channel +(a full channel). + +A full channel only requires one DMA control block regardless of the +length of a pulse delay. Channels 7 to 14 (lite channels) require +one DMA control block for each 16383 microseconds of delay. I.e. +a 10 second pulse delay requires one control block on a full channel +and 611 control blocks on a lite channel. +D*/ + + +/*F*/ +int gpioCfgPermissions(uint64_t updateMask); +/*D +Configures pigpio to restrict GPIO updates via the socket or pipe +interfaces to the GPIO specified by the mask. Programs directly +calling the pigpio library (i.e. linked with -lpigpio are not +affected). A GPIO update is a write to a GPIO or a GPIO mode +change or any function which would force such an action. + +This function is only effective if called before [*gpioInitialise*]. + +. . +updateMask: bit (1<=0 +arg2: >=0 +argx: extra (byte) arguments +argc: number of extra arguments +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. +D*/ + + +/*F*/ +int gpioCustom2(unsigned arg1, char *argx, unsigned argc, + char *retBuf, unsigned retMax); +/*D +This function is available for user customisation. + +It differs from gpioCustom1 in that it returns an array of bytes +rather than just an integer. + +The returned value is an integer indicating the number of returned bytes. +. . + arg1: >=0 + argx: extra (byte) arguments + argc: number of extra arguments +retBuf: buffer for returned bytes +retMax: maximum number of bytes to return +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. + +The number of returned bytes must be retMax or less. +D*/ + + +/*F*/ +int rawWaveAddSPI( + rawSPI_t *spi, + unsigned offset, + unsigned spiSS, + char *buf, + unsigned spiTxBits, + unsigned spiBitFirst, + unsigned spiBitLast, + unsigned spiBits); +/*D +This function adds a waveform representing SPI data to the +existing waveform (if any). + +. . + spi: a pointer to a spi object + offset: microseconds from the start of the waveform + spiSS: the slave select GPIO + buf: the bits to transmit, most significant bit first + spiTxBits: the number of bits to write +spiBitFirst: the first bit to read + spiBitLast: the last bit to read + spiBits: the number of bits to transfer +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_SER_OFFSET, or PI_TOO_MANY_PULSES. + +Not intended for general use. +D*/ + +/*F*/ +int rawWaveAddGeneric(unsigned numPulses, rawWave_t *pulses); +/*D +This function adds a number of pulses to the current waveform. + +. . +numPulses: the number of pulses + pulses: the array containing the pulses +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +The advantage of this function over gpioWaveAddGeneric is that it +allows the setting of the flags field. + +The pulses are interleaved in time order within the existing waveform +(if any). + +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist of a delay. + +Not intended for general use. +D*/ + +/*F*/ +unsigned rawWaveCB(void); +/*D +Returns the number of the cb being currently output. + +Not intended for general use. +D*/ + +/*F*/ +rawCbs_t *rawWaveCBAdr(int cbNum); +/*D +Return the (Linux) address of contol block cbNum. + +. . +cbNum: the cb of interest +. . + +Not intended for general use. +D*/ + +/*F*/ +uint32_t rawWaveGetOOL(int pos); +/*D +Gets the OOL parameter stored at pos. + +. . +pos: the position of interest. +. . + +Not intended for general use. +D*/ + + +/*F*/ +void rawWaveSetOOL(int pos, uint32_t lVal); +/*D +Sets the OOL parameter stored at pos to value. + +. . + pos: the position of interest +lVal: the value to write +. . + +Not intended for general use. +D*/ + +/*F*/ +uint32_t rawWaveGetOut(int pos); +/*D +Gets the wave output parameter stored at pos. + +DEPRECATED: use rawWaveGetOOL instead. + +. . +pos: the position of interest. +. . + +Not intended for general use. +D*/ + + +/*F*/ +void rawWaveSetOut(int pos, uint32_t lVal); +/*D +Sets the wave output parameter stored at pos to value. + +DEPRECATED: use rawWaveSetOOL instead. + +. . + pos: the position of interest +lVal: the value to write +. . + +Not intended for general use. +D*/ + +/*F*/ +uint32_t rawWaveGetIn(int pos); +/*D +Gets the wave input value parameter stored at pos. + +DEPRECATED: use rawWaveGetOOL instead. + +. . +pos: the position of interest +. . + +Not intended for general use. +D*/ + + +/*F*/ +void rawWaveSetIn(int pos, uint32_t lVal); +/*D +Sets the wave input value stored at pos to value. + +DEPRECATED: use rawWaveSetOOL instead. + +. . + pos: the position of interest +lVal: the value to write +. . + +Not intended for general use. +D*/ + +/*F*/ +rawWaveInfo_t rawWaveInfo(int wave_id); +/*D +Gets details about the wave with id wave_id. + +. . +wave_id: the wave of interest +. . + +Not intended for general use. +D*/ + +/*F*/ +int getBitInBytes(int bitPos, char *buf, int numBits); +/*D +Returns the value of the bit bitPos bits from the start of buf. Returns +0 if bitPos is greater than or equal to numBits. + +. . + bitPos: bit index from the start of buf + buf: array of bits +numBits: number of valid bits in buf +. . + +D*/ + +/*F*/ +void putBitInBytes(int bitPos, char *buf, int bit); +/*D +Sets the bit bitPos bits from the start of buf to bit. + +. . +bitPos: bit index from the start of buf + buf: array of bits + bit: 0-1, value to set +. . + +D*/ + +/*F*/ +double time_time(void); +/*D +Return the current time in seconds since the Epoch. +D*/ + + +/*F*/ +void time_sleep(double seconds); +/*D +Delay execution for a given number of seconds + +. . +seconds: the number of seconds to sleep +. . +D*/ + + +/*F*/ +void rawDumpWave(void); +/*D +Used to print a readable version of the current waveform to stderr. + +Not intended for general use. +D*/ + + +/*F*/ +void rawDumpScript(unsigned script_id); +/*D +Used to print a readable version of a script to stderr. + +. . +script_id: >=0, a script_id returned by [*gpioStoreScript*] +. . + +Not intended for general use. +D*/ + + +#ifdef __cplusplus +} +#endif + +/*PARAMS + +active :: 0-1000000 + +The number of microseconds level changes are reported for once +a noise filter has been triggered (by [*steady*] microseconds of +a stable level). + +arg1:: + +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +arg2:: + +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +argc:: +The count of bytes passed to a user customised function. + +*argx:: +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +baud:: +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +bit:: +A value of 0 or 1. + +bitPos:: +A bit position within a byte or word. The least significant bit is +position 0. + +bits:: +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +A convenient way to set bit n is to or in (1<=0 + +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + +gpio:: + +A Broadcom numbered GPIO, in the range 0-53. + +There are 54 General Purpose Input Outputs (GPIO) named GPIO0 through +GPIO53. + +They are split into two banks. Bank 1 consists of GPIO0 through +GPIO31. Bank 2 consists of GPIO32 through GPIO53. + +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +See [*gpioHardwareRevision*]. + +The user GPIO are marked with an X in the following table. + +. . + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +Type 1 X X - - X - - X X X X X - - X X +Type 2 - - X X X - - X X X X X - - X X +Type 3 X X X X X X X X X X X X X X + + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +Type 1 - X X - - X X X X X - - - - - - +Type 2 - X X - - - X X X X - X X X X X +Type 3 X X X X X X X X X X X X - - - - +. . + +gpioAlertFunc_t:: +. . +typedef void (*gpioAlertFunc_t) (int gpio, int level, uint32_t tick); +. . + +gpioAlertFuncEx_t:: +. . +typedef void (*eventFuncEx_t) + (int event, int level, uint32_t tick, void *userdata); +. . + +gpioCfg*:: + +These functions are only effective if called before [*gpioInitialise*]. + +[*gpioCfgBufferSize*] +[*gpioCfgClock*] +[*gpioCfgDMAchannel*] +[*gpioCfgDMAchannels*] +[*gpioCfgPermissions*] +[*gpioCfgInterfaces*] +[*gpioCfgSocketPort*] +[*gpioCfgMemAlloc*] + +gpioGetSamplesFunc_t:: +. . +typedef void (*gpioGetSamplesFunc_t) + (const gpioSample_t *samples, int numSamples); +. . + +gpioGetSamplesFuncEx_t:: +. . +typedef void (*gpioGetSamplesFuncEx_t) + (const gpioSample_t *samples, int numSamples, void *userdata); +. . + +gpioISRFunc_t:: +. . +typedef void (*gpioISRFunc_t) + (int gpio, int level, uint32_t tick); +. . + +gpioISRFuncEx_t:: +. . +typedef void (*gpioISRFuncEx_t) + (int gpio, int level, uint32_t tick, void *userdata); +. . + +gpioPulse_t:: +. . +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; +} gpioPulse_t; +. . + +gpioSample_t:: +. . +typedef struct +{ + uint32_t tick; + uint32_t level; +} gpioSample_t; +. . + +gpioSignalFunc_t:: +. . +typedef void (*gpioSignalFunc_t) (int signum); +. . + +gpioSignalFuncEx_t:: +. . +typedef void (*gpioSignalFuncEx_t) (int signum, void *userdata); +. . + +gpioThreadFunc_t:: +. . +typedef void *(gpioThreadFunc_t) (void *); +. . + +gpioTimerFunc_t:: +. . +typedef void (*gpioTimerFunc_t) (void); +. . + +gpioTimerFuncEx_t:: +. . +typedef void (*gpioTimerFuncEx_t) (void *userdata); +. . + +gpioWaveAdd*:: + +One of + +[*gpioWaveAddNew*] +[*gpioWaveAddGeneric*] +[*gpioWaveAddSerial*] + +handle::>=0 + +A number referencing an object opened by one of + +[*fileOpen*] +[*gpioNotifyOpen*] +[*i2cOpen*] +[*serOpen*] +[*spiOpen*] + +i2cAddr:: 0-0x7F +The address of a device on the I2C bus. + +i2cBus::>=0 + +An I2C bus number. + +i2cFlags::0 + +Flags which modify an I2C open command. None are currently defined. + +i2cReg:: 0-255 + +A register of an I2C device. + +ifFlags::0-3 +. . +PI_DISABLE_FIFO_IF 1 +PI_DISABLE_SOCK_IF 2 +. . + +*inBuf:: +A buffer used to pass data to a function. + +inLen:: +The number of bytes of data in a buffer. + +int:: +A whole number, negative or positive. + +int32_t:: +A 32-bit signed value. + +invert:: +A flag used to set normal or inverted bit bang serial data level logic. + +level:: +The level of a GPIO. Low or High. + +. . +PI_OFF 0 +PI_ON 1 + +PI_CLEAR 0 +PI_SET 1 + +PI_LOW 0 +PI_HIGH 1 +. . + +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See [*gpioSetWatchdog*]. + +. . +PI_TIMEOUT 2 +. . + + +lVal::0-4294967295 (Hex 0x0-0xFFFFFFFF, Octal 0-37777777777) + +A 32-bit word value. + +memAllocMode:: 0-2 + +The DMA memory allocation mode. + +. . +PI_MEM_ALLOC_AUTO 0 +PI_MEM_ALLOC_PAGEMAP 1 +PI_MEM_ALLOC_MAILBOX 2 +. . + +*micros:: + +A value representing microseconds. + +micros:: + +A value representing microseconds. + +millis:: + +A value representing milliseconds. + +MISO:: +The GPIO used for the MISO signal when bit banging SPI. + +mode:: + +1. The operational mode of a GPIO, normally INPUT or OUTPUT. + +. . +PI_INPUT 0 +PI_OUTPUT 1 +PI_ALT0 4 +PI_ALT1 5 +PI_ALT2 6 +PI_ALT3 7 +PI_ALT4 3 +PI_ALT5 2 +. . + +2. A file open mode. + +. . +PI_FILE_READ 1 +PI_FILE_WRITE 2 +PI_FILE_RW 3 +. . + +The following values can be or'd into the mode. + +. . +PI_FILE_APPEND 4 +PI_FILE_CREATE 8 +PI_FILE_TRUNC 16 +. . + +MOSI:: +The GPIO used for the MOSI signal when bit banging SPI. + +numBits:: + +The number of bits stored in a buffer. + +numBytes:: +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +numPar:: 0-10 +The number of parameters passed to a script. + +numPulses:: +The number of pulses to be added to a waveform. + +numSegs:: +The number of segments in a combined I2C transaction. + +numSockAddr:: +The number of network addresses allowed to use the socket interface. + +0 means all addresses allowed. + +offset:: +The associated data starts this number of microseconds from the start of +the waveform. + +*outBuf:: +A buffer used to return data from a function. + +outLen:: +The size in bytes of an output buffer. + +pad:: 0-2 +A set of GPIO which share common drivers. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +padStrength:: 1-16 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +*param:: +An array of script parameters. + +pctBOOL:: 0-100 +percent On-Off-Level (OOL) buffer to consume for wave output. + +pctCB:: 0-100 +the percent of all DMA control blocks to consume. + +pctTOOL:: 0-100 +the percent of OOL buffer to consume for wave input (flags). + +pi_i2c_msg_t:: +. . +typedef struct +{ + uint16_t addr; // slave address + uint16_t flags; + uint16_t len; // msg length + uint8_t *buf; // pointer to msg data +} pi_i2c_msg_t; +. . + +port:: 1024-32000 +The port used to bind to the pigpio socket. Defaults to 8888. + +pos:: +The position of an item. + +primaryChannel:: 0-15 +The DMA channel used to time the sampling of GPIO and to time servo and +PWM pulses. + +*pth:: + +A thread identifier, returned by [*gpioStartThread*]. + +pthread_t:: + +A thread identifier. + +pud::0-2 + +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. + +. . +PI_PUD_OFF 0 +PI_PUD_DOWN 1 +PI_PUD_UP 2 +. . + +pulseLen:: + +1-100, the length of a trigger pulse in microseconds. + +*pulses:: + +An array of pulses to be added to a waveform. + +pulsewidth::0, 500-2500 +. . +PI_SERVO_OFF 0 +PI_MIN_SERVO_PULSEWIDTH 500 +PI_MAX_SERVO_PULSEWIDTH 2500 +. . + +PWMduty::0-1000000 (1M) +The hardware PWM dutycycle. + +. . +PI_HW_PWM_RANGE 1000000 +. . + +PWMfreq::1-125M (1-187.5M for the BCM2711) +The hardware PWM frequency. + +. . +PI_HW_PWM_MIN_FREQ 1 +PI_HW_PWM_MAX_FREQ 125000000 +PI_HW_PWM_MAX_FREQ_2711 187500000 +. . + +range::25-40000 +. . +PI_MIN_DUTYCYCLE_RANGE 25 +PI_MAX_DUTYCYCLE_RANGE 40000 +. . + +rawCbs_t:: +. . +typedef struct // linux/arch/arm/mach-bcm2708/include/mach/dma.h +{ + unsigned long info; + unsigned long src; + unsigned long dst; + unsigned long length; + unsigned long stride; + unsigned long next; + unsigned long pad[2]; +} rawCbs_t; +. . + +rawSPI_t:: +. . +typedef struct +{ + int clk; // GPIO for clock + int mosi; // GPIO for MOSI + int miso; // GPIO for MISO + int ss_pol; // slave select off state + int ss_us; // delay after slave select + int clk_pol; // clock off state + int clk_pha; // clock phase + int clk_us; // clock micros +} rawSPI_t; +. . + +rawWave_t:: +. . +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; + uint32_t flags; +} rawWave_t; +. . + +rawWaveInfo_t:: +. . +typedef struct +{ + uint16_t botCB; // first CB used by wave + uint16_t topCB; // last CB used by wave + uint16_t botOOL; // last OOL used by wave + uint16_t topOOL; // first OOL used by wave + uint16_t deleted; + uint16_t numCB; + uint16_t numBOOL; + uint16_t numTOOL; +} rawWaveInfo_t; +. . + +*retBuf:: + +A buffer to hold a number of bytes returned to a used customised function, + +retMax:: + +The maximum number of bytes a user customised function should return. + +*rxBuf:: + +A pointer to a buffer to receive data. + +SCL:: +The user GPIO to use for the clock when bit banging I2C. + +SCLK:: +The GPIO used for the SCLK signal when bit banging SPI. + +*script:: +A pointer to the text of a script. + +script_id:: +An id of a stored script as returned by [*gpioStoreScript*]. + +*scriptName:: +The name of a [*shell*] script to be executed. The script must be present in +/opt/pigpio/cgi and must have execute permission. + +*scriptString:: +The string to be passed to a [*shell*] script to be executed. + +SDA:: +The user GPIO to use for data when bit banging I2C. + +secondaryChannel:: 0-6 + +The DMA channel used to time output waveforms. + +*seconds:: + +A pointer to a uint32_t to store the second component of +a returned time. + +seconds:: +The number of seconds. + +seekFrom:: + +. . +PI_FROM_START 0 +PI_FROM_CURRENT 1 +PI_FROM_END 2 +. . + +seekOffset:: +The number of bytes to move forward (positive) or backwards (negative) +from the seek position (start, current, or end of file). + +*segs:: +An array of segments which make up a combined I2C transaction. + +serFlags:: +Flags which modify a serial open command. None are currently defined. + +*sertty:: +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +setting:: +A value used to set a flag, 0 for false, non-zero for true. + +signum::0-63 +. . +PI_MIN_SIGNUM 0 +PI_MAX_SIGNUM 63 +. . + +size_t:: + +A standard type used to indicate the size of an object in bytes. + +*sockAddr:: +An array of network addresses allowed to use the socket interface encoded +as 32 bit numbers. + +E.g. address 192.168.1.66 would be encoded as 0x4201a8c0. + +*spi:: +A pointer to a [*rawSPI_t*] structure. + +spiBitFirst:: +GPIO reads are made from spiBitFirst to spiBitLast. + +spiBitLast:: + +GPIO reads are made from spiBitFirst to spiBitLast. + +spiBits:: +The number of bits to transfer in a raw SPI transaction. + +spiChan:: +A SPI channel, 0-2. + +spiFlags:: +See [*spiOpen*] and [*bbSPIOpen*]. + +spiSS:: +The SPI slave select GPIO in a raw SPI transaction. + +spiTxBits:: +The number of bits to transfer dring a raw SPI transaction + +steady :: 0-300000 + +The number of microseconds level changes must be stable for +before reporting the level changed ([*gpioGlitchFilter*]) or triggering +the active part of a noise filter ([*gpioNoiseFilter*]). + +stop_bits::2-8 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +. . +PI_MIN_WAVE_HALFSTOPBITS 2 +PI_MAX_WAVE_HALFSTOPBITS 8 +. . + +*str:: +An array of characters. + +timeout:: +A GPIO level change timeout in milliseconds. + +[*gpioSetWatchdog*] +. . +PI_MIN_WDOG_TIMEOUT 0 +PI_MAX_WDOG_TIMEOUT 60000 +. . + +[*gpioSetISRFunc*] and [*gpioSetISRFuncEx*] +. . +<=0 cancel timeout +>0 timeout after specified milliseconds +. . + +timer:: +. . +PI_MIN_TIMER 0 +PI_MAX_TIMER 9 +. . + +timetype:: +. . +PI_TIME_RELATIVE 0 +PI_TIME_ABSOLUTE 1 +. . + +*txBuf:: + +An array of bytes to transmit. + +uint32_t::0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF) + +A 32-bit unsigned value. + +uint64_t::0-(2^64)-1 + +A 64-bit unsigned value. + +unsigned:: + +A whole number >= 0. + +updateMask:: + +A 64 bit mask indicating which GPIO may be written to by the user. + +If GPIO#n may be written then bit (1< 4 +#define PI_BAD_CHANNEL -27 // DMA channel not 0-15 +#define PI_BAD_PRIM_CHANNEL -27 // DMA primary channel not 0-15 +#define PI_BAD_SOCKET_PORT -28 // socket port not 1024-32000 +#define PI_BAD_FIFO_COMMAND -29 // unrecognized fifo command +#define PI_BAD_SECO_CHANNEL -30 // DMA secondary channel not 0-15 +#define PI_NOT_INITIALISED -31 // function called before gpioInitialise +#define PI_INITIALISED -32 // function called after gpioInitialise +#define PI_BAD_WAVE_MODE -33 // waveform mode not 0-3 +#define PI_BAD_CFG_INTERNAL -34 // bad parameter in gpioCfgInternals call +#define PI_BAD_WAVE_BAUD -35 // baud rate not 50-250K(RX)/50-1M(TX) +#define PI_TOO_MANY_PULSES -36 // waveform has too many pulses +#define PI_TOO_MANY_CHARS -37 // waveform has too many chars +#define PI_NOT_SERIAL_GPIO -38 // no bit bang serial read on GPIO +#define PI_BAD_SERIAL_STRUC -39 // bad (null) serial structure parameter +#define PI_BAD_SERIAL_BUF -40 // bad (null) serial buf parameter +#define PI_NOT_PERMITTED -41 // GPIO operation not permitted +#define PI_SOME_PERMITTED -42 // one or more GPIO not permitted +#define PI_BAD_WVSC_COMMND -43 // bad WVSC subcommand +#define PI_BAD_WVSM_COMMND -44 // bad WVSM subcommand +#define PI_BAD_WVSP_COMMND -45 // bad WVSP subcommand +#define PI_BAD_PULSELEN -46 // trigger pulse length not 1-100 +#define PI_BAD_SCRIPT -47 // invalid script +#define PI_BAD_SCRIPT_ID -48 // unknown script id +#define PI_BAD_SER_OFFSET -49 // add serial data offset > 30 minutes +#define PI_GPIO_IN_USE -50 // GPIO already in use +#define PI_BAD_SERIAL_COUNT -51 // must read at least a byte at a time +#define PI_BAD_PARAM_NUM -52 // script parameter id not 0-9 +#define PI_DUP_TAG -53 // script has duplicate tag +#define PI_TOO_MANY_TAGS -54 // script has too many tags +#define PI_BAD_SCRIPT_CMD -55 // illegal script command +#define PI_BAD_VAR_NUM -56 // script variable id not 0-149 +#define PI_NO_SCRIPT_ROOM -57 // no more room for scripts +#define PI_NO_MEMORY -58 // can't allocate temporary memory +#define PI_SOCK_READ_FAILED -59 // socket read failed +#define PI_SOCK_WRIT_FAILED -60 // socket write failed +#define PI_TOO_MANY_PARAM -61 // too many script parameters (> 10) +#define PI_NOT_HALTED -62 // DEPRECATED +#define PI_SCRIPT_NOT_READY -62 // script initialising +#define PI_BAD_TAG -63 // script has unresolved tag +#define PI_BAD_MICS_DELAY -64 // bad MICS delay (too large) +#define PI_BAD_MILS_DELAY -65 // bad MILS delay (too large) +#define PI_BAD_WAVE_ID -66 // non existent wave id +#define PI_TOO_MANY_CBS -67 // No more CBs for waveform +#define PI_TOO_MANY_OOL -68 // No more OOL for waveform +#define PI_EMPTY_WAVEFORM -69 // attempt to create an empty waveform +#define PI_NO_WAVEFORM_ID -70 // no more waveforms +#define PI_I2C_OPEN_FAILED -71 // can't open I2C device +#define PI_SER_OPEN_FAILED -72 // can't open serial device +#define PI_SPI_OPEN_FAILED -73 // can't open SPI device +#define PI_BAD_I2C_BUS -74 // bad I2C bus +#define PI_BAD_I2C_ADDR -75 // bad I2C address +#define PI_BAD_SPI_CHANNEL -76 // bad SPI channel +#define PI_BAD_FLAGS -77 // bad i2c/spi/ser open flags +#define PI_BAD_SPI_SPEED -78 // bad SPI speed +#define PI_BAD_SER_DEVICE -79 // bad serial device name +#define PI_BAD_SER_SPEED -80 // bad serial baud rate +#define PI_BAD_PARAM -81 // bad i2c/spi/ser parameter +#define PI_I2C_WRITE_FAILED -82 // i2c write failed +#define PI_I2C_READ_FAILED -83 // i2c read failed +#define PI_BAD_SPI_COUNT -84 // bad SPI count +#define PI_SER_WRITE_FAILED -85 // ser write failed +#define PI_SER_READ_FAILED -86 // ser read failed +#define PI_SER_READ_NO_DATA -87 // ser read no data available +#define PI_UNKNOWN_COMMAND -88 // unknown command +#define PI_SPI_XFER_FAILED -89 // spi xfer/read/write failed +#define PI_BAD_POINTER -90 // bad (NULL) pointer +#define PI_NO_AUX_SPI -91 // no auxiliary SPI on Pi A or B +#define PI_NOT_PWM_GPIO -92 // GPIO is not in use for PWM +#define PI_NOT_SERVO_GPIO -93 // GPIO is not in use for servo pulses +#define PI_NOT_HCLK_GPIO -94 // GPIO has no hardware clock +#define PI_NOT_HPWM_GPIO -95 // GPIO has no hardware PWM +#define PI_BAD_HPWM_FREQ -96 // invalid hardware PWM frequency +#define PI_BAD_HPWM_DUTY -97 // hardware PWM dutycycle not 0-1M +#define PI_BAD_HCLK_FREQ -98 // invalid hardware clock frequency +#define PI_BAD_HCLK_PASS -99 // need password to use hardware clock 1 +#define PI_HPWM_ILLEGAL -100 // illegal, PWM in use for main clock +#define PI_BAD_DATABITS -101 // serial data bits not 1-32 +#define PI_BAD_STOPBITS -102 // serial (half) stop bits not 2-8 +#define PI_MSG_TOOBIG -103 // socket/pipe message too big +#define PI_BAD_MALLOC_MODE -104 // bad memory allocation mode +#define PI_TOO_MANY_SEGS -105 // too many I2C transaction segments +#define PI_BAD_I2C_SEG -106 // an I2C transaction segment failed +#define PI_BAD_SMBUS_CMD -107 // SMBus command not supported by driver +#define PI_NOT_I2C_GPIO -108 // no bit bang I2C in progress on GPIO +#define PI_BAD_I2C_WLEN -109 // bad I2C write length +#define PI_BAD_I2C_RLEN -110 // bad I2C read length +#define PI_BAD_I2C_CMD -111 // bad I2C command +#define PI_BAD_I2C_BAUD -112 // bad I2C baud rate, not 50-500k +#define PI_CHAIN_LOOP_CNT -113 // bad chain loop count +#define PI_BAD_CHAIN_LOOP -114 // empty chain loop +#define PI_CHAIN_COUNTER -115 // too many chain counters +#define PI_BAD_CHAIN_CMD -116 // bad chain command +#define PI_BAD_CHAIN_DELAY -117 // bad chain delay micros +#define PI_CHAIN_NESTING -118 // chain counters nested too deeply +#define PI_CHAIN_TOO_BIG -119 // chain is too long +#define PI_DEPRECATED -120 // deprecated function removed +#define PI_BAD_SER_INVERT -121 // bit bang serial invert not 0 or 1 +#define PI_BAD_EDGE -122 // bad ISR edge value, not 0-2 +#define PI_BAD_ISR_INIT -123 // bad ISR initialisation +#define PI_BAD_FOREVER -124 // loop forever must be last command +#define PI_BAD_FILTER -125 // bad filter parameter +#define PI_BAD_PAD -126 // bad pad number +#define PI_BAD_STRENGTH -127 // bad pad drive strength +#define PI_FIL_OPEN_FAILED -128 // file open failed +#define PI_BAD_FILE_MODE -129 // bad file mode +#define PI_BAD_FILE_FLAG -130 // bad file flag +#define PI_BAD_FILE_READ -131 // bad file read +#define PI_BAD_FILE_WRITE -132 // bad file write +#define PI_FILE_NOT_ROPEN -133 // file not open for read +#define PI_FILE_NOT_WOPEN -134 // file not open for write +#define PI_BAD_FILE_SEEK -135 // bad file seek +#define PI_NO_FILE_MATCH -136 // no files match pattern +#define PI_NO_FILE_ACCESS -137 // no permission to access file +#define PI_FILE_IS_A_DIR -138 // file is a directory +#define PI_BAD_SHELL_STATUS -139 // bad shell return status +#define PI_BAD_SCRIPT_NAME -140 // bad script name +#define PI_BAD_SPI_BAUD -141 // bad SPI baud rate, not 50-500k +#define PI_NOT_SPI_GPIO -142 // no bit bang SPI in progress on GPIO +#define PI_BAD_EVENT_ID -143 // bad event id +#define PI_CMD_INTERRUPTED -144 // Used by Python +#define PI_NOT_ON_BCM2711 -145 // not available on BCM2711 +#define PI_ONLY_ON_BCM2711 -146 // only available on BCM2711 + +#define PI_PIGIF_ERR_0 -2000 +#define PI_PIGIF_ERR_99 -2099 + +#define PI_CUSTOM_ERR_0 -3000 +#define PI_CUSTOM_ERR_999 -3999 + +/*DEF_E*/ + +/*DEF_S Defaults*/ + +#define PI_DEFAULT_BUFFER_MILLIS 120 +#define PI_DEFAULT_CLK_MICROS 5 +#define PI_DEFAULT_CLK_PERIPHERAL PI_CLOCK_PCM +#define PI_DEFAULT_IF_FLAGS 0 +#define PI_DEFAULT_FOREGROUND 0 +#define PI_DEFAULT_DMA_CHANNEL 14 +#define PI_DEFAULT_DMA_PRIMARY_CHANNEL 14 +#define PI_DEFAULT_DMA_SECONDARY_CHANNEL 6 +#define PI_DEFAULT_DMA_PRIMARY_CH_2711 7 +#define PI_DEFAULT_DMA_SECONDARY_CH_2711 6 +#define PI_DEFAULT_DMA_NOT_SET 15 +#define PI_DEFAULT_SOCKET_PORT 8888 +#define PI_DEFAULT_SOCKET_PORT_STR "8888" +#define PI_DEFAULT_SOCKET_ADDR_STR "localhost" +#define PI_DEFAULT_UPDATE_MASK_UNKNOWN 0x0000000FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_B1 0x03E7CF93 +#define PI_DEFAULT_UPDATE_MASK_A_B2 0xFBC7CF9C +#define PI_DEFAULT_UPDATE_MASK_APLUS_BPLUS 0x0080480FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_ZERO 0x0080000FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_PI2B 0x0080480FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_PI3B 0x0000000FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_PI4B 0x0000000FFFFFFCLL +#define PI_DEFAULT_UPDATE_MASK_COMPUTE 0x00FFFFFFFFFFFFLL +#define PI_DEFAULT_MEM_ALLOC_MODE PI_MEM_ALLOC_AUTO + +#define PI_DEFAULT_CFG_INTERNALS 0 + +/*DEF_E*/ + +#endif + diff --git a/pigpio-master/pigpio.py b/pigpio-master/pigpio.py new file mode 100644 index 0000000..20d48e6 --- /dev/null +++ b/pigpio-master/pigpio.py @@ -0,0 +1,5821 @@ +""" +pigpio is a Python module for the Raspberry which talks to +the pigpio daemon to allow control of the general purpose +input outputs (GPIO). + +[http://abyz.me.uk/rpi/pigpio/python.html] + +*Features* + +o the pigpio Python module can run on Windows, Macs, or Linux + +o controls one or more Pi's + +o hardware timed PWM on any of GPIO 0-31 + +o hardware timed servo pulses on any of GPIO 0-31 + +o callbacks when any of GPIO 0-31 change state + +o creating and transmitting precisely timed waveforms + +o reading/writing GPIO and setting their modes + +o wrappers for I2C, SPI, and serial links + +o creating and running scripts on the pigpio daemon + +*GPIO* + +ALL GPIO are identified by their Broadcom number. + +*Notes* + +Transmitted waveforms are accurate to a microsecond. + +Callback level changes are time-stamped and will be +accurate to within a few microseconds. + +*Settings* + +A number of settings are determined when the pigpio daemon is started. + +o the sample rate (1, 2, 4, 5, 8, or 10 us, default 5 us). + +o the set of GPIO which may be updated (generally written to). The + default set is those available on the Pi board revision. + +o the available PWM frequencies (see [*set_PWM_frequency*]). + +*Exceptions* + +By default a fatal exception is raised if you pass an invalid +argument to a pigpio function. + +If you wish to handle the returned status yourself you should set +pigpio.exceptions to False. + +You may prefer to check the returned status in only a few parts +of your code. In that case do the following: + +... +pigpio.exceptions = False + +# Code where you want to test the error status. + +pigpio.exceptions = True +... + +*Usage* + +This module uses the services of the C pigpio library. pigpio +must be running on the Pi(s) whose GPIO are to be manipulated. + +The normal way to start pigpio is as a daemon (during system +start). + +sudo pigpiod + +Your Python program must import pigpio and create one or more +instances of the pigpio.pi class. This class gives access to +a specified Pi's GPIO. + +... +pi1 = pigpio.pi() # pi1 accesses the local Pi's GPIO +pi2 = pigpio.pi('tom') # pi2 accesses tom's GPIO +pi3 = pigpio.pi('dick') # pi3 accesses dick's GPIO + +pi1.write(4, 0) # set local Pi's GPIO 4 low +pi2.write(4, 1) # set tom's GPIO 4 to high +pi3.read(4) # get level of dick's GPIO 4 +... + +The later example code snippets assume that pi is an instance of +the pigpio.pi class. + +OVERVIEW + +ESSENTIAL + +pigpio.pi Initialise Pi connection +stop Stop a Pi connection + +BASIC + +set_mode Set a GPIO mode +get_mode Get a GPIO mode + +set_pull_up_down Set/clear GPIO pull up/down resistor + +read Read a GPIO +write Write a GPIO + +PWM_(overrides_servo_commands_on_same_GPIO) + +set_PWM_dutycycle Start/stop PWM pulses on a GPIO +set_PWM_frequency Set PWM frequency of a GPIO +set_PWM_range Configure PWM range of a GPIO + +get_PWM_dutycycle Get PWM dutycycle set on a GPIO +get_PWM_frequency Get PWM frequency of a GPIO +get_PWM_range Get configured PWM range of a GPIO + +get_PWM_real_range Get underlying PWM range for a GPIO + +Servo_(overrides_PWM_commands_on_same_GPIO) + +set_servo_pulsewidth Start/Stop servo pulses on a GPIO + +get_servo_pulsewidth Get servo pulsewidth set on a GPIO + +INTERMEDIATE + +gpio_trigger Send a trigger pulse to a GPIO + +set_watchdog Set a watchdog on a GPIO + +read_bank_1 Read all bank 1 GPIO +read_bank_2 Read all bank 2 GPIO + +clear_bank_1 Clear selected GPIO in bank 1 +clear_bank_2 Clear selected GPIO in bank 2 + +set_bank_1 Set selected GPIO in bank 1 +set_bank_2 Set selected GPIO in bank 2 + +callback Create GPIO level change callback + +wait_for_edge Wait for GPIO level change + +ADVANCED + +notify_open Request a notification handle +notify_begin Start notifications for selected GPIO +notify_pause Pause notifications +notify_close Close a notification + +hardware_clock Start hardware clock on supported GPIO + +hardware_PWM Start hardware PWM on supported GPIO + +set_glitch_filter Set a glitch filter on a GPIO +set_noise_filter Set a noise filter on a GPIO + +set_pad_strength Sets a pads drive strength +get_pad_strength Gets a pads drive strength + +shell Executes a shell command + +Custom + +custom_1 User custom function 1 +custom_2 User custom function 2 + +Events + +event_callback Sets a callback for an event + +event_trigger Triggers an event + +wait_for_event Wait for an event + +Scripts + +store_script Store a script +run_script Run a stored script +update_script Set a scripts parameters +script_status Get script status and parameters +stop_script Stop a running script +delete_script Delete a stored script + +I2C + +i2c_open Opens an I2C device +i2c_close Closes an I2C device + +i2c_write_quick SMBus write quick + +i2c_read_byte SMBus read byte +i2c_write_byte SMBus write byte + +i2c_read_byte_data SMBus read byte data +i2c_write_byte_data SMBus write byte data + +i2c_read_word_data SMBus read word data +i2c_write_word_data SMBus write word data + +i2c_read_block_data SMBus read block data +i2c_write_block_data SMBus write block data + +i2c_read_i2c_block_data SMBus read I2C block data +i2c_write_i2c_block_data SMBus write I2C block data + +i2c_read_device Reads the raw I2C device +i2c_write_device Writes the raw I2C device + +i2c_process_call SMBus process call +i2c_block_process_call SMBus block process call + +i2c_zip Performs multiple I2C transactions + +I2C_BIT_BANG + +bb_i2c_open Opens GPIO for bit banging I2C +bb_i2c_close Closes GPIO for bit banging I2C + +bb_i2c_zip Performs multiple bit banged I2C transactions + +I2C/SPI_SLAVE + +bsc_xfer I2C/SPI as slave transfer +bsc_i2c I2C as slave transfer + +SERIAL + +serial_open Opens a serial device +serial_close Closes a serial device + +serial_read_byte Reads a byte from a serial device +serial_write_byte Writes a byte to a serial device + +serial_read Reads bytes from a serial device +serial_write Writes bytes to a serial device + +serial_data_available Returns number of bytes ready to be read + +SERIAL_BIT_BANG_(read_only) + +bb_serial_read_open Open a GPIO for bit bang serial reads +bb_serial_read_close Close a GPIO for bit bang serial reads + +bb_serial_invert Invert serial logic (1 invert, 0 normal) + +bb_serial_read Read bit bang serial data from a GPIO + +SPI + +spi_open Opens a SPI device +spi_close Closes a SPI device + +spi_read Reads bytes from a SPI device +spi_write Writes bytes to a SPI device +spi_xfer Transfers bytes with a SPI device + +SPI_BIT_BANG + +bb_spi_open Opens GPIO for bit banging SPI +bb_spi_close Closes GPIO for bit banging SPI +bb_spi_xfer Transfers bytes with bit banging SPI + +FILES + +file_open Opens a file +file_close Closes a file + +file_read Reads bytes from a file +file_write Writes bytes to a file + +file_seek Seeks to a position within a file + +file_list List files which match a pattern + +WAVES + +wave_clear Deletes all waveforms + +wave_add_new Starts a new waveform +wave_add_generic Adds a series of pulses to the waveform +wave_add_serial Adds serial data to the waveform + +wave_create Creates a waveform from added data +wave_create_and_pad Creates a waveform of fixed size from added data +wave_delete Deletes a waveform + +wave_send_once Transmits a waveform once +wave_send_repeat Transmits a waveform repeatedly +wave_send_using_mode Transmits a waveform in the chosen mode + +wave_chain Transmits a chain of waveforms + +wave_tx_at Returns the current transmitting waveform + +wave_tx_busy Checks to see if a waveform has ended + +wave_tx_stop Aborts the current waveform + +wave_get_cbs Length in cbs of the current waveform +wave_get_max_cbs Absolute maximum allowed cbs + +wave_get_micros Length in microseconds of the current waveform +wave_get_max_micros Absolute maximum allowed micros + +wave_get_pulses Length in pulses of the current waveform +wave_get_max_pulses Absolute maximum allowed pulses + +UTILITIES + +get_current_tick Get current tick (microseconds) + +get_hardware_revision Get hardware revision +get_pigpio_version Get the pigpio version + +pigpio.error_text Gets error text from error number +pigpio.tickDiff Returns difference between two ticks +""" + +import sys +import socket +import struct +import time +import threading +import os +import atexit + +VERSION = "1.78" # sync minor number to pigpio library version + +exceptions = True + +# GPIO levels + +OFF = 0 +LOW = 0 +CLEAR = 0 + +ON = 1 +HIGH = 1 +SET = 1 + +TIMEOUT = 2 + +# GPIO edges + +RISING_EDGE = 0 +FALLING_EDGE = 1 +EITHER_EDGE = 2 + +# GPIO modes + +INPUT = 0 +OUTPUT = 1 +ALT0 = 4 +ALT1 = 5 +ALT2 = 6 +ALT3 = 7 +ALT4 = 3 +ALT5 = 2 + +# GPIO Pull Up Down + +PUD_OFF = 0 +PUD_DOWN = 1 +PUD_UP = 2 + +# script run status + +PI_SCRIPT_INITING=0 +PI_SCRIPT_HALTED =1 +PI_SCRIPT_RUNNING=2 +PI_SCRIPT_WAITING=3 +PI_SCRIPT_FAILED =4 + +# notification flags + +NTFY_FLAGS_EVENT = (1 << 7) +NTFY_FLAGS_ALIVE = (1 << 6) +NTFY_FLAGS_WDOG = (1 << 5) +NTFY_FLAGS_GPIO = 31 + +# wave modes + +WAVE_MODE_ONE_SHOT =0 +WAVE_MODE_REPEAT =1 +WAVE_MODE_ONE_SHOT_SYNC=2 +WAVE_MODE_REPEAT_SYNC =3 + +WAVE_NOT_FOUND = 9998 # Transmitted wave not found. +NO_TX_WAVE = 9999 # No wave being transmitted. + +FILE_READ=1 +FILE_WRITE=2 +FILE_RW=3 + +FILE_APPEND=4 +FILE_CREATE=8 +FILE_TRUNC=16 + +FROM_START=0 +FROM_CURRENT=1 +FROM_END=2 + +SPI_MODE_0 = 0 +SPI_MODE_1 = 1 +SPI_MODE_2 = 2 +SPI_MODE_3 = 3 + +SPI_CPHA = 1 << 0 +SPI_CPOL = 1 << 1 + +SPI_CS_HIGH_ACTIVE = 1 << 2 + +SPI_TX_LSBFIRST = 1 << 14 +SPI_RX_LSBFIRST = 1 << 15 + +EVENT_BSC = 31 + +_SOCK_CMD_LEN = 16 + +# pigpio command numbers + +_PI_CMD_MODES= 0 +_PI_CMD_MODEG= 1 +_PI_CMD_PUD= 2 +_PI_CMD_READ= 3 +_PI_CMD_WRITE= 4 +_PI_CMD_PWM= 5 +_PI_CMD_PRS= 6 +_PI_CMD_PFS= 7 +_PI_CMD_SERVO= 8 +_PI_CMD_WDOG= 9 +_PI_CMD_BR1= 10 +_PI_CMD_BR2= 11 +_PI_CMD_BC1= 12 +_PI_CMD_BC2= 13 +_PI_CMD_BS1= 14 +_PI_CMD_BS2= 15 +_PI_CMD_TICK= 16 +_PI_CMD_HWVER=17 + +_PI_CMD_NO= 18 +_PI_CMD_NB= 19 +_PI_CMD_NP= 20 +_PI_CMD_NC= 21 + +_PI_CMD_PRG= 22 +_PI_CMD_PFG= 23 +_PI_CMD_PRRG= 24 +_PI_CMD_HELP= 25 +_PI_CMD_PIGPV=26 + +_PI_CMD_WVCLR=27 +_PI_CMD_WVAG= 28 +_PI_CMD_WVAS= 29 +_PI_CMD_WVGO= 30 +_PI_CMD_WVGOR=31 +_PI_CMD_WVBSY=32 +_PI_CMD_WVHLT=33 +_PI_CMD_WVSM= 34 +_PI_CMD_WVSP= 35 +_PI_CMD_WVSC= 36 + +_PI_CMD_TRIG= 37 + +_PI_CMD_PROC= 38 +_PI_CMD_PROCD=39 +_PI_CMD_PROCR=40 +_PI_CMD_PROCS=41 + +_PI_CMD_SLRO= 42 +_PI_CMD_SLR= 43 +_PI_CMD_SLRC= 44 + +_PI_CMD_PROCP=45 +_PI_CMD_MICRO=46 +_PI_CMD_MILLI=47 +_PI_CMD_PARSE=48 + +_PI_CMD_WVCRE=49 +_PI_CMD_WVDEL=50 +_PI_CMD_WVTX =51 +_PI_CMD_WVTXR=52 +_PI_CMD_WVNEW=53 + +_PI_CMD_I2CO =54 +_PI_CMD_I2CC =55 +_PI_CMD_I2CRD=56 +_PI_CMD_I2CWD=57 +_PI_CMD_I2CWQ=58 +_PI_CMD_I2CRS=59 +_PI_CMD_I2CWS=60 +_PI_CMD_I2CRB=61 +_PI_CMD_I2CWB=62 +_PI_CMD_I2CRW=63 +_PI_CMD_I2CWW=64 +_PI_CMD_I2CRK=65 +_PI_CMD_I2CWK=66 +_PI_CMD_I2CRI=67 +_PI_CMD_I2CWI=68 +_PI_CMD_I2CPC=69 +_PI_CMD_I2CPK=70 + +_PI_CMD_SPIO =71 +_PI_CMD_SPIC =72 +_PI_CMD_SPIR =73 +_PI_CMD_SPIW =74 +_PI_CMD_SPIX =75 + +_PI_CMD_SERO =76 +_PI_CMD_SERC =77 +_PI_CMD_SERRB=78 +_PI_CMD_SERWB=79 +_PI_CMD_SERR =80 +_PI_CMD_SERW =81 +_PI_CMD_SERDA=82 + +_PI_CMD_GDC =83 +_PI_CMD_GPW =84 + +_PI_CMD_HC =85 +_PI_CMD_HP =86 + +_PI_CMD_CF1 =87 +_PI_CMD_CF2 =88 + +_PI_CMD_NOIB =99 + +_PI_CMD_BI2CC=89 +_PI_CMD_BI2CO=90 +_PI_CMD_BI2CZ=91 + +_PI_CMD_I2CZ =92 + +_PI_CMD_WVCHA=93 + +_PI_CMD_SLRI =94 + +_PI_CMD_CGI =95 +_PI_CMD_CSI =96 + +_PI_CMD_FG =97 +_PI_CMD_FN =98 + +_PI_CMD_WVTXM=100 +_PI_CMD_WVTAT=101 + +_PI_CMD_PADS =102 +_PI_CMD_PADG =103 + +_PI_CMD_FO =104 +_PI_CMD_FC =105 +_PI_CMD_FR =106 +_PI_CMD_FW =107 +_PI_CMD_FS =108 +_PI_CMD_FL =109 +_PI_CMD_SHELL=110 + +_PI_CMD_BSPIC=111 +_PI_CMD_BSPIO=112 +_PI_CMD_BSPIX=113 + +_PI_CMD_BSCX =114 + +_PI_CMD_EVM =115 +_PI_CMD_EVT =116 + +_PI_CMD_PROCU=117 +_PI_CMD_WVCAP=118 + +# pigpio error numbers + +_PI_INIT_FAILED =-1 +PI_BAD_USER_GPIO =-2 +PI_BAD_GPIO =-3 +PI_BAD_MODE =-4 +PI_BAD_LEVEL =-5 +PI_BAD_PUD =-6 +PI_BAD_PULSEWIDTH =-7 +PI_BAD_DUTYCYCLE =-8 +_PI_BAD_TIMER =-9 +_PI_BAD_MS =-10 +_PI_BAD_TIMETYPE =-11 +_PI_BAD_SECONDS =-12 +_PI_BAD_MICROS =-13 +_PI_TIMER_FAILED =-14 +PI_BAD_WDOG_TIMEOUT =-15 +_PI_NO_ALERT_FUNC =-16 +_PI_BAD_CLK_PERIPH =-17 +_PI_BAD_CLK_SOURCE =-18 +_PI_BAD_CLK_MICROS =-19 +_PI_BAD_BUF_MILLIS =-20 +PI_BAD_DUTYRANGE =-21 +_PI_BAD_SIGNUM =-22 +_PI_BAD_PATHNAME =-23 +PI_NO_HANDLE =-24 +PI_BAD_HANDLE =-25 +_PI_BAD_IF_FLAGS =-26 +_PI_BAD_CHANNEL =-27 +_PI_BAD_PRIM_CHANNEL=-27 +_PI_BAD_SOCKET_PORT =-28 +_PI_BAD_FIFO_COMMAND=-29 +_PI_BAD_SECO_CHANNEL=-30 +_PI_NOT_INITIALISED =-31 +_PI_INITIALISED =-32 +_PI_BAD_WAVE_MODE =-33 +_PI_BAD_CFG_INTERNAL=-34 +PI_BAD_WAVE_BAUD =-35 +PI_TOO_MANY_PULSES =-36 +PI_TOO_MANY_CHARS =-37 +PI_NOT_SERIAL_GPIO =-38 +_PI_BAD_SERIAL_STRUC=-39 +_PI_BAD_SERIAL_BUF =-40 +PI_NOT_PERMITTED =-41 +PI_SOME_PERMITTED =-42 +PI_BAD_WVSC_COMMND =-43 +PI_BAD_WVSM_COMMND =-44 +PI_BAD_WVSP_COMMND =-45 +PI_BAD_PULSELEN =-46 +PI_BAD_SCRIPT =-47 +PI_BAD_SCRIPT_ID =-48 +PI_BAD_SER_OFFSET =-49 +PI_GPIO_IN_USE =-50 +PI_BAD_SERIAL_COUNT =-51 +PI_BAD_PARAM_NUM =-52 +PI_DUP_TAG =-53 +PI_TOO_MANY_TAGS =-54 +PI_BAD_SCRIPT_CMD =-55 +PI_BAD_VAR_NUM =-56 +PI_NO_SCRIPT_ROOM =-57 +PI_NO_MEMORY =-58 +PI_SOCK_READ_FAILED =-59 +PI_SOCK_WRIT_FAILED =-60 +PI_TOO_MANY_PARAM =-61 +PI_SCRIPT_NOT_READY =-62 +PI_BAD_TAG =-63 +PI_BAD_MICS_DELAY =-64 +PI_BAD_MILS_DELAY =-65 +PI_BAD_WAVE_ID =-66 +PI_TOO_MANY_CBS =-67 +PI_TOO_MANY_OOL =-68 +PI_EMPTY_WAVEFORM =-69 +PI_NO_WAVEFORM_ID =-70 +PI_I2C_OPEN_FAILED =-71 +PI_SER_OPEN_FAILED =-72 +PI_SPI_OPEN_FAILED =-73 +PI_BAD_I2C_BUS =-74 +PI_BAD_I2C_ADDR =-75 +PI_BAD_SPI_CHANNEL =-76 +PI_BAD_FLAGS =-77 +PI_BAD_SPI_SPEED =-78 +PI_BAD_SER_DEVICE =-79 +PI_BAD_SER_SPEED =-80 +PI_BAD_PARAM =-81 +PI_I2C_WRITE_FAILED =-82 +PI_I2C_READ_FAILED =-83 +PI_BAD_SPI_COUNT =-84 +PI_SER_WRITE_FAILED =-85 +PI_SER_READ_FAILED =-86 +PI_SER_READ_NO_DATA =-87 +PI_UNKNOWN_COMMAND =-88 +PI_SPI_XFER_FAILED =-89 +_PI_BAD_POINTER =-90 +PI_NO_AUX_SPI =-91 +PI_NOT_PWM_GPIO =-92 +PI_NOT_SERVO_GPIO =-93 +PI_NOT_HCLK_GPIO =-94 +PI_NOT_HPWM_GPIO =-95 +PI_BAD_HPWM_FREQ =-96 +PI_BAD_HPWM_DUTY =-97 +PI_BAD_HCLK_FREQ =-98 +PI_BAD_HCLK_PASS =-99 +PI_HPWM_ILLEGAL =-100 +PI_BAD_DATABITS =-101 +PI_BAD_STOPBITS =-102 +PI_MSG_TOOBIG =-103 +PI_BAD_MALLOC_MODE =-104 +_PI_TOO_MANY_SEGS =-105 +_PI_BAD_I2C_SEG =-106 +PI_BAD_SMBUS_CMD =-107 +PI_NOT_I2C_GPIO =-108 +PI_BAD_I2C_WLEN =-109 +PI_BAD_I2C_RLEN =-110 +PI_BAD_I2C_CMD =-111 +PI_BAD_I2C_BAUD =-112 +PI_CHAIN_LOOP_CNT =-113 +PI_BAD_CHAIN_LOOP =-114 +PI_CHAIN_COUNTER =-115 +PI_BAD_CHAIN_CMD =-116 +PI_BAD_CHAIN_DELAY =-117 +PI_CHAIN_NESTING =-118 +PI_CHAIN_TOO_BIG =-119 +PI_DEPRECATED =-120 +PI_BAD_SER_INVERT =-121 +_PI_BAD_EDGE =-122 +_PI_BAD_ISR_INIT =-123 +PI_BAD_FOREVER =-124 +PI_BAD_FILTER =-125 +PI_BAD_PAD =-126 +PI_BAD_STRENGTH =-127 +PI_FIL_OPEN_FAILED =-128 +PI_BAD_FILE_MODE =-129 +PI_BAD_FILE_FLAG =-130 +PI_BAD_FILE_READ =-131 +PI_BAD_FILE_WRITE =-132 +PI_FILE_NOT_ROPEN =-133 +PI_FILE_NOT_WOPEN =-134 +PI_BAD_FILE_SEEK =-135 +PI_NO_FILE_MATCH =-136 +PI_NO_FILE_ACCESS =-137 +PI_FILE_IS_A_DIR =-138 +PI_BAD_SHELL_STATUS =-139 +PI_BAD_SCRIPT_NAME =-140 +PI_BAD_SPI_BAUD =-141 +PI_NOT_SPI_GPIO =-142 +PI_BAD_EVENT_ID =-143 +PI_CMD_INTERRUPTED =-144 +PI_NOT_ON_BCM2711 =-145 +PI_ONLY_ON_BCM2711 =-146 + +# pigpio error text + +_errors=[ + [_PI_INIT_FAILED , "pigpio initialisation failed"], + [PI_BAD_USER_GPIO , "GPIO not 0-31"], + [PI_BAD_GPIO , "GPIO not 0-53"], + [PI_BAD_MODE , "mode not 0-7"], + [PI_BAD_LEVEL , "level not 0-1"], + [PI_BAD_PUD , "pud not 0-2"], + [PI_BAD_PULSEWIDTH , "pulsewidth not 0 or 500-2500"], + [PI_BAD_DUTYCYCLE , "dutycycle not 0-range (default 255)"], + [_PI_BAD_TIMER , "timer not 0-9"], + [_PI_BAD_MS , "ms not 10-60000"], + [_PI_BAD_TIMETYPE , "timetype not 0-1"], + [_PI_BAD_SECONDS , "seconds < 0"], + [_PI_BAD_MICROS , "micros not 0-999999"], + [_PI_TIMER_FAILED , "gpioSetTimerFunc failed"], + [PI_BAD_WDOG_TIMEOUT , "timeout not 0-60000"], + [_PI_NO_ALERT_FUNC , "DEPRECATED"], + [_PI_BAD_CLK_PERIPH , "clock peripheral not 0-1"], + [_PI_BAD_CLK_SOURCE , "DEPRECATED"], + [_PI_BAD_CLK_MICROS , "clock micros not 1, 2, 4, 5, 8, or 10"], + [_PI_BAD_BUF_MILLIS , "buf millis not 100-10000"], + [PI_BAD_DUTYRANGE , "dutycycle range not 25-40000"], + [_PI_BAD_SIGNUM , "signum not 0-63"], + [_PI_BAD_PATHNAME , "can't open pathname"], + [PI_NO_HANDLE , "no handle available"], + [PI_BAD_HANDLE , "unknown handle"], + [_PI_BAD_IF_FLAGS , "ifFlags > 4"], + [_PI_BAD_CHANNEL , "DMA channel not 0-14"], + [_PI_BAD_SOCKET_PORT , "socket port not 1024-30000"], + [_PI_BAD_FIFO_COMMAND , "unknown fifo command"], + [_PI_BAD_SECO_CHANNEL , "DMA secondary channel not 0-14"], + [_PI_NOT_INITIALISED , "function called before gpioInitialise"], + [_PI_INITIALISED , "function called after gpioInitialise"], + [_PI_BAD_WAVE_MODE , "waveform mode not 0-1"], + [_PI_BAD_CFG_INTERNAL , "bad parameter in gpioCfgInternals call"], + [PI_BAD_WAVE_BAUD , "baud rate not 50-250000(RX)/1000000(TX)"], + [PI_TOO_MANY_PULSES , "waveform has too many pulses"], + [PI_TOO_MANY_CHARS , "waveform has too many chars"], + [PI_NOT_SERIAL_GPIO , "no bit bang serial read in progress on GPIO"], + [PI_NOT_PERMITTED , "no permission to update GPIO"], + [PI_SOME_PERMITTED , "no permission to update one or more GPIO"], + [PI_BAD_WVSC_COMMND , "bad WVSC subcommand"], + [PI_BAD_WVSM_COMMND , "bad WVSM subcommand"], + [PI_BAD_WVSP_COMMND , "bad WVSP subcommand"], + [PI_BAD_PULSELEN , "trigger pulse length not 1-100"], + [PI_BAD_SCRIPT , "invalid script"], + [PI_BAD_SCRIPT_ID , "unknown script id"], + [PI_BAD_SER_OFFSET , "add serial data offset > 30 minute"], + [PI_GPIO_IN_USE , "GPIO already in use"], + [PI_BAD_SERIAL_COUNT , "must read at least a byte at a time"], + [PI_BAD_PARAM_NUM , "script parameter id not 0-9"], + [PI_DUP_TAG , "script has duplicate tag"], + [PI_TOO_MANY_TAGS , "script has too many tags"], + [PI_BAD_SCRIPT_CMD , "illegal script command"], + [PI_BAD_VAR_NUM , "script variable id not 0-149"], + [PI_NO_SCRIPT_ROOM , "no more room for scripts"], + [PI_NO_MEMORY , "can't allocate temporary memory"], + [PI_SOCK_READ_FAILED , "socket read failed"], + [PI_SOCK_WRIT_FAILED , "socket write failed"], + [PI_TOO_MANY_PARAM , "too many script parameters (> 10)"], + [PI_SCRIPT_NOT_READY , "script initialising"], + [PI_BAD_TAG , "script has unresolved tag"], + [PI_BAD_MICS_DELAY , "bad MICS delay (too large)"], + [PI_BAD_MILS_DELAY , "bad MILS delay (too large)"], + [PI_BAD_WAVE_ID , "non existent wave id"], + [PI_TOO_MANY_CBS , "No more CBs for waveform"], + [PI_TOO_MANY_OOL , "No more OOL for waveform"], + [PI_EMPTY_WAVEFORM , "attempt to create an empty waveform"], + [PI_NO_WAVEFORM_ID , "No more waveform ids"], + [PI_I2C_OPEN_FAILED , "can't open I2C device"], + [PI_SER_OPEN_FAILED , "can't open serial device"], + [PI_SPI_OPEN_FAILED , "can't open SPI device"], + [PI_BAD_I2C_BUS , "bad I2C bus"], + [PI_BAD_I2C_ADDR , "bad I2C address"], + [PI_BAD_SPI_CHANNEL , "bad SPI channel"], + [PI_BAD_FLAGS , "bad i2c/spi/ser open flags"], + [PI_BAD_SPI_SPEED , "bad SPI speed"], + [PI_BAD_SER_DEVICE , "bad serial device name"], + [PI_BAD_SER_SPEED , "bad serial baud rate"], + [PI_BAD_PARAM , "bad i2c/spi/ser parameter"], + [PI_I2C_WRITE_FAILED , "I2C write failed"], + [PI_I2C_READ_FAILED , "I2C read failed"], + [PI_BAD_SPI_COUNT , "bad SPI count"], + [PI_SER_WRITE_FAILED , "ser write failed"], + [PI_SER_READ_FAILED , "ser read failed"], + [PI_SER_READ_NO_DATA , "ser read no data available"], + [PI_UNKNOWN_COMMAND , "unknown command"], + [PI_SPI_XFER_FAILED , "SPI xfer/read/write failed"], + [_PI_BAD_POINTER , "bad (NULL) pointer"], + [PI_NO_AUX_SPI , "no auxiliary SPI on Pi A or B"], + [PI_NOT_PWM_GPIO , "GPIO is not in use for PWM"], + [PI_NOT_SERVO_GPIO , "GPIO is not in use for servo pulses"], + [PI_NOT_HCLK_GPIO , "GPIO has no hardware clock"], + [PI_NOT_HPWM_GPIO , "GPIO has no hardware PWM"], + [PI_BAD_HPWM_FREQ , "invalid hardware PWM frequency"], + [PI_BAD_HPWM_DUTY , "hardware PWM dutycycle not 0-1M"], + [PI_BAD_HCLK_FREQ , "invalid hardware clock frequency"], + [PI_BAD_HCLK_PASS , "need password to use hardware clock 1"], + [PI_HPWM_ILLEGAL , "illegal, PWM in use for main clock"], + [PI_BAD_DATABITS , "serial data bits not 1-32"], + [PI_BAD_STOPBITS , "serial (half) stop bits not 2-8"], + [PI_MSG_TOOBIG , "socket/pipe message too big"], + [PI_BAD_MALLOC_MODE , "bad memory allocation mode"], + [_PI_TOO_MANY_SEGS , "too many I2C transaction segments"], + [_PI_BAD_I2C_SEG , "an I2C transaction segment failed"], + [PI_BAD_SMBUS_CMD , "SMBus command not supported"], + [PI_NOT_I2C_GPIO , "no bit bang I2C in progress on GPIO"], + [PI_BAD_I2C_WLEN , "bad I2C write length"], + [PI_BAD_I2C_RLEN , "bad I2C read length"], + [PI_BAD_I2C_CMD , "bad I2C command"], + [PI_BAD_I2C_BAUD , "bad I2C baud rate, not 50-500k"], + [PI_CHAIN_LOOP_CNT , "bad chain loop count"], + [PI_BAD_CHAIN_LOOP , "empty chain loop"], + [PI_CHAIN_COUNTER , "too many chain counters"], + [PI_BAD_CHAIN_CMD , "bad chain command"], + [PI_BAD_CHAIN_DELAY , "bad chain delay micros"], + [PI_CHAIN_NESTING , "chain counters nested too deeply"], + [PI_CHAIN_TOO_BIG , "chain is too long"], + [PI_DEPRECATED , "deprecated function removed"], + [PI_BAD_SER_INVERT , "bit bang serial invert not 0 or 1"], + [_PI_BAD_EDGE , "bad ISR edge value, not 0-2"], + [_PI_BAD_ISR_INIT , "bad ISR initialisation"], + [PI_BAD_FOREVER , "loop forever must be last chain command"], + [PI_BAD_FILTER , "bad filter parameter"], + [PI_BAD_PAD , "bad pad number"], + [PI_BAD_STRENGTH , "bad pad drive strength"], + [PI_FIL_OPEN_FAILED , "file open failed"], + [PI_BAD_FILE_MODE , "bad file mode"], + [PI_BAD_FILE_FLAG , "bad file flag"], + [PI_BAD_FILE_READ , "bad file read"], + [PI_BAD_FILE_WRITE , "bad file write"], + [PI_FILE_NOT_ROPEN , "file not open for read"], + [PI_FILE_NOT_WOPEN , "file not open for write"], + [PI_BAD_FILE_SEEK , "bad file seek"], + [PI_NO_FILE_MATCH , "no files match pattern"], + [PI_NO_FILE_ACCESS , "no permission to access file"], + [PI_FILE_IS_A_DIR , "file is a directory"], + [PI_BAD_SHELL_STATUS , "bad shell return status"], + [PI_BAD_SCRIPT_NAME , "bad script name"], + [PI_BAD_SPI_BAUD , "bad SPI baud rate, not 50-500k"], + [PI_NOT_SPI_GPIO , "no bit bang SPI in progress on GPIO"], + [PI_BAD_EVENT_ID , "bad event id"], + [PI_CMD_INTERRUPTED , "pigpio command interrupted"], + [PI_NOT_ON_BCM2711 , "not available on BCM2711"], + [PI_ONLY_ON_BCM2711 , "only available on BCM2711"], +] + +_except_a = "%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%\n{}" + +_except_z = "%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%" + +_except_1 = """ +Did you start the pigpio daemon? E.g. sudo pigpiod + +Did you specify the correct Pi host/port in the environment +variables PIGPIO_ADDR/PIGPIO_PORT? +E.g. export PIGPIO_ADDR=soft, export PIGPIO_PORT=8888 + +Did you specify the correct Pi host/port in the +pigpio.pi() function? E.g. pigpio.pi('soft', 8888)""" + +_except_2 = """ +Do you have permission to access the pigpio daemon? +Perhaps it was started with sudo pigpiod -nlocalhost""" + +_except_3 = """ +Can't create callback thread. +Perhaps too many simultaneous pigpio connections.""" + +class _socklock: + """ + A class to store socket and lock. + """ + def __init__(self): + self.s = None + self.l = threading.Lock() + +class error(Exception): + """pigpio module exception""" + def __init__(self, value): + self.value = value + def __str__(self): + return repr(self.value) + +class pulse: + """ + A class to store pulse information. + """ + + def __init__(self, gpio_on, gpio_off, delay): + """ + Initialises a pulse. + + gpio_on:= the GPIO to switch on at the start of the pulse. + gpio_off:= the GPIO to switch off at the start of the pulse. + delay:= the delay in microseconds before the next pulse. + + """ + self.gpio_on = gpio_on + self.gpio_off = gpio_off + self.delay = delay + +def error_text(errnum): + """ + Returns a text description of a pigpio error. + + errnum:= <0, the error number + + ... + print(pigpio.error_text(-5)) + level not 0-1 + ... + """ + for e in _errors: + if e[0] == errnum: + return e[1] + return "unknown error ({})".format(errnum) + +def tickDiff(t1, t2): + """ + Returns the microsecond difference between two ticks. + + t1:= the earlier tick + t2:= the later tick + + ... + print(pigpio.tickDiff(4294967272, 12)) + 36 + ... + """ + tDiff = t2 - t1 + if tDiff < 0: + tDiff += (1 << 32) + return tDiff + +# A couple of hacks to cope with different string handling +# between various Python versions +# 3 != 2.7.8 != 2.7.3 + +if sys.hexversion < 0x03000000: + def _b(x): + return x +else: + def _b(x): + return x.encode('latin-1') + +if sys.hexversion < 0x02070800: + def _str(x): + return buffer(x) +else: + def _str(x): + return x + +def u2i(uint32): + """ + Converts a 32 bit unsigned number to signed. + + uint32:= an unsigned 32 bit number + + ... + print(u2i(4294967272)) + -24 + print(u2i(37)) + 37 + ... + """ + mask = (2 ** 32) - 1 + if uint32 & (1 << 31): + v = uint32 | ~mask + else: + v = uint32 & mask + return v + +def _u2i(uint32): + """ + Converts a 32 bit unsigned number to signed. If the number + is negative it indicates an error. On error a pigpio + exception will be raised if exceptions is True. + """ + v = u2i(uint32) + if v < 0: + if exceptions: + raise error(error_text(v)) + return v + +def _pigpio_command(sl, cmd, p1, p2): + """ + Runs a pigpio socket command. + + sl:= command socket and lock. + cmd:= the command to be executed. + p1:= command parameter 1 (if applicable). + p2:= command parameter 2 (if applicable). + """ + res = PI_CMD_INTERRUPTED + with sl.l: + sl.s.send(struct.pack('IIII', cmd, p1, p2, 0)) + dummy, res = struct.unpack('12sI', sl.s.recv(_SOCK_CMD_LEN)) + return res + +def _pigpio_command_nolock(sl, cmd, p1, p2): + """ + Runs a pigpio socket command. + + sl:= command socket and lock. + cmd:= the command to be executed. + p1:= command parameter 1 (if applicable). + p2:= command parameter 2 (if applicable). + """ + res = PI_CMD_INTERRUPTED + sl.s.send(struct.pack('IIII', cmd, p1, p2, 0)) + dummy, res = struct.unpack('12sI', sl.s.recv(_SOCK_CMD_LEN)) + return res + +def _pigpio_command_ext(sl, cmd, p1, p2, p3, extents): + """ + Runs an extended pigpio socket command. + + sl:= command socket and lock. + cmd:= the command to be executed. + p1:= command parameter 1 (if applicable). + p2:= command parameter 2 (if applicable). + p3:= total size in bytes of following extents + extents:= additional data blocks + """ + ext = bytearray(struct.pack('IIII', cmd, p1, p2, p3)) + for x in extents: + if type(x) == type(""): + ext.extend(_b(x)) + else: + ext.extend(x) + res = PI_CMD_INTERRUPTED + with sl.l: + sl.s.sendall(ext) + dummy, res = struct.unpack('12sI', sl.s.recv(_SOCK_CMD_LEN)) + return res + +def _pigpio_command_ext_nolock(sl, cmd, p1, p2, p3, extents): + """ + Runs an extended pigpio socket command. + + sl:= command socket and lock. + cmd:= the command to be executed. + p1:= command parameter 1 (if applicable). + p2:= command parameter 2 (if applicable). + p3:= total size in bytes of following extents + extents:= additional data blocks + """ + res = PI_CMD_INTERRUPTED + ext = bytearray(struct.pack('IIII', cmd, p1, p2, p3)) + for x in extents: + if type(x) == type(""): + ext.extend(_b(x)) + else: + ext.extend(x) + sl.s.sendall(ext) + dummy, res = struct.unpack('12sI', sl.s.recv(_SOCK_CMD_LEN)) + return res + +class _event_ADT: + """ + An ADT class to hold event callback information. + """ + + def __init__(self, event, func): + """ + Initialises an event callback ADT. + + event:= the event id. + func:= a user function taking one argument, the event id. + """ + self.event = event + self.func = func + self.bit = 1<= MSG_SIZ: + msgbuf = buf[offset:offset + MSG_SIZ] + offset += MSG_SIZ + seq, flags, tick, level = (struct.unpack('HHII', msgbuf)) + + if flags == 0: + changed = level ^ lastLevel + lastLevel = level + for cb in self.callbacks: + if cb.bit & changed: + newLevel = 0 + if cb.bit & level: + newLevel = 1 + if (cb.edge ^ newLevel): + cb.func(cb.gpio, newLevel, tick) + else: + if flags & NTFY_FLAGS_WDOG: + gpio = flags & NTFY_FLAGS_GPIO + for cb in self.callbacks: + if cb.gpio == gpio: + cb.func(gpio, TIMEOUT, tick) + elif flags & NTFY_FLAGS_EVENT: + event = flags & NTFY_FLAGS_GPIO + for cb in self.events: + if cb.event == event: + cb.func(event, tick) + buf = buf[offset:] + + self.sl.s.close() + +class _callback: + """A class to provide GPIO level change callbacks.""" + + def __init__(self, notify, user_gpio, edge=RISING_EDGE, func=None): + """ + Initialise a callback and adds it to the notification thread. + """ + self._notify = notify + self.count=0 + self._reset = False + if func is None: + func=self._tally + self.callb = _callback_ADT(user_gpio, edge, func) + self._notify.append(self.callb) + + def cancel(self): + """Cancels a callback by removing it from the notification thread.""" + self._notify.remove(self.callb) + + def _tally(self, user_gpio, level, tick): + """Increment the callback called count.""" + if self._reset: + self._reset = False + self.count = 0 + self.count += 1 + + def tally(self): + """ + Provides a count of how many times the default tally + callback has triggered. + + The count will be zero if the user has supplied their own + callback function. + """ + return self.count + + def reset_tally(self): + """ + Resets the tally count to zero. + """ + self._reset = True + self.count = 0 + +class _event: + """A class to provide event callbacks.""" + + def __init__(self, notify, event, func=None): + """ + Initialise an event and adds it to the notification thread. + """ + self._notify = notify + self.count=0 + self._reset = False + if func is None: + func=self._tally + self.callb = _event_ADT(event, func) + self._notify.append_event(self.callb) + + def cancel(self): + """ + Cancels a event callback by removing it from the + notification thread. + """ + self._notify.remove_event(self.callb) + + def _tally(self, event, tick): + """Increment the event callback called count.""" + if self._reset: + self._reset = False + self.count = 0 + self.count += 1 + + def tally(self): + """ + Provides a count of how many times the default tally + callback has triggered. + + The count will be zero if the user has supplied their own + callback function. + """ + return self.count + + def reset_tally(self): + """ + Resets the tally count to zero. + """ + self._reset = True + self.count = 0 + +class _wait_for_edge: + """Encapsulates waiting for GPIO edges.""" + + def __init__(self, notify, gpio, edge, timeout): + """Initialises a wait_for_edge.""" + self._notify = notify + self.callb = _callback_ADT(gpio, edge, self.func) + self.trigger = False + self._notify.append(self.callb) + self.start = time.time() + while (self.trigger == False) and ((time.time()-self.start) < timeout): + time.sleep(0.05) + self._notify.remove(self.callb) + + def func(self, gpio, level, tick): + """Sets wait_for_edge triggered.""" + self.trigger = True + +class _wait_for_event: + """Encapsulates waiting for an event.""" + + def __init__(self, notify, event, timeout): + """Initialises wait_for_event.""" + self._notify = notify + self.callb = _event_ADT(event, self.func) + self.trigger = False + self._notify.append_event(self.callb) + self.start = time.time() + while (self.trigger == False) and ((time.time()-self.start) < timeout): + time.sleep(0.05) + self._notify.remove_event(self.callb) + + def func(self, event, tick): + """Sets wait_for_event triggered.""" + self.trigger = True + +class pi(): + + def _rxbuf(self, count): + """Returns count bytes from the command socket.""" + ext = bytearray(self.sl.s.recv(count)) + while len(ext) < count: + ext.extend(self.sl.s.recv(count - len(ext))) + return ext + + def set_mode(self, gpio, mode): + """ + Sets the GPIO mode. + + gpio:= 0-53. + mode:= INPUT, OUTPUT, ALT0, ALT1, ALT2, ALT3, ALT4, ALT5. + + ... + pi.set_mode( 4, pigpio.INPUT) # GPIO 4 as input + pi.set_mode(17, pigpio.OUTPUT) # GPIO 17 as output + pi.set_mode(24, pigpio.ALT2) # GPIO 24 as ALT2 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_MODES, gpio, mode)) + + def get_mode(self, gpio): + """ + Returns the GPIO mode. + + gpio:= 0-53. + + Returns a value as follows + + . . + 0 = INPUT + 1 = OUTPUT + 2 = ALT5 + 3 = ALT4 + 4 = ALT0 + 5 = ALT1 + 6 = ALT2 + 7 = ALT3 + . . + + ... + print(pi.get_mode(0)) + 4 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_MODEG, gpio, 0)) + + def set_pull_up_down(self, gpio, pud): + """ + Sets or clears the internal GPIO pull-up/down resistor. + + gpio:= 0-53. + pud:= PUD_UP, PUD_DOWN, PUD_OFF. + + ... + pi.set_pull_up_down(17, pigpio.PUD_OFF) + pi.set_pull_up_down(23, pigpio.PUD_UP) + pi.set_pull_up_down(24, pigpio.PUD_DOWN) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PUD, gpio, pud)) + + def read(self, gpio): + """ + Returns the GPIO level. + + gpio:= 0-53. + + ... + pi.set_mode(23, pigpio.INPUT) + + pi.set_pull_up_down(23, pigpio.PUD_DOWN) + print(pi.read(23)) + 0 + + pi.set_pull_up_down(23, pigpio.PUD_UP) + print(pi.read(23)) + 1 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_READ, gpio, 0)) + + def write(self, gpio, level): + """ + Sets the GPIO level. + + GPIO:= 0-53. + level:= 0, 1. + + If PWM or servo pulses are active on the GPIO they are + switched off. + + ... + pi.set_mode(17, pigpio.OUTPUT) + + pi.write(17,0) + print(pi.read(17)) + 0 + + pi.write(17,1) + print(pi.read(17)) + 1 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WRITE, gpio, level)) + + def set_PWM_dutycycle(self, user_gpio, dutycycle): + """ + Starts (non-zero dutycycle) or stops (0) PWM pulses on the GPIO. + + user_gpio:= 0-31. + dutycycle:= 0-range (range defaults to 255). + + The [*set_PWM_range*] function can change the default range of 255. + + ... + pi.set_PWM_dutycycle(4, 0) # PWM off + pi.set_PWM_dutycycle(4, 64) # PWM 1/4 on + pi.set_PWM_dutycycle(4, 128) # PWM 1/2 on + pi.set_PWM_dutycycle(4, 192) # PWM 3/4 on + pi.set_PWM_dutycycle(4, 255) # PWM full on + ... + """ + return _u2i(_pigpio_command( + self.sl, _PI_CMD_PWM, user_gpio, int(dutycycle))) + + def get_PWM_dutycycle(self, user_gpio): + """ + Returns the PWM dutycycle being used on the GPIO. + + user_gpio:= 0-31. + + Returns the PWM dutycycle. + + + For normal PWM the dutycycle will be out of the defined range + for the GPIO (see [*get_PWM_range*]). + + If a hardware clock is active on the GPIO the reported + dutycycle will be 500000 (500k) out of 1000000 (1M). + + If hardware PWM is active on the GPIO the reported dutycycle + will be out of a 1000000 (1M). + + ... + pi.set_PWM_dutycycle(4, 25) + print(pi.get_PWM_dutycycle(4)) + 25 + + pi.set_PWM_dutycycle(4, 203) + print(pi.get_PWM_dutycycle(4)) + 203 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_GDC, user_gpio, 0)) + + def set_PWM_range(self, user_gpio, range_): + """ + Sets the range of PWM values to be used on the GPIO. + + user_gpio:= 0-31. + range_:= 25-40000. + + ... + pi.set_PWM_range(9, 100) # now 25 1/4, 50 1/2, 75 3/4 on + pi.set_PWM_range(9, 500) # now 125 1/4, 250 1/2, 375 3/4 on + pi.set_PWM_range(9, 3000) # now 750 1/4, 1500 1/2, 2250 3/4 on + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PRS, user_gpio, range_)) + + def get_PWM_range(self, user_gpio): + """ + Returns the range of PWM values being used on the GPIO. + + user_gpio:= 0-31. + + If a hardware clock or hardware PWM is active on the GPIO + the reported range will be 1000000 (1M). + + ... + pi.set_PWM_range(9, 500) + print(pi.get_PWM_range(9)) + 500 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PRG, user_gpio, 0)) + + def get_PWM_real_range(self, user_gpio): + """ + Returns the real (underlying) range of PWM values being + used on the GPIO. + + user_gpio:= 0-31. + + If a hardware clock is active on the GPIO the reported + real range will be 1000000 (1M). + + If hardware PWM is active on the GPIO the reported real range + will be approximately 250M divided by the set PWM frequency. + + ... + pi.set_PWM_frequency(4, 800) + print(pi.get_PWM_real_range(4)) + 250 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PRRG, user_gpio, 0)) + + def set_PWM_frequency(self, user_gpio, frequency): + """ + Sets the frequency (in Hz) of the PWM to be used on the GPIO. + + user_gpio:= 0-31. + frequency:= >=0 Hz + + Returns the numerically closest frequency if OK, otherwise + PI_BAD_USER_GPIO or PI_NOT_PERMITTED. + + If PWM is currently active on the GPIO it will be switched + off and then back on at the new frequency. + + Each GPIO can be independently set to one of 18 different + PWM frequencies. + + The selectable frequencies depend upon the sample rate which + may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The + sample rate is set when the pigpio daemon is started. + + The frequencies for each sample rate are: + + . . + Hertz + + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 + 1250 1000 800 500 400 250 200 100 50 + + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 + 625 500 400 250 200 125 100 50 25 + + 4: 10000 5000 2500 2000 1250 1000 625 500 400 + 313 250 200 125 100 63 50 25 13 + sample + rate + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 + 250 200 160 100 80 50 40 20 10 + + 8: 5000 2500 1250 1000 625 500 313 250 200 + 156 125 100 63 50 31 25 13 6 + + 10: 4000 2000 1000 800 500 400 250 200 160 + 125 100 80 50 40 25 20 10 5 + . . + + ... + pi.set_PWM_frequency(4,0) + print(pi.get_PWM_frequency(4)) + 10 + + pi.set_PWM_frequency(4,100000) + print(pi.get_PWM_frequency(4)) + 8000 + ... + """ + return _u2i( + _pigpio_command(self.sl, _PI_CMD_PFS, user_gpio, frequency)) + + def get_PWM_frequency(self, user_gpio): + """ + Returns the frequency of PWM being used on the GPIO. + + user_gpio:= 0-31. + + Returns the frequency (in Hz) used for the GPIO. + + For normal PWM the frequency will be that defined for the GPIO + by [*set_PWM_frequency*]. + + If a hardware clock is active on the GPIO the reported frequency + will be that set by [*hardware_clock*]. + + If hardware PWM is active on the GPIO the reported frequency + will be that set by [*hardware_PWM*]. + + ... + pi.set_PWM_frequency(4,0) + print(pi.get_PWM_frequency(4)) + 10 + + pi.set_PWM_frequency(4, 800) + print(pi.get_PWM_frequency(4)) + 800 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PFG, user_gpio, 0)) + + def set_servo_pulsewidth(self, user_gpio, pulsewidth): + """ + Starts (500-2500) or stops (0) servo pulses on the GPIO. + + user_gpio:= 0-31. + pulsewidth:= 0 (off), + 500 (most anti-clockwise) - 2500 (most clockwise). + + The selected pulsewidth will continue to be transmitted until + changed by a subsequent call to set_servo_pulsewidth. + + The pulsewidths supported by servos varies and should probably + be determined by experiment. A value of 1500 should always be + safe and represents the mid-point of rotation. + + You can DAMAGE a servo if you command it to move beyond its + limits. + + ... + pi.set_servo_pulsewidth(17, 0) # off + pi.set_servo_pulsewidth(17, 1000) # safe anti-clockwise + pi.set_servo_pulsewidth(17, 1500) # centre + pi.set_servo_pulsewidth(17, 2000) # safe clockwise + ... + """ + return _u2i(_pigpio_command( + self.sl, _PI_CMD_SERVO, user_gpio, int(pulsewidth))) + + def get_servo_pulsewidth(self, user_gpio): + """ + Returns the servo pulsewidth being used on the GPIO. + + user_gpio:= 0-31. + + Returns the servo pulsewidth. + + ... + pi.set_servo_pulsewidth(4, 525) + print(pi.get_servo_pulsewidth(4)) + 525 + + pi.set_servo_pulsewidth(4, 2130) + print(pi.get_servo_pulsewidth(4)) + 2130 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_GPW, user_gpio, 0)) + + def notify_open(self): + """ + Returns a notification handle (>=0). + + A notification is a method for being notified of GPIO state + changes via a pipe. + + Pipes are only accessible from the local machine so this + function serves no purpose if you are using Python from a + remote machine. The in-built (socket) notifications + provided by [*callback*] should be used instead. + + Notifications for handle x will be available at the pipe + named /dev/pigpiox (where x is the handle number). + + E.g. if the function returns 15 then the notifications must be + read from /dev/pigpio15. + + Notifications have the following structure: + + . . + H seqno + H flags + I tick + I level + . . + + seqno: starts at 0 each time the handle is opened and then + increments by one for each report. + + flags: three flags are defined, PI_NTFY_FLAGS_WDOG, + PI_NTFY_FLAGS_ALIVE, and PI_NTFY_FLAGS_EVENT. + + If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the + flags indicate a GPIO which has had a watchdog timeout. + + If bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep + alive signal on the pipe/socket and is sent once a minute + in the absence of other notification activity. + + If bit 7 is set (PI_NTFY_FLAGS_EVENT) then bits 0-4 of the + flags indicate an event which has been triggered. + + + tick: the number of microseconds since system boot. It wraps + around after 1h12m. + + level: indicates the level of each GPIO. If bit 1<= 0: + pi.notify_begin(h, 1234) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_NO, 0, 0)) + + def notify_begin(self, handle, bits): + """ + Starts notifications on a handle. + + handle:= >=0 (as returned by a prior call to [*notify_open*]) + bits:= a 32 bit mask indicating the GPIO to be notified. + + The notification sends state changes for each GPIO whose + corresponding bit in bits is set. + + The following code starts notifications for GPIO 1, 4, + 6, 7, and 10 (1234 = 0x04D2 = 0b0000010011010010). + + ... + h = pi.notify_open() + if h >= 0: + pi.notify_begin(h, 1234) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_NB, handle, bits)) + + def notify_pause(self, handle): + """ + Pauses notifications on a handle. + + handle:= >=0 (as returned by a prior call to [*notify_open*]) + + Notifications for the handle are suspended until + [*notify_begin*] is called again. + + ... + h = pi.notify_open() + if h >= 0: + pi.notify_begin(h, 1234) + ... + pi.notify_pause(h) + ... + pi.notify_begin(h, 1234) + ... + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_NB, handle, 0)) + + def notify_close(self, handle): + """ + Stops notifications on a handle and releases the handle for reuse. + + handle:= >=0 (as returned by a prior call to [*notify_open*]) + + ... + h = pi.notify_open() + if h >= 0: + pi.notify_begin(h, 1234) + ... + pi.notify_close(h) + ... + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_NC, handle, 0)) + + def set_watchdog(self, user_gpio, wdog_timeout): + """ + Sets a watchdog timeout for a GPIO. + + user_gpio:= 0-31. + wdog_timeout:= 0-60000. + + The watchdog is nominally in milliseconds. + + Only one watchdog may be registered per GPIO. + + The watchdog may be cancelled by setting timeout to 0. + + Once a watchdog has been started callbacks for the GPIO + will be triggered every timeout interval after the last + GPIO activity. + + The callback will receive the special level TIMEOUT. + + ... + pi.set_watchdog(23, 1000) # 1000 ms watchdog on GPIO 23 + pi.set_watchdog(23, 0) # cancel watchdog on GPIO 23 + ... + """ + return _u2i(_pigpio_command( + self.sl, _PI_CMD_WDOG, user_gpio, int(wdog_timeout))) + + def read_bank_1(self): + """ + Returns the levels of the bank 1 GPIO (GPIO 0-31). + + The returned 32 bit integer has a bit set if the corresponding + GPIO is high. GPIO n has bit value (1<=0) if OK, otherwise PI_EMPTY_WAVEFORM, + PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + + The data provided by the [*wave_add_**] functions is consumed by + this function. + + As many waveforms may be created as there is space available. + The wave id is passed to [*wave_send_**] to specify the waveform + to transmit. + + Normal usage would be + + Step 1. [*wave_clear*] to clear all waveforms and added data. + + Step 2. [*wave_add_**] calls to supply the waveform data. + + Step 3. [*wave_create*] to create the waveform and get a unique id + + Repeat steps 2 and 3 as needed. + + Step 4. [*wave_send_**] with the id of the waveform to transmit. + + A waveform comprises one or more pulses. + + A pulse specifies + + 1) the GPIO to be switched on at the start of the pulse. + 2) the GPIO to be switched off at the start of the pulse. + 3) the delay in microseconds before the next pulse. + + Any or all the fields can be zero. It doesn't make any sense + to set all the fields to zero (the pulse will be ignored). + + When a waveform is started each pulse is executed in order with + the specified delay between the pulse and the next. + + ... + wid = pi.wave_create() + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVCRE, 0, 0)) + + def wave_create_and_pad(self, percent): + """ + This function creates a waveform like [*wave_create*] but pads the consumed + resources. Where percent gives the percentage of the resources to use + (in terms of the theoretical maximum, not the current amount free). + This allows the reuse of deleted waves while a transmission is active. + + Upon success a wave id greater than or equal to 0 is returned, otherwise + PI_EMPTY_WAVEFORM, PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + + . . + percent: 0-100, size of waveform as percentage of maximum available. + . . + + The data provided by the [*wave_add_**] functions are consumed by this + function. + + As many waveforms may be created as there is space available. The + wave id is passed to [*wave_send_**] to specify the waveform to transmit. + + A usage would be the creation of two waves where one is filled while the + other is being transmitted. Each wave is assigned 50% of the resources. + This buffer structure allows the transmission of infinite wave sequences. + + Normal usage: + + Step 1. [*wave_clear*] to clear all waveforms and added data. + + Step 2. [*wave_add_**] calls to supply the waveform data. + + Step 3. [*wave_create_and_pad*] to create a waveform of uniform size. + + Step 4. [*wave_send_**] with the id of the waveform to transmit. + + Repeat steps 2-4 as needed. + + Step 5. Any wave id can now be deleted and another wave of the same size + can be created in its place. + + ... + wid = pi.wave_create_and_pad(50) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVCAP, percent, 0)) + + def wave_delete(self, wave_id): + """ + This function deletes the waveform with id wave_id. + + wave_id:= >=0 (as returned by a prior call to [*wave_create*]). + + Wave ids are allocated in order, 0, 1, 2, etc. + + The wave is flagged for deletion. The resources used by the wave + will only be reused when either of the following apply. + + - all waves with higher numbered wave ids have been deleted or have + been flagged for deletion. + + - a new wave is created which uses exactly the same resources as + the current wave (see the C source for gpioWaveCreate for details). + + ... + pi.wave_delete(6) # delete waveform with id 6 + + pi.wave_delete(0) # delete waveform with id 0 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVDEL, wave_id, 0)) + + def wave_tx_start(self): # DEPRECATED + """ + This function is deprecated and has been removed. + + Use [*wave_create*]/[*wave_send_**] instead. + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVGO, 0, 0)) + + def wave_tx_repeat(self): # DEPRECATED + """ + This function is deprecated and has beeen removed. + + Use [*wave_create*]/[*wave_send_**] instead. + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVGOR, 0, 0)) + + def wave_send_once(self, wave_id): + """ + Transmits the waveform with id wave_id. The waveform is sent + once. + + NOTE: Any hardware PWM started by [*hardware_PWM*] will + be cancelled. + + wave_id:= >=0 (as returned by a prior call to [*wave_create*]). + + Returns the number of DMA control blocks used in the waveform. + + ... + cbs = pi.wave_send_once(wid) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVTX, wave_id, 0)) + + def wave_send_repeat(self, wave_id): + """ + Transmits the waveform with id wave_id. The waveform repeats + until wave_tx_stop is called or another call to [*wave_send_**] + is made. + + NOTE: Any hardware PWM started by [*hardware_PWM*] will + be cancelled. + + wave_id:= >=0 (as returned by a prior call to [*wave_create*]). + + Returns the number of DMA control blocks used in the waveform. + + ... + cbs = pi.wave_send_repeat(wid) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVTXR, wave_id, 0)) + + def wave_send_using_mode(self, wave_id, mode): + """ + Transmits the waveform with id wave_id using mode mode. + + wave_id:= >=0 (as returned by a prior call to [*wave_create*]). + mode:= WAVE_MODE_ONE_SHOT, WAVE_MODE_REPEAT, + WAVE_MODE_ONE_SHOT_SYNC, or WAVE_MODE_REPEAT_SYNC. + + WAVE_MODE_ONE_SHOT: same as [*wave_send_once*]. + + WAVE_MODE_REPEAT same as [*wave_send_repeat*]. + + WAVE_MODE_ONE_SHOT_SYNC same as [*wave_send_once*] but tries + to sync with the previous waveform. + + WAVE_MODE_REPEAT_SYNC same as [*wave_send_repeat*] but tries + to sync with the previous waveform. + + WARNING: bad things may happen if you delete the previous + waveform before it has been synced to the new waveform. + + NOTE: Any hardware PWM started by [*hardware_PWM*] will + be cancelled. + + wave_id:= >=0 (as returned by a prior call to [*wave_create*]). + + Returns the number of DMA control blocks used in the waveform. + + ... + cbs = pi.wave_send_using_mode(wid, WAVE_MODE_REPEAT_SYNC) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVTXM, wave_id, mode)) + + def wave_tx_at(self): + """ + Returns the id of the waveform currently being + transmitted using [*wave_send**]. Chained waves are not supported. + + Returns the waveform id or one of the following special + values: + + WAVE_NOT_FOUND (9998) - transmitted wave not found. + NO_TX_WAVE (9999) - no wave being transmitted. + + ... + wid = pi.wave_tx_at() + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVTAT, 0, 0)) + + def wave_tx_busy(self): + """ + Returns 1 if a waveform is currently being transmitted, + otherwise 0. + + ... + pi.wave_send_once(0) # send first waveform + + while pi.wave_tx_busy(): # wait for waveform to be sent + time.sleep(0.1) + + pi.wave_send_once(1) # send next waveform + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVBSY, 0, 0)) + + def wave_tx_stop(self): + """ + Stops the transmission of the current waveform. + + This function is intended to stop a waveform started with + wave_send_repeat. + + ... + pi.wave_send_repeat(3) + + time.sleep(5) + + pi.wave_tx_stop() + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_WVHLT, 0, 0)) + + def wave_chain(self, data): + """ + This function transmits a chain of waveforms. + + NOTE: Any hardware PWM started by [*hardware_PWM*] + will be cancelled. + + The waves to be transmitted are specified by the contents + of data which contains an ordered list of [*wave_id*]s + and optional command codes and related data. + + Returns 0 if OK, otherwise PI_CHAIN_NESTING, + PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, + PI_CHAIN_COUNTER, PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, + or PI_BAD_WAVE_ID. + + Each wave is transmitted in the order specified. A wave + may occur multiple times per chain. + + A blocks of waves may be transmitted multiple times by + using the loop commands. The block is bracketed by loop + start and end commands. Loops may be nested. + + Delays between waves may be added with the delay command. + + The following command codes are supported: + + Name @ Cmd & Data @ Meaning + Loop Start @ 255 0 @ Identify start of a wave block + Loop Repeat @ 255 1 x y @ loop x + y*256 times + Delay @ 255 2 x y @ delay x + y*256 microseconds + Loop Forever @ 255 3 @ loop forever + + If present Loop Forever must be the last entry in the chain. + + The code is currently dimensioned to support a chain with + roughly 600 entries and 20 loop counters. + + ... + #!/usr/bin/env python + + import time + import pigpio + + WAVES=5 + GPIO=4 + + wid=[0]*WAVES + + pi = pigpio.pi() # Connect to local Pi. + + pi.set_mode(GPIO, pigpio.OUTPUT); + + for i in range(WAVES): + pi.wave_add_generic([ + pigpio.pulse(1<=0) for the device at the I2C bus address. + + i2c_bus:= >=0. + i2c_address:= 0-0x7F. + i2c_flags:= 0, no flags are currently defined. + + Physically buses 0 and 1 are available on the Pi. Higher + numbered buses will be available if a kernel supported bus + multiplexor is being used. + + The GPIO used are given in the following table. + + @ SDA @ SCL + I2C 0 @ 0 @ 1 + I2C 1 @ 2 @ 3 + + For the SMBus commands the low level transactions are shown + at the end of the function description. The following + abbreviations are used: + + . . + S (1 bit) : Start bit + P (1 bit) : Stop bit + Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. + A, NA (1 bit) : Accept and not accept bit. + Addr (7 bits): I2C 7 bit address. + reg (8 bits): Command byte, which often selects a register. + Data (8 bits): A data byte. + Count (8 bits): A byte defining the length of a block operation. + + [..]: Data sent by the device. + . . + + ... + h = pi.i2c_open(1, 0x53) # open device at address 0x53 on bus 1 + ... + """ + # I p1 i2c_bus + # I p2 i2c_addr + # I p3 4 + ## extension ## + # I i2c_flags + extents = [struct.pack("I", i2c_flags)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CO, i2c_bus, i2c_address, 4, extents)) + + def i2c_close(self, handle): + """ + Closes the I2C device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + + ... + pi.i2c_close(h) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_I2CC, handle, 0)) + + def i2c_write_quick(self, handle, bit): + """ + Sends a single bit to the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + bit:= 0 or 1, the value to write. + + SMBus 2.0 5.5.1 - Quick command. + . . + S Addr bit [A] P + . . + + ... + pi.i2c_write_quick(0, 1) # send 1 to device 0 + pi.i2c_write_quick(3, 0) # send 0 to device 3 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_I2CWQ, handle, bit)) + + def i2c_write_byte(self, handle, byte_val): + """ + Sends a single byte to the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + byte_val:= 0-255, the value to write. + + SMBus 2.0 5.5.2 - Send byte. + . . + S Addr Wr [A] byte_val [A] P + . . + + ... + pi.i2c_write_byte(1, 17) # send byte 17 to device 1 + pi.i2c_write_byte(2, 0x23) # send byte 0x23 to device 2 + ... + """ + return _u2i( + _pigpio_command(self.sl, _PI_CMD_I2CWS, handle, byte_val)) + + def i2c_read_byte(self, handle): + """ + Reads a single byte from the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + + SMBus 2.0 5.5.3 - Receive byte. + . . + S Addr Rd [A] [Data] NA P + . . + + ... + b = pi.i2c_read_byte(2) # read a byte from device 2 + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_I2CRS, handle, 0)) + + def i2c_write_byte_data(self, handle, reg, byte_val): + """ + Writes a single byte to the specified register of the device + associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + byte_val:= 0-255, the value to write. + + SMBus 2.0 5.5.4 - Write byte. + . . + S Addr Wr [A] reg [A] byte_val [A] P + . . + + ... + # send byte 0xC5 to reg 2 of device 1 + pi.i2c_write_byte_data(1, 2, 0xC5) + + # send byte 9 to reg 4 of device 2 + pi.i2c_write_byte_data(2, 4, 9) + ... + """ + # I p1 handle + # I p2 reg + # I p3 4 + ## extension ## + # I byte_val + extents = [struct.pack("I", byte_val)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CWB, handle, reg, 4, extents)) + + def i2c_write_word_data(self, handle, reg, word_val): + """ + Writes a single 16 bit word to the specified register of the + device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + word_val:= 0-65535, the value to write. + + SMBus 2.0 5.5.4 - Write word. + . . + S Addr Wr [A] reg [A] word_val_Low [A] word_val_High [A] P + . . + + ... + # send word 0xA0C5 to reg 5 of device 4 + pi.i2c_write_word_data(4, 5, 0xA0C5) + + # send word 2 to reg 2 of device 5 + pi.i2c_write_word_data(5, 2, 23) + ... + """ + # I p1 handle + # I p2 reg + # I p3 4 + ## extension ## + # I word_val + extents = [struct.pack("I", word_val)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CWW, handle, reg, 4, extents)) + + def i2c_read_byte_data(self, handle, reg): + """ + Reads a single byte from the specified register of the device + associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + + SMBus 2.0 5.5.5 - Read byte. + . . + S Addr Wr [A] reg [A] S Addr Rd [A] [Data] NA P + . . + + ... + # read byte from reg 17 of device 2 + b = pi.i2c_read_byte_data(2, 17) + + # read byte from reg 1 of device 0 + b = pi.i2c_read_byte_data(0, 1) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_I2CRB, handle, reg)) + + def i2c_read_word_data(self, handle, reg): + """ + Reads a single 16 bit word from the specified register of the + device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + + SMBus 2.0 5.5.5 - Read word. + . . + S Addr Wr [A] reg [A] S Addr Rd [A] [DataLow] A [DataHigh] NA P + . . + + ... + # read word from reg 2 of device 3 + w = pi.i2c_read_word_data(3, 2) + + # read word from reg 7 of device 2 + w = pi.i2c_read_word_data(2, 7) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_I2CRW, handle, reg)) + + def i2c_process_call(self, handle, reg, word_val): + """ + Writes 16 bits of data to the specified register of the device + associated with handle and reads 16 bits of data in return. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + word_val:= 0-65535, the value to write. + + SMBus 2.0 5.5.6 - Process call. + . . + S Addr Wr [A] reg [A] word_val_Low [A] word_val_High [A] + S Addr Rd [A] [DataLow] A [DataHigh] NA P + . . + + ... + r = pi.i2c_process_call(h, 4, 0x1231) + r = pi.i2c_process_call(h, 6, 0) + ... + """ + # I p1 handle + # I p2 reg + # I p3 4 + ## extension ## + # I word_val + extents = [struct.pack("I", word_val)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CPC, handle, reg, 4, extents)) + + def i2c_write_block_data(self, handle, reg, data): + """ + Writes up to 32 bytes to the specified register of the device + associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + data:= the bytes to write. + + SMBus 2.0 5.5.7 - Block write. + . . + S Addr Wr [A] reg [A] len(data) [A] data0 [A] data1 [A] ... [A] + datan [A] P + . . + + ... + pi.i2c_write_block_data(4, 5, b'hello') + + pi.i2c_write_block_data(4, 5, "data bytes") + + pi.i2c_write_block_data(5, 0, b'\\x00\\x01\\x22') + + pi.i2c_write_block_data(6, 2, [0, 1, 0x22]) + ... + """ + # I p1 handle + # I p2 reg + # I p3 len + ## extension ## + # s len data bytes + if len(data): + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CWK, handle, reg, len(data), [data])) + else: + return 0 + + def i2c_read_block_data(self, handle, reg): + """ + Reads a block of up to 32 bytes from the specified register of + the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + + SMBus 2.0 5.5.7 - Block read. + . . + S Addr Wr [A] reg [A] + S Addr Rd [A] [Count] A [Data] A [Data] A ... A [Data] NA P + . . + + The amount of returned data is set by the device. + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (b, d) = pi.i2c_read_block_data(h, 10) + if b >= 0: + # process data + else: + # process read failure + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_nolock( + self.sl, _PI_CMD_I2CRK, handle, reg)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def i2c_block_process_call(self, handle, reg, data): + """ + Writes data bytes to the specified register of the device + associated with handle and reads a device specified number + of bytes of data in return. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + data:= the bytes to write. + + The SMBus 2.0 documentation states that a minimum of 1 byte may + be sent and a minimum of 1 byte may be received. The total + number of bytes sent/received must be 32 or less. + + SMBus 2.0 5.5.8 - Block write-block read. + . . + S Addr Wr [A] reg [A] len(data) [A] data0 [A] ... datan [A] + S Addr Rd [A] [Count] A [Data] ... A P + . . + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (b, d) = pi.i2c_block_process_call(h, 10, b'\\x02\\x05\\x00') + + (b, d) = pi.i2c_block_process_call(h, 10, b'abcdr') + + (b, d) = pi.i2c_block_process_call(h, 10, "abracad") + + (b, d) = pi.i2c_block_process_call(h, 10, [2, 5, 16]) + ... + """ + # I p1 handle + # I p2 reg + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_I2CPK, handle, reg, len(data), [data])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def i2c_write_i2c_block_data(self, handle, reg, data): + """ + Writes data bytes to the specified register of the device + associated with handle . 1-32 bytes may be written. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + data:= the bytes to write. + + . . + S Addr Wr [A] reg [A] data0 [A] data1 [A] ... [A] datan [NA] P + . . + + ... + pi.i2c_write_i2c_block_data(4, 5, 'hello') + + pi.i2c_write_i2c_block_data(4, 5, b'hello') + + pi.i2c_write_i2c_block_data(5, 0, b'\\x00\\x01\\x22') + + pi.i2c_write_i2c_block_data(6, 2, [0, 1, 0x22]) + ... + """ + # I p1 handle + # I p2 reg + # I p3 len + ## extension ## + # s len data bytes + if len(data): + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CWI, handle, reg, len(data), [data])) + else: + return 0 + + def i2c_read_i2c_block_data(self, handle, reg, count): + """ + Reads count bytes from the specified register of the device + associated with handle . The count may be 1-32. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + reg:= >=0, the device register. + count:= >0, the number of bytes to read. + + . . + S Addr Wr [A] reg [A] + S Addr Rd [A] [Data] A [Data] A ... A [Data] NA P + . . + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (b, d) = pi.i2c_read_i2c_block_data(h, 4, 32) + if b >= 0: + # process data + else: + # process read failure + ... + """ + # I p1 handle + # I p2 reg + # I p3 4 + ## extension ## + # I count + extents = [struct.pack("I", count)] + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_I2CRI, handle, reg, 4, extents)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def i2c_read_device(self, handle, count): + """ + Returns count bytes read from the raw device associated + with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + count:= >0, the number of bytes to read. + + . . + S Addr Rd [A] [Data] A [Data] A ... A [Data] NA P + . . + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (count, data) = pi.i2c_read_device(h, 12) + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i( + _pigpio_command_nolock(self.sl, _PI_CMD_I2CRD, handle, count)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def i2c_write_device(self, handle, data): + """ + Writes the data bytes to the raw device associated with handle. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + data:= the bytes to write. + + . . + S Addr Wr [A] data0 [A] data1 [A] ... [A] datan [A] P + . . + + ... + pi.i2c_write_device(h, b"\\x12\\x34\\xA8") + + pi.i2c_write_device(h, b"help") + + pi.i2c_write_device(h, 'help') + + pi.i2c_write_device(h, [23, 56, 231]) + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + if len(data): + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_I2CWD, handle, 0, len(data), [data])) + else: + return 0 + + + def i2c_zip(self, handle, data): + """ + This function executes a sequence of I2C operations. The + operations to be performed are specified by the contents of data + which contains the concatenated command codes and associated data. + + handle:= >=0 (as returned by a prior call to [*i2c_open*]). + data:= the concatenated I2C commands, see below + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (count, data) = pi.i2c_zip(h, [4, 0x53, 7, 1, 0x32, 6, 6, 0]) + ... + + The following command codes are supported: + + Name @ Cmd & Data @ Meaning + End @ 0 @ No more commands + Escape @ 1 @ Next P is two bytes + On @ 2 @ Switch combined flag on + Off @ 3 @ Switch combined flag off + Address @ 4 P @ Set I2C address to P + Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) + Read @ 6 P @ Read P bytes of data + Write @ 7 P ... @ Write P bytes of data + + The address, read, and write commands take a parameter P. + Normally P is one byte (0-255). If the command is preceded by + the Escape command then P is two bytes (0-65535, least significant + byte first). + + The address defaults to that associated with the handle. + The flags default to 0. The address and flags maintain their + previous value until updated. + + Any read I2C data is concatenated in the returned bytearray. + + ... + Set address 0x53, write 0x32, read 6 bytes + Set address 0x1E, write 0x03, read 6 bytes + Set address 0x68, write 0x1B, read 8 bytes + End + + 0x04 0x53 0x07 0x01 0x32 0x06 0x06 + 0x04 0x1E 0x07 0x01 0x03 0x06 0x06 + 0x04 0x68 0x07 0x01 0x1B 0x06 0x08 + 0x00 + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_I2CZ, handle, 0, len(data), [data])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + + def bb_spi_open(self, CS, MISO, MOSI, SCLK, baud=100000, spi_flags=0): + """ + This function selects a set of GPIO for bit banging SPI at a + specified baud rate. + + CS := 0-31 + MISO := 0-31 + MOSI := 0-31 + SCLK := 0-31 + baud := 50-250000 + spiFlags := see below + + spiFlags consists of the least significant 22 bits. + + . . + 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m + . . + + mm defines the SPI mode, defaults to 0 + + . . + Mode CPOL CPHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 + . . + + The following constants may be used to set the mode: + + . . + pigpio.SPI_MODE_0 + pigpio.SPI_MODE_1 + pigpio.SPI_MODE_2 + pigpio.SPI_MODE_3 + . . + + Alternatively pigpio.SPI_CPOL and/or pigpio.SPI_CPHA + may be used. + + p is 0 if CS is active low (default) and 1 for active high. + pigpio.SPI_CS_HIGH_ACTIVE may be used to set this flag. + + T is 1 if the least significant bit is transmitted on MOSI first, + the default (0) shifts the most significant bit out first. + pigpio.SPI_TX_LSBFIRST may be used to set this flag. + + R is 1 if the least significant bit is received on MISO first, + the default (0) receives the most significant bit first. + pigpio.SPI_RX_LSBFIRST may be used to set this flag. + + The other bits in spiFlags should be set to zero. + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_SPI_BAUD, or + PI_GPIO_IN_USE. + + If more than one device is connected to the SPI bus (defined by + SCLK, MOSI, and MISO) each must have its own CS. + + ... + bb_spi_open(10, MISO, MOSI, SCLK, 10000, 0); // device 1 + bb_spi_open(11, MISO, MOSI, SCLK, 20000, 3); // device 2 + ... + """ + # I p1 CS + # I p2 0 + # I p3 20 + ## extension ## + # I MISO + # I MOSI + # I SCLK + # I baud + # I spi_flags + + extents = [struct.pack("IIIII", MISO, MOSI, SCLK, baud, spi_flags)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_BSPIO, CS, 0, 20, extents)) + + + def bb_spi_close(self, CS): + """ + This function stops bit banging SPI on a set of GPIO + opened with [*bb_spi_open*]. + + CS:= 0-31, the CS GPIO used in a prior call to [*bb_spi_open*] + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SPI_GPIO. + + ... + pi.bb_spi_close(CS) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_BSPIC, CS, 0)) + + + def bb_spi_xfer(self, CS, data): + """ + This function executes a bit banged SPI transfer. + + CS:= 0-31 (as used in a prior call to [*bb_spi_open*]) + data:= data to be sent + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + #!/usr/bin/env python + + import pigpio + + CE0=5 + CE1=6 + MISO=13 + MOSI=19 + SCLK=12 + + pi = pigpio.pi() + if not pi.connected: + exit() + + pi.bb_spi_open(CE0, MISO, MOSI, SCLK, 10000, 0) # MCP4251 DAC + pi.bb_spi_open(CE1, MISO, MOSI, SCLK, 20000, 3) # MCP3008 ADC + + for i in range(256): + + count, data = pi.bb_spi_xfer(CE0, [0, i]) # Set DAC value + + if count == 2: + + count, data = pi.bb_spi_xfer(CE0, [12, 0]) # Read back DAC + + if count == 2: + + set_val = data[1] + + count, data = pi.bb_spi_xfer(CE1, [1, 128, 0]) # Read ADC + + if count == 3: + + read_val = ((data[1]&3)<<8) | data[2] + + print("{} {}".format(set_val, read_val)) + + pi.bb_spi_close(CE0) + pi.bb_spi_close(CE1) + + pi.stop() + ... + """ + # I p1 CS + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_BSPIX, CS, 0, len(data), [data])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + + def bb_i2c_open(self, SDA, SCL, baud=100000): + """ + This function selects a pair of GPIO for bit banging I2C at a + specified baud rate. + + Bit banging I2C allows for certain operations which are not possible + with the standard I2C driver. + + o baud rates as low as 50 + o repeated starts + o clock stretching + o I2C on any pair of spare GPIO + + SDA:= 0-31 + SCL:= 0-31 + baud:= 50-500000 + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or + PI_GPIO_IN_USE. + + NOTE: + + The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. + As a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + + ... + h = pi.bb_i2c_open(4, 5, 50000) # bit bang on GPIO 4/5 at 50kbps + ... + """ + # I p1 SDA + # I p2 SCL + # I p3 4 + ## extension ## + # I baud + extents = [struct.pack("I", baud)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_BI2CO, SDA, SCL, 4, extents)) + + + def bb_i2c_close(self, SDA): + """ + This function stops bit banging I2C on a pair of GPIO + previously opened with [*bb_i2c_open*]. + + SDA:= 0-31, the SDA GPIO used in a prior call to [*bb_i2c_open*] + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. + + ... + pi.bb_i2c_close(SDA) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_BI2CC, SDA, 0)) + + + def bb_i2c_zip(self, SDA, data): + """ + This function executes a sequence of bit banged I2C operations. + The operations to be performed are specified by the contents + of data which contains the concatenated command codes and + associated data. + + SDA:= 0-31 (as used in a prior call to [*bb_i2c_open*]) + data:= the concatenated I2C commands, see below + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (count, data) = pi.bb_i2c_zip( + SDA, [4, 0x53, 2, 7, 1, 0x32, 2, 6, 6, 3, 0]) + ... + + The following command codes are supported: + + Name @ Cmd & Data @ Meaning + End @ 0 @ No more commands + Escape @ 1 @ Next P is two bytes + Start @ 2 @ Start condition + Stop @ 3 @ Stop condition + Address @ 4 P @ Set I2C address to P + Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) + Read @ 6 P @ Read P bytes of data + Write @ 7 P ... @ Write P bytes of data + + The address, read, and write commands take a parameter P. + Normally P is one byte (0-255). If the command is preceded by + the Escape command then P is two bytes (0-65535, least significant + byte first). + + The address and flags default to 0. The address and flags maintain + their previous value until updated. + + No flags are currently defined. + + Any read I2C data is concatenated in the returned bytearray. + + ... + Set address 0x53 + start, write 0x32, (re)start, read 6 bytes, stop + Set address 0x1E + start, write 0x03, (re)start, read 6 bytes, stop + Set address 0x68 + start, write 0x1B, (re)start, read 8 bytes, stop + End + + 0x04 0x53 + 0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 + + 0x04 0x1E + 0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 + + 0x04 0x68 + 0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 + + 0x00 + ... + """ + # I p1 SDA + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_BI2CZ, SDA, 0, len(data), [data])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def event_trigger(self, event): + """ + This function signals the occurrence of an event. + + event:= 0-31, the event + + Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + + An event is a signal used to inform one or more consumers + to start an action. Each consumer which has registered an + interest in the event (e.g. by calling [*event_callback*]) will + be informed by a callback. + + One event, EVENT_BSC (31) is predefined. This event is + auto generated on BSC slave activity. + + The meaning of other events is arbitrary. + + Note that other than its id and its tick there is no data associated + with an event. + + ... + pi.event_trigger(23) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_EVT, event, 0)) + + + def bsc_xfer(self, bsc_control, data): + """ + This function provides a low-level interface to the SPI/I2C Slave + peripheral on the BCM chip. + + This peripheral allows the Pi to act as a hardware slave device + on an I2C or SPI bus. + + This is not a bit bang version and as such is OS timing + independent. The bus timing is handled directly by the chip. + + The output process is simple. You simply append data to the FIFO + buffer on the chip. This works like a queue, you add data to the + queue and the master removes it. + + The function sets the BSC mode, writes any data in + the transmit buffer to the BSC transmit FIFO, and + copies any data in the BSC receive FIFO to the + receive buffer. + + bsc_control:= see below + data:= the data bytes to place in the transmit FIFO. + + The returned value is a tuple of the status (see below), + the number of bytes read, and a bytearray containing the + read bytes. If there was an error the status will be less + than zero (and will contain the error code). + + Note that the control word sets the BSC mode. The BSC will + stay in that mode until a different control word is sent. + + GPIO used for models other than those based on the BCM2711. + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE + I2C @ 18 @ 19 @ - @ - @ - @ - + SPI @ - @ - @ 20 @ 19 @ 18 @ 21 + + GPIO used for models based on the BCM2711 (e.g. the Pi4B). + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE + I2C @ 10 @ 11 @ - @ - @ - @ - + SPI @ - @ - @ 9 @ 11 @ 10 @ 8 + + When a zero control word is received the used GPIO will be reset + to INPUT mode. + + bsc_control consists of the following bits: + + . . + 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN + . . + + Bits 0-13 are copied unchanged to the BSC CR register. See + pages 163-165 of the Broadcom peripherals document for full + details. + + aaaaaaa @ defines the I2C slave address (only relevant in I2C mode) + IT @ invert transmit status flags + HC @ enable host control + TF @ enable test FIFO + IR @ invert receive status flags + RE @ enable receive + TE @ enable transmit + BK @ abort operation and clear FIFOs + EC @ send control register as first I2C byte + ES @ send status register as first I2C byte + PL @ set SPI polarity high + PH @ set SPI phase high + I2 @ enable I2C mode + SP @ enable SPI mode + EN @ enable BSC peripheral + + The status has the following format: + + . . + 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + S S S S S R R R R R T T T T T RB TE RF TF RE TB + . . + + Bits 0-15 are copied unchanged from the BSC FR register. See + pages 165-166 of the Broadcom peripherals document for full + details. + + SSSSS @ number of bytes successfully copied to transmit FIFO + RRRRR @ number of bytes in receive FIFO + TTTTT @ number of bytes in transmit FIFO + RB @ receive busy + TE @ transmit FIFO empty + RF @ receive FIFO full + TF @ transmit FIFO full + RE @ receive FIFO empty + TB @ transmit busy + + ... + (status, count, data) = pi.bsc_xfer(0x330305, "Hello!") + ... + + The BSC slave in SPI mode deserializes data from the MOSI pin into its + receiver/FIFO when the LSB of the first byte is a 0. No data is output on + the MISO pin. When the LSB of the first byte on MOSI is a 1, the + transmitter/FIFO data is serialized onto the MISO pin while all other data + on the MOSI pin is ignored. + + The BK bit of the BSC control register is non-functional when in the SPI + mode. The transmitter along with its FIFO can be dequeued by successively + disabling and re-enabling the TE bit on the BSC control register while in + SPI mode. + + This example demonstrates a SPI master talking to the BSC as SPI slave: + Requires SPI master SCLK / MOSI / MISO / CE GPIO are connected to + BSC peripheral GPIO 11 / 9 / 10 / 8 respectively, on a Pi4B (BCM2711). + + ... + #!/usr/bin/env python + + import pigpio + + # Choose some random GPIO for the bit-bang SPI master + CE=15 + MISO=26 + MOSI=13 + SCLK=14 + + pi = pigpio.pi() + if not pi.connected: + exit() + + pi.bb_spi_open(CE, MISO, MOSI, SCLK, 10000, 0) # open SPI master + pi.bsc_xfer(0x303, []) # start BSC as SPI slave + pi.bb_spi_xfer(CE, '\0' + 'hello') # write 'hello' to BSC + status, count, bsc_data = pi.bsc_xfer(0x303, 'world') + print bsc_data # hello + count, spi_data = pi.bb_spi_xfer(CE, [1,0,0,0,0,0]) + print spi_data # world + + pi.bsc_xfer(0, []) + pi.bb_spi_close(CE) + + pi.stop() + ... + """ + # I p1 control + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + status = PI_CMD_INTERRUPTED + bytes = 0 + rdata = bytearray(b'') + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_BSCX, bsc_control, 0, len(data), [data])) + if bytes > 0: + rx = self._rxbuf(bytes) + status = struct.unpack('I', rx[0:4])[0] + bytes -= 4 + rdata = rx[4:] + else: + status = bytes + bytes = 0 + return status, bytes, rdata + + def bsc_i2c(self, i2c_address, data=[]): + """ + This function allows the Pi to act as a slave I2C device. + + The data bytes (if any) are written to the BSC transmit + FIFO and the bytes in the BSC receive FIFO are returned. + + i2c_address:= the I2C slave address. + data:= the data bytes to transmit. + + The returned value is a tuple of the status, the number + of bytes read, and a bytearray containing the read bytes. + + See [*bsc_xfer*] for details of the status value. + + If there was an error the status will be less than zero + (and will contain the error code). + + Note that an i2c_address of 0 may be used to close + the BSC device and reassign the used GPIO as inputs. + + This example assumes GPIO 2/3 are connected to GPIO 18/19 + (GPIO 10/11 on the BCM2711). + + ... + #!/usr/bin/env python + import time + import pigpio + + I2C_ADDR=0x13 + + def i2c(id, tick): + global pi + + s, b, d = pi.bsc_i2c(I2C_ADDR) + if b: + if d[0] == ord('t'): # 116 send 'HH:MM:SS*' + + print("sent={} FR={} received={} [{}]". + format(s>>16, s&0xfff,b,d)) + + s, b, d = pi.bsc_i2c(I2C_ADDR, + "{}*".format(time.asctime()[11:19])) + + elif d[0] == ord('d'): # 100 send 'Sun Oct 30*' + + print("sent={} FR={} received={} [{}]". + format(s>>16, s&0xfff,b,d)) + + s, b, d = pi.bsc_i2c(I2C_ADDR, + "{}*".format(time.asctime()[:10])) + + pi = pigpio.pi() + + if not pi.connected: + exit() + + # Respond to BSC slave activity + + e = pi.event_callback(pigpio.EVENT_BSC, i2c) + + pi.bsc_i2c(I2C_ADDR) # Configure BSC as I2C slave + + time.sleep(600) + + e.cancel() + + pi.bsc_i2c(0) # Disable BSC peripheral + + pi.stop() + ... + + While running the above. + + . . + $ i2cdetect -y 1 + 0 1 2 3 4 5 6 7 8 9 a b c d e f + 00: -- -- -- -- -- -- -- -- -- -- -- -- -- + 10: -- -- -- 13 -- -- -- -- -- -- -- -- -- -- -- -- + 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- + 30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- + 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- + 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- + 60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- + 70: -- -- -- -- -- -- -- -- + + $ pigs i2co 1 0x13 0 + 0 + + $ pigs i2cwd 0 116 + $ pigs i2crd 0 9 -a + 9 10:13:58* + + $ pigs i2cwd 0 116 + $ pigs i2crd 0 9 -a + 9 10:14:29* + + $ pigs i2cwd 0 100 + $ pigs i2crd 0 11 -a + 11 Sun Oct 30* + + $ pigs i2cwd 0 100 + $ pigs i2crd 0 11 -a + 11 Sun Oct 30* + + $ pigs i2cwd 0 116 + $ pigs i2crd 0 9 -a + 9 10:23:16* + + $ pigs i2cwd 0 100 + $ pigs i2crd 0 11 -a + 11 Sun Oct 30* + . . + """ + if i2c_address: + control = (i2c_address<<16)|0x305 + else: + control = 0 + return self.bsc_xfer(control, data) + + def spi_open(self, spi_channel, baud, spi_flags=0): + """ + Returns a handle for the SPI device on the channel. Data + will be transferred at baud bits per second. The flags + may be used to modify the default behaviour of 4-wire + operation, mode 0, active low chip select. + + The Pi has two SPI peripherals: main and auxiliary. + + The main SPI has two chip selects (channels), the auxiliary + has three. + + The auxiliary SPI is available on all models but the A and B. + + The GPIO used are given in the following table. + + @ MISO @ MOSI @ SCLK @ CE0 @ CE1 @ CE2 + Main SPI @ 9 @ 10 @ 11 @ 8 @ 7 @ - + Aux SPI @ 19 @ 20 @ 21 @ 18 @ 17 @ 16 + + spi_channel:= 0-1 (0-2 for the auxiliary SPI). + baud:= 32K-125M (values above 30M are unlikely to work). + spi_flags:= see below. + + spi_flags consists of the least significant 22 bits. + + . . + 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m + . . + + mm defines the SPI mode. + + WARNING: modes 1 and 3 do not appear to work on + the auxiliary SPI. + + . . + Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 + . . + + px is 0 if CEx is active low (default) and 1 for active high. + + ux is 0 if the CEx GPIO is reserved for SPI (default) + and 1 otherwise. + + A is 0 for the main SPI, 1 for the auxiliary SPI. + + W is 0 if the device is not 3-wire, 1 if the device is 3-wire. + Main SPI only. + + nnnn defines the number of bytes (0-15) to write before + switching the MOSI line to MISO to read data. This field + is ignored if W is not set. Main SPI only. + + T is 1 if the least significant bit is transmitted on MOSI + first, the default (0) shifts the most significant bit out + first. Auxiliary SPI only. + + R is 1 if the least significant bit is received on MISO + first, the default (0) receives the most significant bit + first. Auxiliary SPI only. + + bbbbbb defines the word size in bits (0-32). The default (0) + sets 8 bits per word. Auxiliary SPI only. + + The [*spi_read*], [*spi_write*], and [*spi_xfer*] functions + transfer data packed into 1, 2, or 4 bytes according to + the word size in bits. + + For bits 1-8 there will be one byte per character. + For bits 9-16 there will be two bytes per character. + For bits 17-32 there will be four bytes per character. + + Multi-byte transfers are made in least significant byte + first order. + + E.g. to transfer 32 11-bit words data should + contain 64 bytes. + + E.g. to transfer the 14 bit value 0x1ABC send the + bytes 0xBC followed by 0x1A. + + The other bits in flags should be set to zero. + + ... + # open SPI device on channel 1 in mode 3 at 50000 bits per second + + h = pi.spi_open(1, 50000, 3) + ... + """ + # I p1 spi_channel + # I p2 baud + # I p3 4 + ## extension ## + # I spi_flags + extents = [struct.pack("I", spi_flags)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SPIO, spi_channel, baud, 4, extents)) + + def spi_close(self, handle): + """ + Closes the SPI device associated with handle. + + handle:= >=0 (as returned by a prior call to [*spi_open*]). + + ... + pi.spi_close(h) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SPIC, handle, 0)) + + def spi_read(self, handle, count): + """ + Reads count bytes from the SPI device associated with handle. + + handle:= >=0 (as returned by a prior call to [*spi_open*]). + count:= >0, the number of bytes to read. + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (b, d) = pi.spi_read(h, 60) # read 60 bytes from device h + if b == 60: + # process read data + else: + # error path + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_nolock( + self.sl, _PI_CMD_SPIR, handle, count)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def spi_write(self, handle, data): + """ + Writes the data bytes to the SPI device associated with handle. + + handle:= >=0 (as returned by a prior call to [*spi_open*]). + data:= the bytes to write. + + ... + pi.spi_write(0, b'\\x02\\xc0\\x80') # write 3 bytes to device 0 + + pi.spi_write(0, b'defgh') # write 5 bytes to device 0 + + pi.spi_write(0, "def") # write 3 bytes to device 0 + + pi.spi_write(1, [2, 192, 128]) # write 3 bytes to device 1 + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SPIW, handle, 0, len(data), [data])) + + def spi_xfer(self, handle, data): + """ + Writes the data bytes to the SPI device associated with handle, + returning the data bytes read from the device. + + handle:= >=0 (as returned by a prior call to [*spi_open*]). + data:= the bytes to write. + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (count, rx_data) = pi.spi_xfer(h, b'\\x01\\x80\\x00') + + (count, rx_data) = pi.spi_xfer(h, [1, 128, 0]) + + (count, rx_data) = pi.spi_xfer(h, b"hello") + + (count, rx_data) = pi.spi_xfer(h, "hello") + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_SPIX, handle, 0, len(data), [data])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def serial_open(self, tty, baud, ser_flags=0): + """ + Returns a handle for the serial tty device opened + at baud bits per second. The device name must start + with /dev/tty or /dev/serial. + + tty:= the serial device to open. + baud:= baud rate in bits per second, see below. + ser_flags:= 0, no flags are currently defined. + + Normally you would only use the [*serial_**] functions if + you are or will be connecting to the Pi over a network. If + you will always run on the local Pi use the standard serial + module instead. + + The baud rate must be one of 50, 75, 110, 134, 150, + 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, + 38400, 57600, 115200, or 230400. + + ... + h1 = pi.serial_open("/dev/ttyAMA0", 300) + + h2 = pi.serial_open("/dev/ttyUSB1", 19200, 0) + + h3 = pi.serial_open("/dev/serial0", 9600) + ... + """ + # I p1 baud + # I p2 ser_flags + # I p3 len + ## extension ## + # s len data bytes + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SERO, baud, ser_flags, len(tty), [tty])) + + def serial_close(self, handle): + """ + Closes the serial device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + + ... + pi.serial_close(h1) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SERC, handle, 0)) + + def serial_read_byte(self, handle): + """ + Returns a single byte from the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + + If no data is ready a negative error code will be returned. + + ... + b = pi.serial_read_byte(h1) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SERRB, handle, 0)) + + def serial_write_byte(self, handle, byte_val): + """ + Writes a single byte to the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + byte_val:= 0-255, the value to write. + + ... + pi.serial_write_byte(h1, 23) + + pi.serial_write_byte(h1, ord('Z')) + ... + """ + return _u2i( + _pigpio_command(self.sl, _PI_CMD_SERWB, handle, byte_val)) + + def serial_read(self, handle, count=1000): + """ + Reads up to count bytes from the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + count:= >0, the number of bytes to read (defaults to 1000). + + The returned value is a tuple of the number of bytes read and + a bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + If no data is ready a bytes read of zero is returned. + ... + (b, d) = pi.serial_read(h2, 100) + if b > 0: + # process read data + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i( + _pigpio_command_nolock(self.sl, _PI_CMD_SERR, handle, count)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def serial_write(self, handle, data): + """ + Writes the data bytes to the device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + data:= the bytes to write. + + ... + pi.serial_write(h1, b'\\x02\\x03\\x04') + + pi.serial_write(h2, b'help') + + pi.serial_write(h2, "hello") + + pi.serial_write(h1, [2, 3, 4]) + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SERW, handle, 0, len(data), [data])) + + def serial_data_available(self, handle): + """ + Returns the number of bytes available to be read from the + device associated with handle. + + handle:= >=0 (as returned by a prior call to [*serial_open*]). + + ... + rdy = pi.serial_data_available(h1) + + if rdy > 0: + (b, d) = pi.serial_read(h1, rdy) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SERDA, handle, 0)) + + def gpio_trigger(self, user_gpio, pulse_len=10, level=1): + """ + Send a trigger pulse to a GPIO. The GPIO is set to + level for pulse_len microseconds and then reset to not level. + + user_gpio:= 0-31 + pulse_len:= 1-100 + level:= 0-1 + + ... + pi.gpio_trigger(23, 10, 1) + ... + """ + # pigpio message format + + # I p1 user_gpio + # I p2 pulse_len + # I p3 4 + ## extension ## + # I level + extents = [struct.pack("I", level)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_TRIG, user_gpio, pulse_len, 4, extents)) + + def set_glitch_filter(self, user_gpio, steady): + """ + Sets a glitch filter on a GPIO. + + Level changes on the GPIO are not reported unless the level + has been stable for at least [*steady*] microseconds. The + level is then reported. Level changes of less than [*steady*] + microseconds are ignored. + + user_gpio:= 0-31 + steady:= 0-300000 + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + + This filter affects the GPIO samples returned to callbacks set up + with [*callback*] and [*wait_for_edge*]. + + It does not affect levels read by [*read*], + [*read_bank_1*], or [*read_bank_2*]. + + Each (stable) edge will be timestamped [*steady*] + microseconds after it was first detected. + + ... + pi.set_glitch_filter(23, 100) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_FG, user_gpio, steady)) + + def set_noise_filter(self, user_gpio, steady, active): + """ + Sets a noise filter on a GPIO. + + Level changes on the GPIO are ignored until a level which has + been stable for [*steady*] microseconds is detected. Level + changes on the GPIO are then reported for [*active*] + microseconds after which the process repeats. + + user_gpio:= 0-31 + steady:= 0-300000 + active:= 0-1000000 + + Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + + This filter affects the GPIO samples returned to callbacks set up + with [*callback*] and [*wait_for_edge*]. + + It does not affect levels read by [*read*], + [*read_bank_1*], or [*read_bank_2*]. + + Level changes before and after the active period may + be reported. Your software must be designed to cope with + such reports. + + ... + pi.set_noise_filter(23, 1000, 5000) + ... + """ + # pigpio message format + + # I p1 user_gpio + # I p2 steady + # I p3 4 + ## extension ## + # I active + extents = [struct.pack("I", active)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_FN, user_gpio, steady, 4, extents)) + + def store_script(self, script): + """ + Store a script for later execution. + + See [[http://abyz.me.uk/rpi/pigpio/pigs.html#Scripts]] for + details. + + script:= the script text as a series of bytes. + + Returns a >=0 script id if OK. + + ... + sid = pi.store_script( + b'tag 0 w 22 1 mils 100 w 22 0 mils 100 dcr p0 jp 0') + ... + """ + # I p1 0 + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + if len(script): + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_PROC, 0, 0, len(script), [script])) + else: + return 0 + + def run_script(self, script_id, params=None): + """ + Runs a stored script. + + script_id:= id of stored script. + params:= up to 10 parameters required by the script. + + ... + s = pi.run_script(sid, [par1, par2]) + + s = pi.run_script(sid) + + s = pi.run_script(sid, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) + ... + """ + # I p1 script id + # I p2 0 + # I p3 params * 4 (0-10 params) + ## (optional) extension ## + # I[] params + if params is not None: + ext = bytearray() + for p in params: + ext.extend(struct.pack("I", p)) + nump = len(params) + extents = [ext] + else: + nump = 0 + extents = [] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_PROCR, script_id, 0, nump*4, extents)) + + def update_script(self, script_id, params=None): + """ + Sets the parameters of a script. The script may or + may not be running. The first parameters of the script are + overwritten with the new values. + + script_id:= id of stored script. + params:= up to 10 parameters required by the script. + + ... + s = pi.update_script(sid, [par1, par2]) + + s = pi.update_script(sid, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) + ... + """ + # I p1 script id + # I p2 0 + # I p3 params * 4 (0-10 params) + ## (optional) extension ## + # I[] params + if params is not None: + ext = bytearray() + for p in params: + ext.extend(struct.pack("I", p)) + nump = len(params) + extents = [ext] + else: + nump = 0 + extents = [] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_PROCU, script_id, 0, nump*4, extents)) + + def script_status(self, script_id): + """ + Returns the run status of a stored script as well as the + current values of parameters 0 to 9. + + script_id:= id of stored script. + + The run status may be + + . . + PI_SCRIPT_INITING + PI_SCRIPT_HALTED + PI_SCRIPT_RUNNING + PI_SCRIPT_WAITING + PI_SCRIPT_FAILED + . . + + The return value is a tuple of run status and a list of + the 10 parameters. On error the run status will be negative + and the parameter list will be empty. + + ... + (s, pars) = pi.script_status(sid) + ... + """ + status = PI_CMD_INTERRUPTED + params = () + with self.sl.l: + bytes = u2i( + _pigpio_command_nolock(self.sl, _PI_CMD_PROCP, script_id, 0)) + if bytes > 0: + data = self._rxbuf(bytes) + pars = struct.unpack('11i', _str(data)) + status = pars[0] + params = pars[1:] + else: + status = bytes + return status, params + + def stop_script(self, script_id): + """ + Stops a running script. + + script_id:= id of stored script. + + ... + status = pi.stop_script(sid) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PROCS, script_id, 0)) + + def delete_script(self, script_id): + """ + Deletes a stored script. + + script_id:= id of stored script. + + ... + status = pi.delete_script(sid) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PROCD, script_id, 0)) + + def bb_serial_read_open(self, user_gpio, baud, bb_bits=8): + """ + Opens a GPIO for bit bang reading of serial data. + + user_gpio:= 0-31, the GPIO to use. + baud:= 50-250000, the baud rate. + bb_bits:= 1-32, the number of bits per word, default 8. + + The serial data is held in a cyclic buffer and is read using + [*bb_serial_read*]. + + It is the caller's responsibility to read data from the cyclic + buffer in a timely fashion. + + ... + status = pi.bb_serial_read_open(4, 19200) + status = pi.bb_serial_read_open(17, 9600) + ... + """ + # pigpio message format + + # I p1 user_gpio + # I p2 baud + # I p3 4 + ## extension ## + # I bb_bits + extents = [struct.pack("I", bb_bits)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SLRO, user_gpio, baud, 4, extents)) + + def bb_serial_read(self, user_gpio): + """ + Returns data from the bit bang serial cyclic buffer. + + user_gpio:= 0-31 (opened in a prior call to [*bb_serial_read_open*]) + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + The bytes returned for each character depend upon the number of + data bits [*bb_bits*] specified in the [*bb_serial_read_open*] + command. + + For [*bb_bits*] 1-8 there will be one byte per character. + For [*bb_bits*] 9-16 there will be two bytes per character. + For [*bb_bits*] 17-32 there will be four bytes per character. + + ... + (count, data) = pi.bb_serial_read(4) + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i( + _pigpio_command_nolock(self.sl, _PI_CMD_SLR, user_gpio, 10000)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + + def bb_serial_read_close(self, user_gpio): + """ + Closes a GPIO for bit bang reading of serial data. + + user_gpio:= 0-31 (opened in a prior call to [*bb_serial_read_open*]) + + ... + status = pi.bb_serial_read_close(17) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SLRC, user_gpio, 0)) + + def bb_serial_invert(self, user_gpio, invert): + """ + Invert serial logic. + + user_gpio:= 0-31 (opened in a prior call to [*bb_serial_read_open*]) + invert:= 0-1 (1 invert, 0 normal) + + ... + status = pi.bb_serial_invert(17, 1) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_SLRI, user_gpio, invert)) + + + def custom_1(self, arg1=0, arg2=0, argx=[]): + """ + Calls a pigpio function customised by the user. + + arg1:= >=0, default 0. + arg2:= >=0, default 0. + argx:= extra arguments (each 0-255), default empty. + + The returned value is an integer which by convention + should be >=0 for OK and <0 for error. + + ... + value = pi.custom_1() + + value = pi.custom_1(23) + + value = pi.custom_1(0, 55) + + value = pi.custom_1(23, 56, [1, 5, 7]) + + value = pi.custom_1(23, 56, b"hello") + + value = pi.custom_1(23, 56, "hello") + ... + """ + # I p1 arg1 + # I p2 arg2 + # I p3 len + ## extension ## + # s len argx bytes + + return u2i(_pigpio_command_ext( + self.sl, _PI_CMD_CF1, arg1, arg2, len(argx), [argx])) + + def custom_2(self, arg1=0, argx=[], retMax=8192): + """ + Calls a pigpio function customised by the user. + + arg1:= >=0, default 0. + argx:= extra arguments (each 0-255), default empty. + retMax:= >=0, maximum number of bytes to return, default 8192. + + The returned value is a tuple of the number of bytes + returned and a bytearray containing the bytes. If + there was an error the number of bytes read will be + less than zero (and will contain the error code). + + ... + (count, data) = pi.custom_2() + + (count, data) = pi.custom_2(23) + + (count, data) = pi.custom_2(23, [1, 5, 7]) + + (count, data) = pi.custom_2(23, b"hello") + + (count, data) = pi.custom_2(23, "hello", 128) + ... + """ + # I p1 arg1 + # I p2 retMax + # I p3 len + ## extension ## + # s len argx bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_CF2, arg1, retMax, len(argx), [argx])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def get_pad_strength(self, pad): + """ + This function returns the pad drive strength in mA. + + pad:= 0-2, the pad to get. + + Returns the pad drive strength if OK, otherwise PI_BAD_PAD. + + Pad @ GPIO + 0 @ 0-27 + 1 @ 28-45 + 2 @ 46-53 + + ... + strength = pi.get_pad_strength(0) # Get pad 0 strength. + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PADG, pad, 0)) + + def set_pad_strength(self, pad, pad_strength): + """ + This function sets the pad drive strength in mA. + + + pad:= 0-2, the pad to set. + pad_strength:= 1-16 mA. + + Returns 0 if OK, otherwise PI_BAD_PAD, or PI_BAD_STRENGTH. + + Pad @ GPIO + 0 @ 0-27 + 1 @ 28-45 + 2 @ 46-53 + + ... + pi.set_pad_strength(2, 14) # Set pad 2 to 14 mA. + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_PADS, pad, pad_strength)) + + + def file_open(self, file_name, file_mode): + """ + This function returns a handle to a file opened in a specified mode. + + file_name:= the file to open. + file_mode:= the file open mode. + + Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, + PI_NO_FILE_ACCESS, PI_BAD_FILE_MODE, + PI_FILE_OPEN_FAILED, or PI_FILE_IS_A_DIR. + + ... + h = pi.file_open("/home/pi/shared/dir_3/file.txt", + pigpio.FILE_WRITE | pigpio.FILE_CREATE) + + pi.file_write(h, "Hello world") + + pi.file_close(h) + ... + + File + + A file may only be opened if permission is granted by an entry + in /opt/pigpio/access. This is intended to allow remote access + to files in a more or less controlled manner. + + Each entry in /opt/pigpio/access takes the form of a file path + which may contain wildcards followed by a single letter permission. + The permission may be R for read, W for write, U for read/write, + and N for no access. + + Where more than one entry matches a file the most specific rule + applies. If no entry matches a file then access is denied. + + Suppose /opt/pigpio/access contains the following entries: + + . . + /home/* n + /home/pi/shared/dir_1/* w + /home/pi/shared/dir_2/* r + /home/pi/shared/dir_3/* u + /home/pi/shared/dir_1/file.txt n + . . + + Files may be written in directory dir_1 with the exception + of file.txt. + + Files may be read in directory dir_2. + + Files may be read and written in directory dir_3. + + If a directory allows read, write, or read/write access then files + may be created in that directory. + + In an attempt to prevent risky permissions the following paths are + ignored in /opt/pigpio/access: + + . . + a path containing .. + a path containing only wildcards (*?) + a path containing less than two non-wildcard parts + . . + + Mode + + The mode may have the following values: + + Constant @ Value @ Meaning + FILE_READ @ 1 @ open file for reading + FILE_WRITE @ 2 @ open file for writing + FILE_RW @ 3 @ open file for reading and writing + + The following values may be or'd into the mode: + + Name @ Value @ Meaning + FILE_APPEND @ 4 @ All writes append data to the end of the file + FILE_CREATE @ 8 @ The file is created if it doesn't exist + FILE_TRUNC @ 16 @ The file is truncated + + Newly created files are owned by root with permissions owner + read and write. + + ... + #!/usr/bin/env python + + import pigpio + + pi = pigpio.pi() + + if not pi.connected: + exit() + + # Assumes /opt/pigpio/access contains the following line: + # /ram/*.c r + + handle = pi.file_open("/ram/pigpio.c", pigpio.FILE_READ) + + done = False + + while not done: + c, d = pi.file_read(handle, 60000) + if c > 0: + print(d) + else: + done = True + + pi.file_close(handle) + + pi.stop() + ... + """ + # I p1 file_mode + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_FO, file_mode, 0, len(file_name), [file_name])) + + def file_close(self, handle): + """ + Closes the file associated with handle. + + handle:= >=0 (as returned by a prior call to [*file_open*]). + + ... + pi.file_close(handle) + ... + """ + return _u2i(_pigpio_command(self.sl, _PI_CMD_FC, handle, 0)) + + def file_read(self, handle, count): + """ + Reads up to count bytes from the file associated with handle. + + handle:= >=0 (as returned by a prior call to [*file_open*]). + count:= >0, the number of bytes to read. + + The returned value is a tuple of the number of bytes read and a + bytearray containing the bytes. If there was an error the + number of bytes read will be less than zero (and will contain + the error code). + + ... + (b, d) = pi.file_read(h2, 100) + if b > 0: + # process read data + ... + """ + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i( + _pigpio_command_nolock(self.sl, _PI_CMD_FR, handle, count)) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def file_write(self, handle, data): + """ + Writes the data bytes to the file associated with handle. + + handle:= >=0 (as returned by a prior call to [*file_open*]). + data:= the bytes to write. + + ... + pi.file_write(h1, b'\\x02\\x03\\x04') + + pi.file_write(h2, b'help') + + pi.file_write(h2, "hello") + + pi.file_write(h1, [2, 3, 4]) + ... + """ + # I p1 handle + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_FW, handle, 0, len(data), [data])) + + def file_seek(self, handle, seek_offset, seek_from): + """ + Seeks to a position relative to the start, current position, + or end of the file. Returns the new position. + + handle:= >=0 (as returned by a prior call to [*file_open*]). + seek_offset:= byte offset. + seek_from:= FROM_START, FROM_CURRENT, or FROM_END. + + ... + new_pos = pi.file_seek(h, 100, pigpio.FROM_START) + + cur_pos = pi.file_seek(h, 0, pigpio.FROM_CURRENT) + + file_size = pi.file_seek(h, 0, pigpio.FROM_END) + ... + """ + # I p1 handle + # I p2 seek_offset + # I p3 4 + ## extension ## + # I seek_from + extents = [struct.pack("I", seek_from)] + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_FS, handle, seek_offset, 4, extents)) + + def file_list(self, fpattern): + """ + Returns a list of files which match a pattern. + + fpattern:= file pattern to match. + + Returns the number of returned bytes if OK, otherwise + PI_NO_FILE_ACCESS, or PI_NO_FILE_MATCH. + + The pattern must match an entry in /opt/pigpio/access. The + pattern may contain wildcards. See [*file_open*]. + + NOTE + + The returned value is not the number of files, it is the number + of bytes in the buffer. The file names are separated by newline + characters. + + ... + #!/usr/bin/env python + + import pigpio + + pi = pigpio.pi() + + if not pi.connected: + exit() + + # Assumes /opt/pigpio/access contains the following line: + # /ram/*.c r + + c, d = pi.file_list("/ram/p*.c") + if c > 0: + print(d) + + pi.stop() + ... + """ + # I p1 60000 + # I p2 0 + # I p3 len + ## extension ## + # s len data bytes + + bytes = PI_CMD_INTERRUPTED + rdata = "" + with self.sl.l: + bytes = u2i(_pigpio_command_ext_nolock( + self.sl, _PI_CMD_FL, 60000, 0, len(fpattern), [fpattern])) + if bytes > 0: + rdata = self._rxbuf(bytes) + return bytes, rdata + + def shell(self, shellscr, pstring=""): + """ + This function uses the system call to execute a shell script + with the given string as its parameter. + + shellscr:= the name of the script, only alphanumerics, + '-' and '_' are allowed in the name + pstring := the parameter string to pass to the script + + The exit status of the system call is returned if OK, + otherwise PI_BAD_SHELL_STATUS. + + [*shellscr*] must exist in /opt/pigpio/cgi and must be executable. + + The returned exit status is normally 256 times that set by + the shell script exit function. If the script can't be + found 32512 will be returned. + + The following table gives some example returned statuses: + + Script exit status @ Returned system call status + 1 @ 256 + 5 @ 1280 + 10 @ 2560 + 200 @ 51200 + script not found @ 32512 + + ... + // pass two parameters, hello and world + status = pi.shell("scr1", "hello world"); + + // pass three parameters, hello, string with spaces, and world + status = pi.shell("scr1", "hello 'string with spaces' world"); + + // pass one parameter, hello string with spaces world + status = pi.shell("scr1", "\\"hello string with spaces world\\""); + ... + """ + # I p1 len(shellscr) + # I p2 0 + # I p3 len(shellscr)+len(pstring)+1 + ## extension ## + # s len data bytes + + ls = len(shellscr) + lp = len(pstring) + return _u2i(_pigpio_command_ext( + self.sl, _PI_CMD_SHELL, ls, 0, ls+lp+1, [shellscr+'\x00'+pstring])) + + + def callback(self, user_gpio, edge=RISING_EDGE, func=None): + """ + Calls a user supplied function (a callback) whenever the + specified GPIO edge is detected. + + user_gpio:= 0-31. + edge:= EITHER_EDGE, RISING_EDGE (default), or FALLING_EDGE. + func:= user supplied callback function. + + The user supplied callback receives three parameters, the GPIO, + the level, and the tick. + + . . + Parameter Value Meaning + + GPIO 0-31 The GPIO which has changed state + + level 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + + tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes + . . + + If a user callback is not specified a default tally callback is + provided which simply counts edges. The count may be retrieved + by calling the tally function. The count may be reset to zero + by calling the reset_tally function. + + The callback may be cancelled by calling the cancel function. + + A GPIO may have multiple callbacks (although I can't think of + a reason to do so). + + The GPIO are sampled at a rate set when the pigpio daemon + is started (default 5 us). + + The number of samples per second is given in the following table. + + . . + samples + per sec + + 1 1,000,000 + 2 500,000 + sample 4 250,000 + rate 5 200,000 + (us) 8 125,000 + 10 100,000 + . . + + GPIO level changes shorter than the sample rate may be missed. + + The daemon software which generates the callbacks is triggered + 1000 times per second. The callbacks will be called once per + level change since the last time they were called. + i.e. The callbacks will get all level changes but there will + be a latency. + + If you want to track the level of more than one GPIO do so by + maintaining the state in the callback. Do not use [*read*]. + Remember the event that triggered the callback may have + happened several milliseconds before and the GPIO may have + changed level many times since then. + + ... + def cbf(gpio, level, tick): + print(gpio, level, tick) + + cb1 = pi.callback(22, pigpio.EITHER_EDGE, cbf) + + cb2 = pi.callback(4, pigpio.EITHER_EDGE) + + cb3 = pi.callback(17) + + print(cb3.tally()) + + cb3.reset_tally() + + cb1.cancel() # To cancel callback cb1. + ... + """ + return _callback(self._notify, user_gpio, edge, func) + + def event_callback(self, event, func=None): + """ + Calls a user supplied function (a callback) whenever the + specified event is signalled. + + event:= 0-31. + func:= user supplied callback function. + + The user supplied callback receives two parameters, the event id, + and the tick. + + If a user callback is not specified a default tally callback is + provided which simply counts events. The count may be retrieved + by calling the tally function. The count may be reset to zero + by calling the reset_tally function. + + The callback may be canceled by calling the cancel function. + + An event may have multiple callbacks (although I can't think of + a reason to do so). + + ... + def cbf(event, tick): + print(event, tick) + + cb1 = pi.event_callback(22, cbf) + + cb2 = pi.event_callback(4) + + print(cb2.tally()) + + cb2.reset_tally() + + cb1.cancel() # To cancel callback cb1. + ... + """ + + return _event(self._notify, event, func) + + def wait_for_edge(self, user_gpio, edge=RISING_EDGE, wait_timeout=60.0): + """ + Wait for an edge event on a GPIO. + + user_gpio:= 0-31. + edge:= EITHER_EDGE, RISING_EDGE (default), or + FALLING_EDGE. + wait_timeout:= >=0.0 (default 60.0). + + The function returns when the edge is detected or after + the number of seconds specified by timeout has expired. + + Do not use this function for precise timing purposes, + the edge is only checked 20 times a second. Whenever + you need to know the accurate time of GPIO events use + a [*callback*] function. + + The function returns True if the edge is detected, + otherwise False. + + ... + if pi.wait_for_edge(23): + print("Rising edge detected") + else: + print("wait for edge timed out") + + if pi.wait_for_edge(23, pigpio.FALLING_EDGE, 5.0): + print("Falling edge detected") + else: + print("wait for falling edge timed out") + ... + """ + a = _wait_for_edge(self._notify, user_gpio, edge, wait_timeout) + return a.trigger + + def wait_for_event(self, event, wait_timeout=60.0): + """ + Wait for an event. + + event:= 0-31. + wait_timeout:= >=0.0 (default 60.0). + + The function returns when the event is signalled or after + the number of seconds specified by timeout has expired. + + The function returns True if the event is detected, + otherwise False. + + ... + if pi.wait_for_event(23): + print("event detected") + else: + print("wait for event timed out") + ... + """ + a = _wait_for_event(self._notify, event, wait_timeout) + return a.trigger + + def __init__(self, + host = os.getenv("PIGPIO_ADDR", 'localhost'), + port = os.getenv("PIGPIO_PORT", 8888), + show_errors = True): + """ + Grants access to a Pi's GPIO. + + host:= the host name of the Pi on which the pigpio daemon is + running. The default is localhost unless overridden by + the PIGPIO_ADDR environment variable. + + port:= the port number on which the pigpio daemon is listening. + The default is 8888 unless overridden by the PIGPIO_PORT + environment variable. The pigpio daemon must have been + started with the same port number. + + This connects to the pigpio daemon and reserves resources + to be used for sending commands and receiving notifications. + + An instance attribute [*connected*] may be used to check the + success of the connection. If the connection is established + successfully [*connected*] will be True, otherwise False. + + ... + pi = pigio.pi() # use defaults + pi = pigpio.pi('mypi') # specify host, default port + pi = pigpio.pi('mypi', 7777) # specify host and port + + pi = pigpio.pi() # exit script if no connection + if not pi.connected: + exit() + ... + """ + self.connected = True + + self.sl = _socklock() + self._notify = None + + port = int(port) + + if host == '': + host = "localhost" + + self._host = host + self._port = port + + try: + self.sl.s = socket.create_connection((host, port), None) + + # Disable the Nagle algorithm. + self.sl.s.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + + self._notify = _callback_thread(self.sl, host, port) + + except socket.error: + exception = 1 + + except struct.error: + exception = 2 + + except error: + # assumed to be no handle available + exception = 3 + + else: + exception = 0 + atexit.register(self.stop) + + if exception != 0: + + self.connected = False + + if self.sl.s is not None: + self.sl.s = None + + if show_errors: + + s = "Can't connect to pigpio at {}({})".format(host, str(port)) + + + print(_except_a.format(s)) + if exception == 1: + print(_except_1) + elif exception == 2: + print(_except_2) + else: + print(_except_3) + print(_except_z) + + def __repr__(self): + return "".format(self._host, self._port) + + def stop(self): + """Release pigpio resources. + + ... + pi.stop() + ... + """ + + self.connected = False + + if self._notify is not None: + self._notify.stop() + self._notify = None + + if self.sl.s is not None: + self.sl.s.close() + self.sl.s = None + +def xref(): + """ + active: 0-1000000 + The number of microseconds level changes are reported for once + a noise filter has been triggered (by [*steady*] microseconds of + a stable level). + + + arg1: + An unsigned argument passed to a user customised function. Its + meaning is defined by the customiser. + + arg2: + An unsigned argument passed to a user customised function. Its + meaning is defined by the customiser. + + argx: + An array of bytes passed to a user customised function. + Its meaning and content is defined by the customiser. + + baud: + The speed of serial communication (I2C, SPI, serial link, waves) + in bits per second. + + bb_bits: 1-32 + The number of data bits to be used when adding serial data to a + waveform. + + bb_stop: 2-8 + The number of (half) stop bits to be used when adding serial data + to a waveform. + + bit: 0-1 + A value of 0 or 1. + + bits: 32 bit number + A mask used to select GPIO to be operated on. If bit n is set + then GPIO n is selected. A convenient way of setting bit n is to + bit or in the value (1<=1 + The length of a pulse in microseconds. + + dutycycle: 0-range_ + A number between 0 and range_. + + The dutycycle sets the proportion of time on versus time off during each + PWM cycle. + + Dutycycle @ On time + 0 @ Off + range_ * 0.25 @ 25% On + range_ * 0.50 @ 50% On + range_ * 0.75 @ 75% On + range_ @ Fully On + + edge: 0-2 + + . . + EITHER_EDGE = 2 + FALLING_EDGE = 1 + RISING_EDGE = 0 + . . + + errnum: <0 + + . . + PI_BAD_USER_GPIO = -2 + PI_BAD_GPIO = -3 + PI_BAD_MODE = -4 + PI_BAD_LEVEL = -5 + PI_BAD_PUD = -6 + PI_BAD_PULSEWIDTH = -7 + PI_BAD_DUTYCYCLE = -8 + PI_BAD_WDOG_TIMEOUT = -15 + PI_BAD_DUTYRANGE = -21 + PI_NO_HANDLE = -24 + PI_BAD_HANDLE = -25 + PI_BAD_WAVE_BAUD = -35 + PI_TOO_MANY_PULSES = -36 + PI_TOO_MANY_CHARS = -37 + PI_NOT_SERIAL_GPIO = -38 + PI_NOT_PERMITTED = -41 + PI_SOME_PERMITTED = -42 + PI_BAD_WVSC_COMMND = -43 + PI_BAD_WVSM_COMMND = -44 + PI_BAD_WVSP_COMMND = -45 + PI_BAD_PULSELEN = -46 + PI_BAD_SCRIPT = -47 + PI_BAD_SCRIPT_ID = -48 + PI_BAD_SER_OFFSET = -49 + PI_GPIO_IN_USE = -50 + PI_BAD_SERIAL_COUNT = -51 + PI_BAD_PARAM_NUM = -52 + PI_DUP_TAG = -53 + PI_TOO_MANY_TAGS = -54 + PI_BAD_SCRIPT_CMD = -55 + PI_BAD_VAR_NUM = -56 + PI_NO_SCRIPT_ROOM = -57 + PI_NO_MEMORY = -58 + PI_SOCK_READ_FAILED = -59 + PI_SOCK_WRIT_FAILED = -60 + PI_TOO_MANY_PARAM = -61 + PI_SCRIPT_NOT_READY = -62 + PI_BAD_TAG = -63 + PI_BAD_MICS_DELAY = -64 + PI_BAD_MILS_DELAY = -65 + PI_BAD_WAVE_ID = -66 + PI_TOO_MANY_CBS = -67 + PI_TOO_MANY_OOL = -68 + PI_EMPTY_WAVEFORM = -69 + PI_NO_WAVEFORM_ID = -70 + PI_I2C_OPEN_FAILED = -71 + PI_SER_OPEN_FAILED = -72 + PI_SPI_OPEN_FAILED = -73 + PI_BAD_I2C_BUS = -74 + PI_BAD_I2C_ADDR = -75 + PI_BAD_SPI_CHANNEL = -76 + PI_BAD_FLAGS = -77 + PI_BAD_SPI_SPEED = -78 + PI_BAD_SER_DEVICE = -79 + PI_BAD_SER_SPEED = -80 + PI_BAD_PARAM = -81 + PI_I2C_WRITE_FAILED = -82 + PI_I2C_READ_FAILED = -83 + PI_BAD_SPI_COUNT = -84 + PI_SER_WRITE_FAILED = -85 + PI_SER_READ_FAILED = -86 + PI_SER_READ_NO_DATA = -87 + PI_UNKNOWN_COMMAND = -88 + PI_SPI_XFER_FAILED = -89 + PI_NO_AUX_SPI = -91 + PI_NOT_PWM_GPIO = -92 + PI_NOT_SERVO_GPIO = -93 + PI_NOT_HCLK_GPIO = -94 + PI_NOT_HPWM_GPIO = -95 + PI_BAD_HPWM_FREQ = -96 + PI_BAD_HPWM_DUTY = -97 + PI_BAD_HCLK_FREQ = -98 + PI_BAD_HCLK_PASS = -99 + PI_HPWM_ILLEGAL = -100 + PI_BAD_DATABITS = -101 + PI_BAD_STOPBITS = -102 + PI_MSG_TOOBIG = -103 + PI_BAD_MALLOC_MODE = -104 + PI_BAD_SMBUS_CMD = -107 + PI_NOT_I2C_GPIO = -108 + PI_BAD_I2C_WLEN = -109 + PI_BAD_I2C_RLEN = -110 + PI_BAD_I2C_CMD = -111 + PI_BAD_I2C_BAUD = -112 + PI_CHAIN_LOOP_CNT = -113 + PI_BAD_CHAIN_LOOP = -114 + PI_CHAIN_COUNTER = -115 + PI_BAD_CHAIN_CMD = -116 + PI_BAD_CHAIN_DELAY = -117 + PI_CHAIN_NESTING = -118 + PI_CHAIN_TOO_BIG = -119 + PI_DEPRECATED = -120 + PI_BAD_SER_INVERT = -121 + PI_BAD_FOREVER = -124 + PI_BAD_FILTER = -125 + PI_BAD_PAD = -126 + PI_BAD_STRENGTH = -127 + PI_FIL_OPEN_FAILED = -128 + PI_BAD_FILE_MODE = -129 + PI_BAD_FILE_FLAG = -130 + PI_BAD_FILE_READ = -131 + PI_BAD_FILE_WRITE = -132 + PI_FILE_NOT_ROPEN = -133 + PI_FILE_NOT_WOPEN = -134 + PI_BAD_FILE_SEEK = -135 + PI_NO_FILE_MATCH = -136 + PI_NO_FILE_ACCESS = -137 + PI_FILE_IS_A_DIR = -138 + PI_BAD_SHELL_STATUS = -139 + PI_BAD_SCRIPT_NAME = -140 + PI_BAD_SPI_BAUD = -141 + PI_NOT_SPI_GPIO = -142 + PI_BAD_EVENT_ID = -143 + PI_CMD_INTERRUPTED = -144 + PI_NOT_ON_BCM2711 = -145 + PI_ONLY_ON_BCM2711 = -146 + . . + + event:0-31 + An event is a signal used to inform one or more consumers + to start an action. + + file_mode: + The mode may have the following values + + . . + FILE_READ 1 + FILE_WRITE 2 + FILE_RW 3 + . . + + The following values can be or'd into the file open mode + + . . + FILE_APPEND 4 + FILE_CREATE 8 + FILE_TRUNC 16 + . . + + file_name: + A full file path. To be accessible the path must match + an entry in /opt/pigpio/access. + + fpattern: + A file path which may contain wildcards. To be accessible the path + must match an entry in /opt/pigpio/access. + + frequency: 0-40000 + Defines the frequency to be used for PWM on a GPIO. + The closest permitted frequency will be used. + + func: + A user supplied callback function. + + gpio: 0-53 + A Broadcom numbered GPIO. All the user GPIO are in the range 0-31. + + There are 54 General Purpose Input Outputs (GPIO) named GPIO0 + through GPIO53. + + They are split into two banks. Bank 1 consists of GPIO0 + through GPIO31. Bank 2 consists of GPIO32 through GPIO53. + + All the GPIO which are safe for the user to read and write are in + bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards + have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + + See [*get_hardware_revision*]. + + The user GPIO are marked with an X in the following table + + . . + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 + Type 1 X X - - X - - X X X X X - - X X + Type 2 - - X X X - - X X X X X - - X X + Type 3 X X X X X X X X X X X X X X + + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 + Type 1 - X X - - X X X X X - - - - - - + Type 2 - X X - - - X X X X - X X X X X + Type 3 X X X X X X X X X X X X - - - - + . . + + gpio_off: + A mask used to select GPIO to be operated on. See [*bits*]. + + This mask selects the GPIO to be switched off at the start + of a pulse. + + gpio_on: + A mask used to select GPIO to be operated on. See [*bits*]. + + This mask selects the GPIO to be switched on at the start + of a pulse. + + handle: >=0 + A number referencing an object opened by one of the following + + [*file_open*] + [*i2c_open*] + [*notify_open*] + [*serial_open*] + [*spi_open*] + + host: + The name or IP address of the Pi running the pigpio daemon. + + i2c_address: 0-0x7F + The address of a device on the I2C bus. + + i2c_bus: >=0 + An I2C bus number. + + i2c_flags: 0 + No I2C flags are currently defined. + + invert: 0-1 + A flag used to set normal or inverted bit bang serial data + level logic. + + level: 0-1 (2) + + . . + CLEAR = 0 + HIGH = 1 + LOW = 0 + OFF = 0 + ON = 1 + SET = 1 + TIMEOUT = 2 # only returned for a watchdog timeout + . . + + MISO: + The GPIO used for the MISO signal when bit banging SPI. + + mode: + + 1.The operational mode of a GPIO, normally INPUT or OUTPUT. + + . . + ALT0 = 4 + ALT1 = 5 + ALT2 = 6 + ALT3 = 7 + ALT4 = 3 + ALT5 = 2 + INPUT = 0 + OUTPUT = 1 + . . + + 2. The mode of waveform transmission. + + . . + WAVE_MODE_ONE_SHOT = 0 + WAVE_MODE_REPEAT = 1 + WAVE_MODE_ONE_SHOT_SYNC = 2 + WAVE_MODE_REPEAT_SYNC = 3 + . . + + MOSI: + The GPIO used for the MOSI signal when bit banging SPI. + + offset: >=0 + The offset wave data starts from the beginning of the waveform + being currently defined. + + pad: 0-2 + A set of GPIO which share common drivers. + + Pad @ GPIO + 0 @ 0-27 + 1 @ 28-45 + 2 @ 46-53 + + pad_strength: 1-16 + The mA which may be drawn from each GPIO whilst still guaranteeing the + high and low levels. + + params: 32 bit number + When scripts are started they can receive up to 10 parameters + to define their operation. + + percent:: 0-100 + The size of waveform as percentage of maximum available. + + port: + The port used by the pigpio daemon, defaults to 8888. + + pstring: + The string to be passed to a [*shell*] script to be executed. + + pud: 0-2 + . . + PUD_DOWN = 1 + PUD_OFF = 0 + PUD_UP = 2 + . . + + pulse_len: 1-100 + The length of the trigger pulse in microseconds. + + pulses: + A list of class pulse objects defining the characteristics of a + waveform. + + pulsewidth: + The servo pulsewidth in microseconds. 0 switches pulses off. + + PWMduty: 0-1000000 (1M) + The hardware PWM dutycycle. + + PWMfreq: 1-125M (1-187.5M for the BCM2711) + The hardware PWM frequency. + + range_: 25-40000 + Defines the limits for the [*dutycycle*] parameter. + + range_ defaults to 255. + + reg: 0-255 + An I2C device register. The usable registers depend on the + actual device. + + retMax: >=0 + The maximum number of bytes a user customised function + should return, default 8192. + + SCL: + The user GPIO to use for the clock when bit banging I2C. + + SCLK:: + The GPIO used for the SCLK signal when bit banging SPI. + + script: + The text of a script to store on the pigpio daemon. + + script_id: >=0 + A number referencing a script created by [*store_script*]. + + SDA: + The user GPIO to use for data when bit banging I2C. + + seek_from: 0-2 + Direction to seek for [*file_seek*]. + + . . + FROM_START=0 + FROM_CURRENT=1 + FROM_END=2 + . . + + seek_offset: + The number of bytes to move forward (positive) or backwards + (negative) from the seek position (start, current, or end of file). + + ser_flags: 32 bit + No serial flags are currently defined. + + serial_*: + One of the serial_ functions. + + shellscr: + The name of a shell script. The script must exist + in /opt/pigpio/cgi and must be executable. + + show_errors: + Controls the display of pigpio daemon connection failures. + The default of True prints the probable failure reasons to + standard output. + + spi_channel: 0-2 + A SPI channel. + + spi_flags: 32 bit + See [*spi_open*]. + + steady: 0-300000 + + The number of microseconds level changes must be stable for + before reporting the level changed ([*set_glitch_filter*]) + or triggering the active part of a noise filter + ([*set_noise_filter*]). + + t1: + A tick (earlier). + + t2: + A tick (later). + + tty: + A Pi serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0 + + uint32: + An unsigned 32 bit number. + + user_gpio: 0-31 + A Broadcom numbered GPIO. + + All the user GPIO are in the range 0-31. + + Not all the GPIO within this range are usable, some are reserved + for system use. + + See [*gpio*]. + + wait_timeout: 0.0 - + The number of seconds to wait in [*wait_for_edge*] before timing out. + + wave_add_*: + One of the following + + [*wave_add_new*] + [*wave_add_generic*] + [*wave_add_serial*] + + wave_id: >=0 + A number referencing a wave created by [*wave_create*]. + + wave_send_*: + One of the following + + [*wave_send_once*] + [*wave_send_repeat*] + + wdog_timeout: 0-60000 + Defines a GPIO watchdog timeout in milliseconds. If no level + change is detected on the GPIO for timeout millisecond a watchdog + timeout report is issued (with level TIMEOUT). + + word_val: 0-65535 + A whole number. + """ + pass + diff --git a/pigpio-master/pigpiod.1 b/pigpio-master/pigpiod.1 new file mode 100644 index 0000000..29f8326 --- /dev/null +++ b/pigpio-master/pigpiod.1 @@ -0,0 +1,273 @@ + +." Process this file with +." groff -man -Tascii pigpiod.1 +." +.TH pigpiod 1 2012-2020 Linux "pigpio archive" +.SH NAME +pigpiod - A utility to start the pigpio library as a daemon. + +.SH SYNOPSIS + +sudo pigpiod [OPTION]... +.SH DESCRIPTION + + +.ad l + +.nh +pigpiod is a utility which launches the pigpio library as a daemon. +.br + +.br +Once launched the pigpio library runs in the background accepting commands from the pipe and socket interfaces. +.br + +.br +The pigpiod utility requires sudo privileges to launch the library but thereafter the pipe and socket commands may be issued by normal users. +.br + +.br +pigpiod accepts the following configuration options +.br + +.br +.SH OPTIONS + +.IP "\fB-a value\fP" +DMA memory allocation mode. +0=AUTO, 1=PMAP, 2=MBOX. +Default AUTO +. +.IP "\fB-b value\fP" +GPIO sample buffer size in milliseconds. +100-10000. +Default 120 +. +.IP "\fB-c value\fP" +Library internal settings. +. +Default 0 +. +.IP "\fB-d value\fP" +Primary DMA channel. +0-14. +Default 14 +. +.IP "\fB-e value\fP" +Secondary DMA channel. +0-14. +Default 6. Preferably use one of DMA channels 0 to 6 for the secondary channel +. +.IP "\fB-f\fP" +Disable fifo interface. +. +Default enabled +. +.IP "\fB-g\fP" +Run in foreground (do not fork). +. +Default disabled +. +.IP "\fB-k\fP" +Disable local and remote socket interface. +. +Default enabled +. +.IP "\fB-l\fP" +Disable remote socket interface. +. +Default enabled +. +.IP "\fB-m\fP" +Disable alerts (sampling). +. +Default enabled +. +.IP "\fB-n IP address\fP" +Allow IP address to use the socket interface. +Name (e.g. paul) or dotted quad (e.g. 192.168.1.66). +If the -n option is not used all addresses are allowed (unless overridden by the -k or -l options). Multiple -n options are allowed. If -k has been used -n has no effect. If -l has been used only -n localhost has any effect +. +.IP "\fB-p value\fP" +Socket port. +1024-32000. +Default 8888 +. +.IP "\fB-s value\fP" +Sample rate. +1, 2, 4, 5, 8, or 10 microseconds. +Default 5 +. +.IP "\fB-t value\fP" +Clock peripheral. +0=PWM 1=PCM. +Default PCM. pigpio uses one or both of PCM and PWM. If PCM is used then PWM is available for audio. If PWM is used then PCM is available for audio. If waves or hardware PWM are used neither PWM nor PCM will be available for audio. +. +.IP "\fB-v -V\fP" +Display pigpio version and exit. +. + +. +.IP "\fB-x mask\fP" +GPIO which may be updated. +A 54 bit mask with (1< +*/ + +/* +This version is for pigpio version 69+ +*/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" + +/* +This program starts the pigpio library as a daemon. +*/ + +static unsigned bufferSizeMilliseconds = PI_DEFAULT_BUFFER_MILLIS; +static unsigned clockMicros = PI_DEFAULT_CLK_MICROS; +static unsigned clockPeripheral = PI_DEFAULT_CLK_PERIPHERAL; +static unsigned ifFlags = PI_DEFAULT_IF_FLAGS; +static int foreground = PI_DEFAULT_FOREGROUND; +static unsigned DMAprimaryChannel = PI_DEFAULT_DMA_NOT_SET; +static unsigned DMAsecondaryChannel = PI_DEFAULT_DMA_NOT_SET; +static unsigned socketPort = PI_DEFAULT_SOCKET_PORT; +static unsigned memAllocMode = PI_DEFAULT_MEM_ALLOC_MODE; +static uint64_t updateMask = -1; + +static uint32_t cfgInternals = PI_DEFAULT_CFG_INTERNALS; + +static int updateMaskSet = 0; + +static FILE * errFifo; + +static uint32_t sockNetAddr[MAX_CONNECT_ADDRESSES]; + +static int numSockNetAddr = 0; + +void fatal(char *fmt, ...) +{ + char buf[128]; + va_list ap; + + va_start(ap, fmt); + vsnprintf(buf, sizeof(buf), fmt, ap); + va_end(ap); + + fprintf(stderr, "%s\n", buf); + + fflush(stderr); + + exit(EXIT_FAILURE); +} + +void usage() +{ + fprintf(stderr, "\n" \ + "pigpio V%d\n" \ + "Usage: sudo pigpiod [OPTION] ...\n" \ + " -a value, DMA mode, 0=AUTO, 1=PMAP, 2=MBOX, default AUTO\n" \ + " -b value, sample buffer size in ms, default 120\n" \ + " -c value, library internal settings, default 0\n" \ + " -d value, primary DMA channel, 0-14, default 14\n" \ + " -e value, secondary DMA channel, 0-14, default 6\n" \ + " -f, disable fifo interface, default enabled\n" \ + " -g, run in foreground (do not fork), default disabled\n" \ + " -k, disable socket interface, default enabled\n" \ + " -l, localhost socket only default local+remote\n" \ + " -m, disable alerts default enabled\n" \ + " -n IP addr, allow address, name or dotted, default allow all\n" \ + " -p value, socket port, 1024-32000, default 8888\n" \ + " -s value, sample rate, 1, 2, 4, 5, 8, or 10, default 5\n" \ + " -t value, clock peripheral, 0=PWM 1=PCM, default PCM\n" \ + " -v, -V, display pigpio version and exit\n" \ + " -x mask, GPIO which may be updated, default board GPIO\n" \ + "EXAMPLE\n" \ + "sudo pigpiod -s 2 -b 200 -f\n" \ + " Set a sample rate of 2 microseconds with a 200 millisecond\n" \ + " buffer. Disable the fifo interface.\n" \ + "\n", PIGPIO_VERSION); +} + +static uint64_t getNum(char *str, int *err) +{ + uint64_t val; + char *endptr; + + *err = 0; + val = strtoll(str, &endptr, 0); + if (*endptr) {*err = 1; val = -1;} + return val; +} + +static uint32_t checkAddr(char *addrStr) +{ + int err; + struct addrinfo hints, *res; + struct sockaddr_in *sin; + const char *portStr; + uint32_t addr; + + portStr = getenv(PI_ENVPORT); + + if (!portStr) portStr = PI_DEFAULT_SOCKET_PORT_STR; + + memset (&hints, 0, sizeof (hints)); + + hints.ai_family = AF_INET; + hints.ai_socktype = SOCK_STREAM; + hints.ai_flags |= AI_CANONNAME; + + err = getaddrinfo(addrStr, portStr, &hints, &res); + + if (err) return 0; + + sin = (struct sockaddr_in *)res->ai_addr; + addr = sin->sin_addr.s_addr; + + freeaddrinfo(res); + + return addr; +} + +static void initOpts(int argc, char *argv[]) +{ + int opt, err, i; + uint32_t addr; + int64_t mask; + + while ((opt = getopt(argc, argv, "a:b:c:d:e:fgkln:mp:s:t:x:vV")) != -1) + { + switch (opt) + { + case 'a': + i = getNum(optarg, &err); + if ((i >= PI_MEM_ALLOC_AUTO) && (i <= PI_MEM_ALLOC_MAILBOX)) + memAllocMode = i; + else fatal("invalid -a option (%d)", i); + break; + + case 'b': + i = getNum(optarg, &err); + if ((i >= PI_BUF_MILLIS_MIN) && (i <= PI_BUF_MILLIS_MAX)) + bufferSizeMilliseconds = i; + else fatal("invalid -b option (%d)", i); + break; + + case 'c': + i = getNum(optarg, &err); + if ((i >= 0) && (i < PI_CFG_ILLEGAL_VAL)) + cfgInternals = i; + else fatal("invalid -c option (%x)", i); + break; + + case 'd': + i = getNum(optarg, &err); + if ((i >= PI_MIN_DMA_CHANNEL) && (i <= PI_MAX_DMA_CHANNEL)) + DMAprimaryChannel = i; + else fatal("invalid -d option (%d)", i); + break; + + case 'e': + i = getNum(optarg, &err); + if ((i >= PI_MIN_DMA_CHANNEL) && (i <= PI_MAX_DMA_CHANNEL)) + DMAsecondaryChannel = i; + else fatal("invalid -e option (%d)", i); + break; + + case 'f': + ifFlags |= PI_DISABLE_FIFO_IF; + break; + + case 'g': + foreground = 1; + break; + + case 'k': + ifFlags |= PI_DISABLE_SOCK_IF; + break; + + case 'l': + ifFlags |= PI_LOCALHOST_SOCK_IF; + break; + + case 'm': + ifFlags |= PI_DISABLE_ALERT; + break; + + case 'n': + addr = checkAddr(optarg); + if (addr && (numSockNetAddr= PI_MIN_SOCKET_PORT) && (i <= PI_MAX_SOCKET_PORT)) + socketPort = i; + else fatal("invalid -p option (%d)", i); + break; + + case 's': + i = getNum(optarg, &err); + + switch(i) + { + case 1: + case 2: + case 4: + case 5: + case 8: + case 10: + clockMicros = i; + break; + + default: + fatal("invalid -s option (%d)", i); + break; + } + break; + + case 't': + i = getNum(optarg, &err); + if ((i >= PI_CLOCK_PWM) && (i <= PI_CLOCK_PCM)) + clockPeripheral = i; + else fatal("invalid -t option (%d)", i); + break; + + case 'v': + case 'V': + printf("%d\n", PIGPIO_VERSION); + exit(EXIT_SUCCESS); + break; + + case 'x': + mask = getNum(optarg, &err); + if (!err) + { + updateMask = mask; + updateMaskSet = 1; + } + else fatal("invalid -x option (%s)", optarg); + break; + + default: /* '?' */ + usage(); + exit(EXIT_FAILURE); + } + } +} + +void terminate(int signum) +{ + /* only registered for SIGHUP/SIGTERM */ + + gpioTerminate(); + + fprintf(errFifo, "SIGHUP/SIGTERM received\n"); + + fflush(NULL); + + fclose(errFifo); + + unlink(PI_ERRFIFO); + + exit(0); +} + + +int main(int argc, char **argv) +{ + pid_t pid; + int flags; + + /* check command line parameters */ + + initOpts(argc, argv); + + if (!foreground) { + /* Fork off the parent process */ + + pid = fork(); + + if (pid < 0) { exit(EXIT_FAILURE); } + + /* If we got a good PID, then we can exit the parent process. */ + + if (pid > 0) { exit(EXIT_SUCCESS); } + + /* Change the file mode mask */ + + umask(0); + + /* Open any logs here */ + + /* NONE */ + + /* Create a new SID for the child process */ + + if (setsid() < 0) fatal("setsid failed (%m)"); + + /* Change the current working directory */ + + if ((chdir("/")) < 0) fatal("chdir failed (%m)"); + + /* Close out the standard file descriptors */ + + fclose(stdin); + fclose(stdout); + } + + /* configure library */ + + gpioCfgBufferSize(bufferSizeMilliseconds); + + gpioCfgClock(clockMicros, clockPeripheral, 0); + + gpioCfgInterfaces(ifFlags); + + gpioCfgDMAchannels(DMAprimaryChannel, DMAsecondaryChannel); + + gpioCfgSocketPort(socketPort); + + gpioCfgMemAlloc(memAllocMode); + + if (updateMaskSet) gpioCfgPermissions(updateMask); + + gpioCfgNetAddr(numSockNetAddr, sockNetAddr); + + gpioCfgSetInternals(cfgInternals); + + /* start library */ + + if (gpioInitialise()< 0) fatal("Can't initialise pigpio library"); + + /* create pipe for error reporting */ + + unlink(PI_ERRFIFO); + + mkfifo(PI_ERRFIFO, 0664); + + if (chmod(PI_ERRFIFO, 0664) < 0) + fatal("chmod %s failed (%m)", PI_ERRFIFO); + + errFifo = freopen(PI_ERRFIFO, "w+", stderr); + + if (errFifo) + { + /* set stderr non-blocking */ + + flags = fcntl(fileno(errFifo), F_GETFL, 0); + fcntl(fileno(errFifo), F_SETFL, flags | O_NONBLOCK); + + /* request SIGHUP/SIGTERM from libarary for termination */ + + gpioSetSignalFunc(SIGHUP, terminate); + gpioSetSignalFunc(SIGTERM, terminate); + + /* sleep forever */ + + while (1) + { + /* cat /dev/pigerr to view daemon errors */ + + sleep(5); + + fflush(errFifo); + } + } + else + { + fprintf(stderr, "freopen failed (%m)"); + + gpioTerminate(); + } + + return 0; +} + + diff --git a/pigpio-master/pigpiod_if.3 b/pigpio-master/pigpiod_if.3 new file mode 100644 index 0000000..a0ec196 --- /dev/null +++ b/pigpio-master/pigpiod_if.3 @@ -0,0 +1,5339 @@ + +." Process this file with +." groff -man -Tascii pigpiod_if.3 +." +.TH pigpiod_if 3 2012-2020 Linux "pigpio archive" +.SH NAME +pigpiod_if - A C library to interface to the pigpio daemon. + +.SH SYNOPSIS + +#include + + +gcc -Wall -pthread -o prog prog.c -lpigpiod_if -lrt + + ./prog +.SH DESCRIPTION + + +.ad l + +.nh + +.br + +.br +THIS LIBRARY IS DEPRECATED. NEW CODE SHOULD BE WRITTEN TO +USE THE MORE VERSATILE pigpiod_if2 LIBRARY. + +.br + +.br +pigpiod_if is a C library for the Raspberry which allows control +of the GPIO via the socket interface to the pigpio daemon. +.br + +.br + +.br +.SS Features +.br + +.br +o hardware timed PWM on any of GPIO 0-31 + +.br + +.br +o hardware timed servo pulses on any of GPIO 0-31 + +.br + +.br +o callbacks when any of GPIO 0-31 change state + +.br + +.br +o callbacks at timed intervals + +.br + +.br +o reading/writing all of the GPIO in a bank as one operation + +.br + +.br +o individually setting GPIO modes, reading and writing + +.br + +.br +o notifications when any of GPIO 0-31 change state + +.br + +.br +o the construction of output waveforms with microsecond timing + +.br + +.br +o rudimentary permission control over GPIO + +.br + +.br +o a simple interface to start and stop new threads + +.br + +.br +o I2C, SPI, and serial link wrappers + +.br + +.br +o creating and running scripts on the pigpio daemon + +.br + +.br +.SS GPIO +.br + +.br +ALL GPIO are identified by their Broadcom number. + +.br + +.br +.SS Notes +.br + +.br +The PWM and servo pulses are timed using the DMA and PWM/PCM peripherals. + +.br + +.br +.SS Usage +.br + +.br +Include in your source files. + +.br + +.br +Assuming your source is in prog.c use the following command to build + +.br + +.br + +.EX +gcc -Wall -pthread -o prog prog.c -lpigpiod_if -lrt +.br + +.EE + +.br + +.br +to run make sure the pigpio daemon is running + +.br + +.br + +.EX +sudo pigpiod +.br + +.br + ./prog # sudo is not required to run programs linked to pigpiod_if +.br + +.EE + +.br + +.br +For examples see x_pigpiod_if.c within the pigpio archive file. + +.br + +.br +.SS Notes +.br + +.br +All the functions which return an int return < 0 on error + +.br + +.br + +.SH OVERVIEW + +.br +.SS ESSENTIAL +.br + +.br +pigpio_start Connects to the pigpio daemon +.br +pigpio_stop Disconnects from the pigpio daemon +.br +.SS BEGINNER +.br + +.br +set_mode Set a GPIO mode +.br +get_mode Get a GPIO mode +.br + +.br +set_pull_up_down Set/clear GPIO pull up/down resistor +.br + +.br +gpio_read Read a GPIO +.br +gpio_write Write a GPIO +.br + +.br +set_PWM_dutycycle Start/stop PWM pulses on a GPIO +.br +get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO +.br + +.br +set_servo_pulsewidth Start/stop servo pulses on a GPIO +.br +get_servo_pulsewidth Get the servo pulsewidth in use on a GPIO +.br + +.br +callback Create GPIO level change callback +.br +callback_ex Create GPIO level change callback +.br +callback_cancel Cancel a callback +.br +wait_for_edge Wait for GPIO level change +.br +.SS INTERMEDIATE +.br + +.br +gpio_trigger Send a trigger pulse to a GPIO. +.br + +.br +set_watchdog Set a watchdog on a GPIO. +.br + +.br +set_PWM_range Configure PWM range for a GPIO +.br +get_PWM_range Get configured PWM range for a GPIO +.br + +.br +set_PWM_frequency Configure PWM frequency for a GPIO +.br +get_PWM_frequency Get configured PWM frequency for a GPIO +.br + +.br +read_bank_1 Read all GPIO in bank 1 +.br +read_bank_2 Read all GPIO in bank 2 +.br + +.br +clear_bank_1 Clear selected GPIO in bank 1 +.br +clear_bank_2 Clear selected GPIO in bank 2 +.br + +.br +set_bank_1 Set selected GPIO in bank 1 +.br +set_bank_2 Set selected GPIO in bank 2 +.br + +.br +start_thread Start a new thread +.br +stop_thread Stop a previously started thread +.br +.SS ADVANCED +.br + +.br +get_PWM_real_range Get underlying PWM range for a GPIO +.br + +.br +notify_open Request a notification handle +.br +notify_begin Start notifications for selected GPIO +.br +notify_pause Pause notifications +.br +notify_close Close a notification +.br + +.br +bb_serial_read_open Opens a GPIO for bit bang serial reads +.br +bb_serial_read Reads bit bang serial data from a GPIO +.br +bb_serial_read_close Closes a GPIO for bit bang serial reads +.br +bb_serial_invert Invert serial logic (1 invert, 0 normal) +.br + +.br +hardware_clock Start hardware clock on supported GPIO +.br +hardware_PWM Start hardware PWM on supported GPIO +.br + +.br +set_glitch_filter Set a glitch filter on a GPIO +.br +set_noise_filter Set a noise filter on a GPIO +.br +.SS SCRIPTS +.br + +.br +store_script Store a script +.br +run_script Run a stored script +.br +script_status Get script status and parameters +.br +stop_script Stop a running script +.br +delete_script Delete a stored script +.br +.SS WAVES +.br + +.br +wave_clear Deletes all waveforms +.br + +.br +wave_add_new Starts a new waveform +.br +wave_add_generic Adds a series of pulses to the waveform +.br +wave_add_serial Adds serial data to the waveform +.br + +.br +wave_create Creates a waveform from added data +.br +wave_delete Deletes one or more waveforms +.br + +.br +wave_send_once Transmits a waveform once +.br +wave_send_repeat Transmits a waveform repeatedly +.br + +.br +wave_chain Transmits a chain of waveforms +.br + +.br +wave_tx_busy Checks to see if the waveform has ended +.br +wave_tx_stop Aborts the current waveform +.br + +.br +wave_get_micros Length in microseconds of the current waveform +.br +wave_get_high_micros Length of longest waveform so far +.br +wave_get_max_micros Absolute maximum allowed micros +.br + +.br +wave_get_pulses Length in pulses of the current waveform +.br +wave_get_high_pulses Length of longest waveform so far +.br +wave_get_max_pulses Absolute maximum allowed pulses +.br + +.br +wave_get_cbs Length in cbs of the current waveform +.br +wave_get_high_cbs Length of longest waveform so far +.br +wave_get_max_cbs Absolute maximum allowed cbs +.br +.SS I2C +.br + +.br +i2c_open Opens an I2C device +.br +i2c_close Closes an I2C device +.br + +.br +i2c_write_quick smbus write quick +.br +i2c_write_byte smbus write byte +.br +i2c_read_byte smbus read byte +.br +i2c_write_byte_data smbus write byte data +.br +i2c_write_word_data smbus write word data +.br +i2c_read_byte_data smbus read byte data +.br +i2c_read_word_data smbus read word data +.br +i2c_process_call smbus process call +.br +i2c_write_block_data smbus write block data +.br +i2c_read_block_data smbus read block data +.br +i2c_block_process_call smbus block process call +.br + +.br +i2c_write_i2c_block_data smbus write I2C block data +.br +i2c_read_i2c_block_data smbus read I2C block data +.br + +.br +i2c_read_device Reads the raw I2C device +.br +i2c_write_device Writes the raw I2C device +.br + +.br +i2c_zip Performs multiple I2C transactions +.br + +.br +bb_i2c_open Opens GPIO for bit banging I2C +.br +bb_i2c_close Closes GPIO for bit banging I2C +.br +bb_i2c_zip Performs multiple bit banged I2C transactions +.br +.SS SPI +.br + +.br +spi_open Opens a SPI device +.br +spi_close Closes a SPI device +.br + +.br +spi_read Reads bytes from a SPI device +.br +spi_write Writes bytes to a SPI device +.br +spi_xfer Transfers bytes with a SPI device +.br +.SS SERIAL +.br + +.br +serial_open Opens a serial device +.br +serial_close Closes a serial device +.br + +.br +serial_write_byte Writes a byte to a serial device +.br +serial_read_byte Reads a byte from a serial device +.br +serial_write Writes bytes to a serial device +.br +serial_read Reads bytes from a serial device +.br + +.br +serial_data_available Returns number of bytes ready to be read +.br +.SS CUSTOM +.br + +.br +custom_1 User custom function 1 +.br +custom_2 User custom function 2 +.br +.SS UTILITIES +.br + +.br +get_current_tick Get current tick (microseconds) +.br + +.br +get_hardware_revision Get hardware revision +.br +get_pigpio_version Get the pigpio version +.br +pigpiod_if_version Get the pigpiod_if version +.br + +.br +pigpio_error Get a text description of an error code. +.br + +.br +time_sleep Sleeps for a float number of seconds +.br +time_time Float number of seconds since the epoch +.br +.SH FUNCTIONS + +.IP "\fBdouble time_time(void)\fP" +.IP "" 4 +Return the current time in seconds since the Epoch. + +.IP "\fBvoid time_sleep(double seconds)\fP" +.IP "" 4 +Delay execution for a given number of seconds. + +.br + +.br + +.EX +seconds: the number of seconds to delay. +.br + +.EE + +.IP "\fBchar *pigpio_error(int errnum)\fP" +.IP "" 4 +Return a text description for an error code. + +.br + +.br + +.EX +errnum: the error code. +.br + +.EE + +.IP "\fBunsigned pigpiod_if_version(void)\fP" +.IP "" 4 +Return the pigpiod_if version. + +.IP "\fBpthread_t *start_thread(gpioThreadFunc_t thread_func, void *userdata)\fP" +.IP "" 4 +Starts a new thread of execution with thread_func as the main routine. + +.br + +.br + +.EX +thread_func: the main function for the new thread. +.br + userdata: a pointer to an arbitrary argument. +.br + +.EE + +.br + +.br +Returns a pointer to pthread_t if OK, otherwise NULL. + +.br + +.br +The function is passed the single argument userdata. + +.br + +.br +The thread can be cancelled by passing the pointer to pthread_t to +\fBstop_thread\fP. + +.IP "\fBvoid stop_thread(pthread_t *pth)\fP" +.IP "" 4 +Cancels the thread pointed at by pth. + +.br + +.br + +.EX +pth: the thread to be stopped. +.br + +.EE + +.br + +.br +No value is returned. + +.br + +.br +The thread to be stopped should have been started with \fBstart_thread\fP. + +.IP "\fBint pigpio_start(char *addrStr, char *portStr)\fP" +.IP "" 4 +Connect to the pigpio daemon. Reserving command and +notification streams. + +.br + +.br + +.EX +addrStr: specifies the host or IP address of the Pi running the +.br + pigpio daemon. It may be NULL in which case localhost +.br + is used unless overridden by the PIGPIO_ADDR environment +.br + variable. +.br + +.br +portStr: specifies the port address used by the Pi running the +.br + pigpio daemon. It may be NULL in which case "8888" +.br + is used unless overridden by the PIGPIO_PORT environment +.br + variable. +.br + +.EE + +.IP "\fBvoid pigpio_stop(void)\fP" +.IP "" 4 +Terminates the connection to the pigpio daemon and releases +resources used by the library. + +.IP "\fBint set_mode(unsigned gpio, unsigned mode)\fP" +.IP "" 4 +Set the GPIO mode. + +.br + +.br + +.EX +gpio: 0-53. +.br +mode: PI_INPUT, PI_OUTPUT, PI_ALT0, PI_ALT1, +.br + PI_ALT2, PI_ALT3, PI_ALT4, PI_ALT5. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_MODE, +or PI_NOT_PERMITTED. + +.IP "\fBint get_mode(unsigned gpio)\fP" +.IP "" 4 +Get the GPIO mode. + +.br + +.br + +.EX +gpio: 0-53. +.br + +.EE + +.br + +.br +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. + +.IP "\fBint set_pull_up_down(unsigned gpio, unsigned pud)\fP" +.IP "" 4 +Set or clear the GPIO pull-up/down resistor. + +.br + +.br + +.EX +gpio: 0-53. +.br + pud: PI_PUD_UP, PI_PUD_DOWN, PI_PUD_OFF. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_PUD, +or PI_NOT_PERMITTED. + +.IP "\fBint gpio_read(unsigned gpio)\fP" +.IP "" 4 +Read the GPIO level. + +.br + +.br + +.EX +gpio:0-53. +.br + +.EE + +.br + +.br +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. + +.IP "\fBint gpio_write(unsigned gpio, unsigned level)\fP" +.IP "" 4 +Write the GPIO level. + +.br + +.br + +.EX + gpio: 0-53. +.br +level: 0, 1. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_LEVEL, +or PI_NOT_PERMITTED. + +.br + +.br +Notes + +.br + +.br +If PWM or servo pulses are active on the GPIO they are switched off. + +.IP "\fBint set_PWM_dutycycle(unsigned user_gpio, unsigned dutycycle)\fP" +.IP "" 4 +Start (non-zero dutycycle) or stop (0) PWM pulses on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br +dutycycle: 0-range (range defaults to 255). +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYCYCLE, +or PI_NOT_PERMITTED. +Notes + +.br + +.br +The \fBset_PWM_range\fP function may be used to change the +default range of 255. + +.IP "\fBint get_PWM_dutycycle(unsigned user_gpio)\fP" +.IP "" 4 +Return the PWM dutycycle in use on a GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +.br + +.br +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see \fBget_PWM_range\fP). + +.br + +.br +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +.IP "\fBint set_PWM_range(unsigned user_gpio, unsigned range)\fP" +.IP "" 4 +Set the range of PWM values to be used on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + range: 25-40000. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYRANGE, +or PI_NOT_PERMITTED. + +.br + +.br +Notes + +.br + +.br +If PWM is currently active on the GPIO its dutycycle will be +scaled to reflect the new range. + +.br + +.br +The real range, the number of steps between fully off and fully on +for each of the 18 available GPIO frequencies is + +.br + +.br + +.EX + 25(#1), 50(#2), 100(#3), 125(#4), 200(#5), 250(#6), +.br + 400(#7), 500(#8), 625(#9), 800(#10), 1000(#11), 1250(#12), +.br +2000(#13), 2500(#14), 4000(#15), 5000(#16), 10000(#17), 20000(#18) +.br + +.EE + +.br + +.br +The real value set by set_PWM_range is (dutycycle * real range) / range. + +.IP "\fBint get_PWM_range(unsigned user_gpio)\fP" +.IP "" 4 +Get the range of PWM values being used on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns the dutycycle range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.br + +.br +If a hardware clock or hardware PWM is active on the GPIO the +reported range will be 1000000 (1M). + +.IP "\fBint get_PWM_real_range(unsigned user_gpio)\fP" +.IP "" 4 +Get the real underlying range of PWM values being used on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns the real range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.br + +.br +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +.br + +.br + +.IP "\fBint set_PWM_frequency(unsigned user_gpio, unsigned frequency)\fP" +.IP "" 4 +Set the frequency (in Hz) of the PWM to be used on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br +frequency: >=0 (Hz). +.br + +.EE + +.br + +.br +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PERMITTED. + +.br + +.br +If PWM is currently active on the GPIO it will be switched +off and then back on at the new frequency. + +.br + +.br +Each GPIO can be independently set to one of 18 different +PWM frequencies. + +.br + +.br +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +.br + +.br +The frequencies for each sample rate are: + +.br + +.br + +.EX + Hertz +.br + +.br + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 +.br + 1250 1000 800 500 400 250 200 100 50 +.br + +.br + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 +.br + 625 500 400 250 200 125 100 50 25 +.br + +.br + 4: 10000 5000 2500 2000 1250 1000 625 500 400 +.br + 313 250 200 125 100 63 50 25 13 +.br +sample +.br + rate +.br + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 +.br + 250 200 160 100 80 50 40 20 10 +.br + +.br + 8: 5000 2500 1250 1000 625 500 313 250 200 +.br + 156 125 100 63 50 31 25 13 6 +.br + +.br + 10: 4000 2000 1000 800 500 400 250 200 160 +.br + 125 100 80 50 40 25 20 10 5 +.br + +.EE + +.IP "\fBint get_PWM_frequency(unsigned user_gpio)\fP" +.IP "" 4 +Get the frequency of PWM being used on the GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + +.EE + +.br + +.br +For normal PWM the frequency will be that defined for the GPIO by +\fBset_PWM_frequency\fP. + +.br + +.br +If a hardware clock is active on the GPIO the reported frequency +will be that set by \fBhardware_clock\fP. + +.br + +.br +If hardware PWM is active on the GPIO the reported frequency +will be that set by \fBhardware_PWM\fP. + +.br + +.br +Returns the frequency (in hertz) used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.IP "\fBint set_servo_pulsewidth(unsigned user_gpio, unsigned pulsewidth)\fP" +.IP "" 4 +Start (500-2500) or stop (0) servo pulses on the GPIO. + +.br + +.br + +.EX + user_gpio: 0-31. +.br +pulsewidth: 0 (off), 500 (anti-clockwise) - 2500 (clockwise). +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_PULSEWIDTH or +PI_NOT_PERMITTED. + +.br + +.br +The selected pulsewidth will continue to be transmitted until +changed by a subsequent call to set_servo_pulsewidth. + +.br + +.br +The pulsewidths supported by servos varies and should probably be +determined by experiment. A value of 1500 should always be safe and +represents the mid-point of rotation. + +.br + +.br +You can DAMAGE a servo if you command it to move beyond its limits. + +.br + +.br +OTHER UPDATE RATES: + +.br + +.br +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +.br + +.br + +.EX +Update Rate (Hz) 50 100 200 400 500 +.br +1E6/Hz 20000 10000 5000 2500 2000 +.br + +.EE + +.br + +.br +Firstly set the desired PWM frequency using \fBset_PWM_frequency\fP. + +.br + +.br +Then set the PWM range using \fBset_PWM_range\fP to 1E6/Hz. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +.br + +.br +E.g. If you want to update a servo connected to GPIO 25 at 400Hz + +.br + +.br + +.EX +set_PWM_frequency(25, 400); +.br +set_PWM_range(25, 2500); +.br + +.EE + +.br + +.br +Thereafter use the \fBset_PWM_dutycycle\fP function to move the servo, +e.g. set_PWM_dutycycle(25, 1500) will set a 1500 us pulse. +.br + +.IP "\fBint get_servo_pulsewidth(unsigned user_gpio)\fP" +.IP "" 4 +Return the servo pulsewidth in use on a GPIO. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. + +.IP "\fBint notify_open(void)\fP" +.IP "" 4 +Get a free notification handle. + +.br + +.br +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +.br + +.br +A notification is a method for being notified of GPIO state +changes via a pipe. + +.br + +.br +Pipes are only accessible from the local machine so this function +serves no purpose if you are using the library from a remote machine. +The in-built (socket) notifications provided by \fBcallback\fP +should be used instead. + +.br + +.br +Notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). +E.g. if the function returns 15 then the notifications must be +read from /dev/pigpio15. + +.IP "\fBint notify_begin(unsigned handle, uint32_t bits)\fP" +.IP "" 4 +Start notifications on a previously opened handle. + +.br + +.br + +.EX +handle: 0-31 (as returned by \fBnotify_open\fP) +.br + bits: a mask indicating the GPIO to be notified. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +The notification sends state changes for each GPIO whose +corresponding bit in bits is set. + +.br + +.br +Each notification occupies 12 bytes in the fifo as follows: + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint16_t seqno; +.br + uint16_t flags; +.br + uint32_t tick; +.br + uint32_t level; +.br +} gpioReport_t; +.br + +.EE + +.br + +.br +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +.br + +.br +flags: two flags are defined, PI_NTFY_FLAGS_WDOG and PI_NTFY_FLAGS_ALIVE. + +.br + +.br +PI_NTFY_FLAGS_WDOG, if bit 5 is set then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +.br + +.br +PI_NTFY_FLAGS_ALIVE, if bit 6 is set this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +.br + +.br +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +.br + +.br +level: indicates the level of each GPIO. If bit 1<=0 +.br + numBytes: >=1 +.br + str: an array of chars. +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOP_BITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +.br + +.br +NOTES: + +.br + +.br +The serial data is formatted as one start bit, \fBdata_bits\fP data bits, +and \fBstop_bits\fP/2 stop bits. + +.br + +.br +It is legal to add serial data streams with different baud rates to +the same waveform. + +.br + +.br +\fBnumBytes\fP is the number of bytes of data in str. + +.br + +.br +The bytes required for each character depend upon \fBdata_bits\fP. + +.br + +.br +For \fBdata_bits\fP 1-8 there will be one byte per character. +.br +For \fBdata_bits\fP 9-16 there will be two bytes per character. +.br +For \fBdata_bits\fP 17-32 there will be four bytes per character. + +.IP "\fBint wave_create(void)\fP" +.IP "" 4 +This function creates a waveform from the data provided by the prior +calls to the \fBwave_add_*\fP functions. Upon success a wave id +greater than or equal to 0 is returned, otherwise PI_EMPTY_WAVEFORM, +PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + +.br + +.br +The data provided by the \fBwave_add_*\fP functions is consumed by this +function. + +.br + +.br +As many waveforms may be created as there is space available. The +wave id is passed to \fBwave_send_*\fP to specify the waveform to transmit. + +.br + +.br +Normal usage would be + +.br + +.br +Step 1. \fBwave_clear\fP to clear all waveforms and added data. + +.br + +.br +Step 2. \fBwave_add_*\fP calls to supply the waveform data. + +.br + +.br +Step 3. \fBwave_create\fP to create the waveform and get a unique id + +.br + +.br +Repeat steps 2 and 3 as needed. + +.br + +.br +Step 4. \fBwave_send_*\fP with the id of the waveform to transmit. + +.br + +.br +A waveform comprises one or more pulses. Each pulse consists of a +\fBgpioPulse_t\fP structure. + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint32_t gpioOn; +.br + uint32_t gpioOff; +.br + uint32_t usDelay; +.br +} gpioPulse_t; +.br + +.EE + +.br + +.br +The fields specify + +.br + +.br +1) the GPIO to be switched on at the start of the pulse. +.br +2) the GPIO to be switched off at the start of the pulse. +.br +3) the delay in microseconds before the next pulse. +.br + +.br + +.br +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +.br + +.br +When a waveform is started each pulse is executed in order with the +specified delay between the pulse and the next. + +.br + +.br +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. + +.IP "\fBint wave_delete(unsigned wave_id)\fP" +.IP "" 4 +This function deletes the waveform with id wave_id. + +.br + +.br + +.EX +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Wave ids are allocated in order, 0, 1, 2, etc. + +.br + +.br +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +.br + +.br +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +.br + +.br +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. + +.IP "\fBint wave_send_once(unsigned wave_id)\fP" +.IP "" 4 +This function transmits the waveform with id wave_id. The waveform +is sent once. + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br + +.EX +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint wave_send_repeat(unsigned wave_id)\fP" +.IP "" 4 +This function transmits the waveform with id wave_id. The waveform +cycles until cancelled (either by the sending of a new waveform or +by \fBwave_tx_stop\fP). + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br + +.EX +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint wave_chain(char *buf, unsigned bufSize)\fP" +.IP "" 4 +This function transmits a chain of waveforms. + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of \fBwave_id\fPs and optional command +codes and related data. + +.br + +.br + +.EX + buf: pointer to the wave_ids and optional command codes +.br +bufSize: the number of bytes in buf +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +.br + +.br +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +.br + +.br +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +.br + +.br +Delays between waves may be added with the delay command. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +Loop Start 255 0 Identify start of a wave block +.br +Loop Repeat 255 1 x y loop x + y*256 times +.br +Delay 255 2 x y delay x + y*256 microseconds +.br +Loop Forever 255 3 loop forever +.br + +.br + +.br +If present Loop Forever must be the last entry in the chain. + +.br + +.br +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +#define WAVES 5 +.br +#define GPIO 4 +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int i, wid[WAVES]; +.br + +.br + if (pigpio_start(0, 0)<0) return -1; +.br + +.br + set_mode(GPIO, PI_OUTPUT); +.br + +.br + for (i=0; i=0, as returned by \fBstore_script\fP. +.br + numPar: 0-10, the number of parameters. +.br + param: an array of parameters. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM + +.br + +.br +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. + +.IP "\fBint script_status(unsigned script_id, uint32_t *param)\fP" +.IP "" 4 +This function returns the run status of a stored script as well +as the current values of parameters 0 to 9. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBstore_script\fP. +.br + param: an array to hold the returned 10 parameters. +.br + +.EE + +.br + +.br +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +.br + +.br +The run status may be + +.br + +.br + +.EX +PI_SCRIPT_INITING +.br +PI_SCRIPT_HALTED +.br +PI_SCRIPT_RUNNING +.br +PI_SCRIPT_WAITING +.br +PI_SCRIPT_FAILED +.br + +.EE + +.br + +.br +The current value of script parameters 0 to 9 are returned in param. + +.IP "\fBint stop_script(unsigned script_id)\fP" +.IP "" 4 +This function stops a running script. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBstore_script\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint delete_script(unsigned script_id)\fP" +.IP "" 4 +This function deletes a stored script. + +.br + +.br + +.EX +script_id: >=0, as returned by \fBstore_script\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint bb_serial_read_open(unsigned user_gpio, unsigned baud, unsigned data_bits)\fP" +.IP "" 4 +This function opens a GPIO for bit bang reading of serial data. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + baud: 50-250000 +.br +data_bits: 1-32 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, +or PI_GPIO_IN_USE. + +.br + +.br +The serial data is returned in a cyclic buffer and is read using +bb_serial_read. + +.br + +.br +It is the caller's responsibility to read data from the cyclic buffer +in a timely fashion. + +.IP "\fBint bb_serial_read(unsigned user_gpio, void *buf, size_t bufSize)\fP" +.IP "" 4 +This function copies up to bufSize bytes of data read from the +bit bang serial cyclic buffer to the buffer starting at buf. + +.br + +.br + +.EX +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + buf: an array to receive the read bytes. +.br + bufSize: >=0 +.br + +.EE + +.br + +.br +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +.br + +.br +The bytes returned for each character depend upon the number of +data bits \fBdata_bits\fP specified in the \fBbb_serial_read_open\fP command. + +.br + +.br +For \fBdata_bits\fP 1-8 there will be one byte per character. +.br +For \fBdata_bits\fP 9-16 there will be two bytes per character. +.br +For \fBdata_bits\fP 17-32 there will be four bytes per character. + +.IP "\fBint bb_serial_read_close(unsigned user_gpio)\fP" +.IP "" 4 +This function closes a GPIO for bit bang reading of serial data. + +.br + +.br + +.EX +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. + +.IP "\fBint bb_serial_invert(unsigned user_gpio, unsigned invert)\fP" +.IP "" 4 +This function inverts serial logic for big bang serial reads. + +.br + +.br + +.EX +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + invert: 0-1, 1 invert, 0 normal. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_NOT_SERIAL_GPIO or PI_BAD_SER_INVERT. + +.IP "\fBint i2c_open(unsigned i2c_bus, unsigned i2c_addr, unsigned i2c_flags)\fP" +.IP "" 4 +This returns a handle for the device at address i2c_addr on bus i2c_bus. + +.br + +.br + +.EX + i2c_bus: >=0. +.br + i2c_addr: 0-0x7F. +.br +i2c_flags: 0. +.br + +.EE + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.br + +.br +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + SDA SCL +.br +I2C 0 0 1 +.br +I2C 1 2 3 +.br + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +.br + +.br +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +.br + +.br + +.EX +S (1 bit) : Start bit +.br +P (1 bit) : Stop bit +.br +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +.br +A, NA (1 bit) : Accept and not accept bit. +.br +.br +.br +Addr (7 bits): I2C 7 bit address. +.br +Comm (8 bits): Command byte, a data byte which often selects a register. +.br +Data (8 bits): A data byte. +.br +Count (8 bits): A data byte containing the length of a block operation. +.br + +.br +[..]: Data sent by the device. +.br + +.EE + +.IP "\fBint i2c_close(unsigned handle)\fP" +.IP "" 4 +This closes the I2C device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint i2c_write_quick(unsigned handle, unsigned bit)\fP" +.IP "" 4 +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + bit: 0-1, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Quick command. SMBus 2.0 5.5.1 + +.EX +S Addr Rd/Wr [A] P +.br + +.EE + +.IP "\fBint i2c_write_byte(unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This sends a single byte to the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + bVal: 0-0xFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Send byte. SMBus 2.0 5.5.2 + +.EX +S Addr Wr [A] Data [A] P +.br + +.EE + +.IP "\fBint i2c_read_byte(unsigned handle)\fP" +.IP "" 4 +This reads a single byte from the device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +.br + +.br +Receive byte. SMBus 2.0 5.5.3 + +.EX +S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2c_write_byte_data(unsigned handle, unsigned i2c_reg, unsigned bVal)\fP" +.IP "" 4 +This writes a single byte to the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + bVal: 0-0xFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write byte. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] Comm [A] Data [A] P +.br + +.EE + +.IP "\fBint i2c_write_word_data(unsigned handle, unsigned i2c_reg, unsigned wVal)\fP" +.IP "" 4 +This writes a single 16 bit word to the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + wVal: 0-0xFFFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write word. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] Comm [A] DataLow [A] DataHigh [A] P +.br + +.EE + +.IP "\fBint i2c_read_byte_data(unsigned handle, unsigned i2c_reg)\fP" +.IP "" 4 +This reads a single byte from the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read byte. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] Comm [A] S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2c_read_word_data(unsigned handle, unsigned i2c_reg)\fP" +.IP "" 4 +This reads a single 16 bit word from the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read word. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] Comm [A] S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2c_process_call(unsigned handle, unsigned i2c_reg, unsigned wVal)\fP" +.IP "" 4 +This writes 16 bits of data to the specified register of the device +associated with handle and and reads 16 bits of data in return. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write/read. +.br + wVal: 0-0xFFFF, the value to write. +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Process call. SMBus 2.0 5.5.6 + +.EX +S Addr Wr [A] Comm [A] DataLow [A] DataHigh [A] +.br + S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2c_write_block_data(unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes up to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + buf: an array with the data to send. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Block write. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] Comm [A] Count [A] Data [A] Data [A] ... [A] Data [A] P +.br + +.EE + +.IP "\fBint i2c_read_block_data(unsigned handle, unsigned i2c_reg, char *buf)\fP" +.IP "" 4 +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + buf: an array to receive the read data. +.br + +.EE + +.br + +.br +The amount of returned data is set by the device. + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Block read. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] Comm [A] +.br + S Addr Rd [A] [Count] A [Data] A [Data] A ... A [Data] NA P +.br + +.EE + +.IP "\fBint i2c_block_process_call(unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write/read. +.br + buf: an array with the data to send and to receive the read data. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +The smbus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +.br + +.br +Block write-block read. SMBus 2.0 5.5.8 + +.EX +S Addr Wr [A] Comm [A] Count [A] Data [A] ... +.br + S Addr Rd [A] [Count] A [Data] ... A P +.br + +.EE + +.IP "\fBint i2c_read_i2c_block_data(unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + buf: an array to receive the read data. +.br + count: 1-32, the number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] Comm [A] +.br + S Addr Rd [A] [Data] A [Data] A ... A [Data] NA P +.br + +.EE + +.IP "\fBint i2c_write_i2c_block_data(unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + buf: the data to write. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] Comm [A] Data [A] Data [A] ... [A] Data [A] P +.br + +.EE + +.IP "\fBint i2c_read_device(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the raw device into buf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + buf: an array to receive the read data bytes. +.br + count: >0, the number of bytes to read. +.br + +.EE + +.br + +.br +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. + +.IP "\fBint i2c_write_device(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This writes count bytes from buf to the raw device. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + buf: an array containing the data bytes to write. +.br + count: >0, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.IP "\fBint i2c_zip(unsigned handle, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +On 2 Switch combined flag on +.br +Off 3 Switch combined flag off +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53, write 0x32, read 6 bytes +.br +Set address 0x1E, write 0x03, read 6 bytes +.br +Set address 0x68, write 0x1B, read 8 bytes +.br +End +.br + +.br +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +.br +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +.br +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +.br +0x00 +.br + +.EE + +.br + +.br + +.IP "\fBint bb_i2c_open(unsigned SDA, unsigned SCL, unsigned baud)\fP" +.IP "" 4 +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +.br + +.br +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +.br + +.br +o baud rates as low as 50 +.br +o repeated starts +.br +o clock stretching +.br +o I2C on any pair of spare GPIO + +.br + +.br + +.EX + SDA: 0-31 +.br + SCL: 0-31 +.br +baud: 50-500000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +.br + +.br +NOTE: + +.br + +.br +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + +.IP "\fBint bb_i2c_close(unsigned SDA)\fP" +.IP "" 4 +This function stops bit banging I2C on a pair of GPIO previously +opened with \fBbb_i2c_open\fP. + +.br + +.br + +.EX +SDA: 0-31, the SDA GPIO used in a prior call to \fBbb_i2c_open\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. + +.IP "\fBint bb_i2c_zip(unsigned SDA, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX + SDA: 0-31 (as used in a prior call to \fBbb_i2c_open\fP) +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +Start 2 Start condition +.br +Stop 3 Stop condition +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +.br + +.br +No flags are currently defined. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53 +.br +start, write 0x32, (re)start, read 6 bytes, stop +.br +Set address 0x1E +.br +start, write 0x03, (re)start, read 6 bytes, stop +.br +Set address 0x68 +.br +start, write 0x1B, (re)start, read 8 bytes, stop +.br +End +.br + +.br +0x04 0x53 +.br +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x1E +.br +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x68 +.br +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 +.br + +.br +0x00 +.br + +.EE + +.IP "\fBint spi_open(unsigned spi_channel, unsigned baud, unsigned spi_flags)\fP" +.IP "" 4 +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +.br + +.br +The Pi has two SPI peripherals: main and auxiliary. + +.br + +.br +The main SPI has two chip selects (channels), the auxiliary has +three. + +.br + +.br +The auxiliary SPI is available on all models but the A and B. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + MISO MOSI SCLK CE0 CE1 CE2 +.br +Main SPI 9 10 11 8 7 - +.br +Aux SPI 19 20 21 18 17 16 +.br + +.br + +.br + +.EX +spi_channel: 0-1 (0-2 for the auxiliary SPI). +.br + baud: 32K-125M (values above 30M are unlikely to work). +.br + spi_flags: see below. +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +.br + +.br +spi_flags consists of the least significant 22 bits. + +.br + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +.br + +.EE + +.br + +.br +mm defines the SPI mode. + +.br + +.br +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +.br + +.br + +.EX +Mode POL PHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br + +.br +px is 0 if CEx is active low (default) and 1 for active high. + +.br + +.br +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +.br + +.br +A is 0 for the main SPI, 1 for the auxiliary SPI. + +.br + +.br +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +.br + +.br +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +.br + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +.br + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +.br + +.br +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +.br + +.br +The \fBspi_read\fP, \fBspi_write\fP, and \fBspi_xfer\fP functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +.br + +.br +For bits 1-8 there will be one byte per word. +.br +For bits 9-16 there will be two bytes per word. +.br +For bits 17-32 there will be four bytes per word. + +.br + +.br +Multi-byte transfers are made in least significant byte first order. + +.br + +.br +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +.br + +.br +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +.br + +.br +The other bits in flags should be set to zero. + +.IP "\fBint spi_close(unsigned handle)\fP" +.IP "" 4 +This functions closes the SPI device identified by the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint spi_read(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads count bytes of data from the SPI +device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + buf: an array to receive the read data bytes. +.br + count: the number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spi_write(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + buf: the data bytes to write. +.br + count: the number of bytes to write. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spi_xfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count)\fP" +.IP "" 4 +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + txBuf: the data bytes to write. +.br + rxBuf: the received data bytes. +.br + count: the number of bytes to transfer. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint serial_open(char *ser_tty, unsigned baud, unsigned ser_flags)\fP" +.IP "" 4 +This function opens a serial device at a specified baud rate +with specified flags. The device name must start with +/dev/tty or /dev/serial. + +.br + +.br + +.EX + ser_tty: the serial device to open. +.br + baud: the baud rate in bits per second, see below. +.br +ser_flags: 0. +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +.br + +.br +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.IP "\fBint serial_close(unsigned handle)\fP" +.IP "" 4 +This function closes the serial device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint serial_write_byte(unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This function writes bVal to the serial port associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serial_read_byte(unsigned handle)\fP" +.IP "" 4 +This function reads a byte from the serial port associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +.br + +.br +If no data is ready PI_SER_READ_NO_DATA is returned. + +.IP "\fBint serial_write(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes from buf to the the serial port +associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + buf: the array of bytes to write. +.br + count: the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serial_read(unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads up to count bytes from the the serial port +associated with handle and writes them to buf. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + buf: an array to receive the read data. +.br + count: the maximum number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, PI_SER_READ_NO_DATA, or PI_SER_WRITE_FAILED. + +.br + +.br +If no data is ready zero is returned. + +.IP "\fBint serial_data_available(unsigned handle)\fP" +.IP "" 4 +Returns the number of bytes available to be read from the +device associated with handle. + +.br + +.br + +.EX +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. + +.IP "\fBint custom_1(unsigned arg1, unsigned arg2, char *argx, unsigned argc)\fP" +.IP "" 4 +This function is available for user customisation. + +.br + +.br +It returns a single integer value. + +.br + +.br + +.EX +arg1: >=0 +.br +arg2: >=0 +.br +argx: extra (byte) arguments +.br +argc: number of extra arguments +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.IP "\fBint custom_2(unsigned arg1, char *argx, unsigned argc, char *retBuf, unsigned retMax)\fP" +.IP "" 4 +This function is available for user customisation. + +.br + +.br +It differs from custom_1 in that it returns an array of bytes +rather than just an integer. + +.br + +.br +The return value is an integer indicating the number of returned bytes. + +.EX + arg1: >=0 +.br + argc: extra (byte) arguments +.br + count: number of extra arguments +.br +retBuf: buffer for returned data +.br +retMax: maximum number of bytes to return +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.br + +.br +Note, the number of returned bytes will be retMax or less. + +.IP "\fBint callback(unsigned user_gpio, unsigned edge, CBFunc_t f)\fP" +.IP "" 4 +This function initialises a new callback. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + f: the callback function. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the GPIO, edge, and tick, whenever the +GPIO has the identified edge. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +edge 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.EE + +.IP "\fBint callback_ex(unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *userdata)\fP" +.IP "" 4 +This function initialises a new callback. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + f: the callback function. +.br + userdata: a pointer to arbitrary user data. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the GPIO, edge, tick, and user, whenever +the GPIO has the identified edge. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +edge 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.br +userdata pointer Pointer to an arbitrary object +.br + +.EE + +.IP "\fBint callback_cancel(unsigned callback_id)\fP" +.IP "" 4 +This function cancels a callback identified by its id. + +.br + +.br + +.EX +callback_id: >=0, as returned by a call to \fBcallback\fP or \fBcallback_ex\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise pigif_callback_not_found. + +.IP "\fBint wait_for_edge(unsigned user_gpio, unsigned edge, double timeout)\fP" +.IP "" 4 +This function waits for edge on the GPIO for up to timeout +seconds. + +.br + +.br + +.EX +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + timeout: >=0. +.br + +.EE + +.br + +.br +The function returns 1 if the edge occurred, otherwise 0. + +.br + +.br +The function returns when the edge occurs or after the timeout. +.SH PARAMETERS + +.br + +.br + +.IP "\fBactive\fP: 0-1000000" 0 + +.br + +.br +The number of microseconds level changes are reported for once +a noise filter has been triggered (by \fBsteady\fP microseconds of +a stable level). + +.br + +.br + +.IP "\fB*addrStr\fP" 0 +A string specifying the host or IP address of the Pi running +the pigpio daemon. It may be NULL in which case localhost +is used unless overridden by the PIGPIO_ADDR environment +variable. + +.br + +.br + +.IP "\fBarg1\fP" 0 +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBarg2\fP" 0 +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBargc\fP" 0 +The count of bytes passed to a user customised function. + +.br + +.br + +.IP "\fB*argx\fP" 0 +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +.br + +.br + +.IP "\fBbaud\fP" 0 +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +.br + +.br + +.IP "\fBbit\fP" 0 +A value of 0 or 1. + +.br + +.br + +.IP "\fBbits\fP" 0 +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +.br + +.br +A convenient way to set bit n is to or in (1<=0, as returned by a call to \fBcallback\fP or \fBcallback_ex\fP. This is +passed to \fBcallback_cancel\fP to cancel the callback. + +.br + +.br + +.IP "\fBCBFunc_t\fP" 0 + +.EX +typedef void (*CBFunc_t) +.br + (unsigned user_gpio, unsigned level, uint32_t tick); +.br + +.EE + +.br + +.br + +.IP "\fBCBFuncEx_t\fP" 0 + +.EX +typedef void (*CBFuncEx_t) +.br + (unsigned user_gpio, unsigned level, uint32_t tick, void * user); +.br + +.EE + +.br + +.br + +.IP "\fBchar\fP" 0 +A single character, an 8 bit quantity able to store 0-255. + +.br + +.br + +.IP "\fBclkfreq\fP: 4689-250000000 (250M)" 0 +The hardware clock frequency. + +.br + +.br + +.IP "\fBcount\fP" 0 +The number of bytes to be transferred in an I2C, SPI, or Serial +command. + +.br + +.br + +.IP "\fBdata_bits\fP: 1-32" 0 +The number of data bits in each character of serial data. + +.br + +.br + +.EX +#define PI_MIN_WAVE_DATABITS 1 +.br +#define PI_MAX_WAVE_DATABITS 32 +.br + +.EE + +.br + +.br + +.IP "\fBdouble\fP" 0 +A floating point number. + +.br + +.br + +.IP "\fBdutycycle\fP: 0-range" 0 +A number representing the ratio of on time to off time for PWM. + +.br + +.br +The number may vary between 0 and range (default 255) where +0 is off and range is fully on. + +.br + +.br + +.IP "\fBedge\fP" 0 +Used to identify a GPIO level transition of interest. A rising edge is +a level change from 0 to 1. A falling edge is a level change from 1 to 0. + +.br + +.br + +.EX +RISING_EDGE 0 +.br +FALLING_EDGE 1 +.br +EITHER_EDGE. 2 +.br + +.EE + +.br + +.br + +.IP "\fBerrnum\fP" 0 +A negative number indicating a function call failed and the nature +of the error. + +.br + +.br + +.IP "\fBf\fP" 0 +A function. + +.br + +.br + +.IP "\fBfrequency\fP: >=0" 0 +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + +.br + +.br + +.br + +.br + +.IP "\fBgpio\fP" 0 +A Broadcom numbered GPIO, in the range 0-53. + +.br + +.br +There are 54 General Purpose Input Outputs (GPIO) named gpio0 through +gpio53. + +.br + +.br +They are split into two banks. Bank 1 consists of gpio0 through +gpio31. Bank 2 consists of gpio32 through gpio53. + +.br + +.br +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +.br + +.br +See \fBget_hardware_revision\fP. + +.br + +.br +The user GPIO are marked with an X in the following table. + +.br + +.br + +.EX + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +.br +Type 1 X X - - X - - X X X X X - - X X +.br +Type 2 - - X X X - - X X X X X - - X X +.br +Type 3 X X X X X X X X X X X X X X +.br + +.br + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +.br +Type 1 - X X - - X X X X X - - - - - - +.br +Type 2 - X X - - - X X X X - X X X X X +.br +Type 3 X X X X X X X X X X X X - - - - +.br + +.EE + +.br + +.br + +.IP "\fBgpioPulse_t\fP" 0 + +.EX +typedef struct +.br +{ +.br +uint32_t gpioOn; +.br +uint32_t gpioOff; +.br +uint32_t usDelay; +.br +} gpioPulse_t; +.br + +.EE + +.br + +.br + +.IP "\fBgpioThreadFunc_t\fP" 0 + +.EX +typedef void *(gpioThreadFunc_t) (void *); +.br + +.EE + +.br + +.br + +.IP "\fBhandle\fP: >=0" 0 +A number referencing an object opened by one of \fBi2c_open\fP, \fBnotify_open\fP, +\fBserial_open\fP, and \fBspi_open\fP. + +.br + +.br + +.IP "\fBi2c_addr\fP: 0-0x7F" 0 +The address of a device on the I2C bus. + +.br + +.br + +.IP "\fBi2c_bus\fP: >=0" 0 +An I2C bus number. + +.br + +.br + +.IP "\fBi2c_flags\fP: 0" 0 +Flags which modify an I2C open command. None are currently defined. + +.br + +.br + +.IP "\fBi2c_reg\fP: 0-255" 0 +A register of an I2C device. + +.br + +.br + +.IP "\fB*inBuf\fP" 0 +A buffer used to pass data to a function. + +.br + +.br + +.IP "\fBinLen\fP" 0 +The number of bytes of data in a buffer. + +.br + +.br + +.IP "\fBint\fP" 0 +A whole number, negative or positive. + +.br + +.br + +.IP "\fBinvert\fP" 0 +A flag used to set normal or inverted bit bang serial data level logic. + +.br + +.br + +.IP "\fBlevel\fP" 0 +The level of a GPIO. Low or High. + +.br + +.br + +.EX +PI_OFF 0 +.br +PI_ON 1 +.br + +.br +PI_CLEAR 0 +.br +PI_SET 1 +.br + +.br +PI_LOW 0 +.br +PI_HIGH 1 +.br + +.EE + +.br + +.br +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See \fBset_watchdog\fP. + +.br + +.br + +.EX +PI_TIMEOUT 2 +.br + +.EE + +.br + +.br + +.IP "\fBmode\fP: 0-7" 0 +The operational mode of a GPIO, normally INPUT or OUTPUT. + +.br + +.br + +.EX +PI_INPUT 0 +.br +PI_OUTPUT 1 +.br +PI_ALT0 4 +.br +PI_ALT1 5 +.br +PI_ALT2 6 +.br +PI_ALT3 7 +.br +PI_ALT4 3 +.br +PI_ALT5 2 +.br + +.EE + +.br + +.br + +.IP "\fBnumBytes\fP" 0 +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +.br + +.br + +.IP "\fBnumPar\fP: 0-10" 0 +The number of parameters passed to a script. + +.br + +.br + +.IP "\fBnumPulses\fP" 0 +The number of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBoffset\fP" 0 +The associated data starts this number of microseconds from the start of +the waveform. + +.br + +.br + +.IP "\fB*outBuf\fP" 0 +A buffer used to return data from a function. + +.br + +.br + +.IP "\fBoutLen\fP" 0 +The size in bytes of an output buffer. + +.br + +.br + +.IP "\fB*param\fP" 0 +An array of script parameters. + +.br + +.br + +.IP "\fB*portStr\fP" 0 +A string specifying the port address used by the Pi running +the pigpio daemon. It may be NULL in which case "8888" +is used unless overridden by the PIGPIO_PORT environment +variable. + +.br + +.br + +.IP "\fB*pth\fP" 0 +A thread identifier, returned by \fBstart_thread\fP. + +.br + +.br + +.br + +.br + +.IP "\fBpthread_t\fP" 0 +A thread identifier. + +.br + +.br + +.IP "\fBpud\fP: 0-2" 0 +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. + +.EX +PI_PUD_OFF 0 +.br +PI_PUD_DOWN 1 +.br +PI_PUD_UP 2 +.br + +.EE + +.br + +.br + +.IP "\fBpulseLen\fP" 0 +1-100, the length of a trigger pulse in microseconds. + +.br + +.br + +.IP "\fB*pulses\fP" 0 +An array of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBpulsewidth\fP: 0, 500-2500" 0 + +.EX +PI_SERVO_OFF 0 +.br +PI_MIN_SERVO_PULSEWIDTH 500 +.br +PI_MAX_SERVO_PULSEWIDTH 2500 +.br + +.EE + +.br + +.br + +.IP "\fBPWMduty\fP: 0-1000000 (1M)" 0 +The hardware PWM dutycycle. + +.br + +.br + +.EX +#define PI_HW_PWM_RANGE 1000000 +.br + +.EE + +.br + +.br + +.IP "\fBPWMfreq\fP: 1-125000000 (125M)" 0 +The hardware PWM frequency. + +.br + +.br + +.EX +#define PI_HW_PWM_MIN_FREQ 1 +.br +#define PI_HW_PWM_MAX_FREQ 125000000 +.br + +.EE + +.br + +.br + +.IP "\fBrange\fP: 25-40000" 0 +The permissible dutycycle values are 0-range. + +.EX +PI_MIN_DUTYCYCLE_RANGE 25 +.br +PI_MAX_DUTYCYCLE_RANGE 40000 +.br + +.EE + +.br + +.br + +.IP "\fB*retBuf\fP" 0 +A buffer to hold a number of bytes returned to a used customised function, + +.br + +.br + +.IP "\fBretMax\fP" 0 +The maximum number of bytes a user customised function should return. + +.br + +.br + +.br + +.br + +.IP "\fB*rxBuf\fP" 0 +A pointer to a buffer to receive data. + +.br + +.br + +.IP "\fBSCL\fP" 0 +The user GPIO to use for the clock when bit banging I2C. + +.br + +.br + +.IP "\fB*script\fP" 0 +A pointer to the text of a script. + +.br + +.br + +.IP "\fBscript_id\fP" 0 +An id of a stored script as returned by \fBstore_script\fP. + +.br + +.br + +.IP "\fBSDA\fP" 0 +The user GPIO to use for data when bit banging I2C. + +.br + +.br + +.IP "\fBseconds\fP" 0 +The number of seconds. + +.br + +.br + +.IP "\fBser_flags\fP" 0 +Flags which modify a serial open command. None are currently defined. + +.br + +.br + +.IP "\fB*ser_tty\fP" 0 +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +.br + +.br + +.IP "\fBsize_t\fP" 0 +A standard type used to indicate the size of an object in bytes. + +.br + +.br + +.IP "\fBspi_channel\fP" 0 +A SPI channel, 0-2. + +.br + +.br + +.IP "\fBspi_flags\fP" 0 +See \fBspi_open\fP. + +.br + +.br + +.IP "\fBsteady\fP: 0-300000" 0 + +.br + +.br +The number of microseconds level changes must be stable for +before reporting the level changed (\fBset_glitch_filter\fP) or triggering +the active part of a noise filter (\fBset_noise_filter\fP). + +.br + +.br + +.IP "\fBstop_bits\fP: 2-8" 0 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +.br + +.br + +.EX +#define PI_MIN_WAVE_HALFSTOPBITS 2 +.br +#define PI_MAX_WAVE_HALFSTOPBITS 8 +.br + +.EE + +.br + +.br + +.IP "\fB*str\fP" 0 + An array of characters. + +.br + +.br + +.IP "\fBthread_func\fP" 0 +A function of type gpioThreadFunc_t used as the main function of a +thread. + +.br + +.br + +.IP "\fBtimeout\fP" 0 +A GPIO watchdog timeout in milliseconds. + +.EX +PI_MIN_WDOG_TIMEOUT 0 +.br +PI_MAX_WDOG_TIMEOUT 60000 +.br + +.EE + +.br + +.br + +.IP "\fB*txBuf\fP" 0 +An array of bytes to transmit. + +.br + +.br + +.IP "\fBuint32_t\fP: 0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF)" 0 +A 32-bit unsigned value. + +.br + +.br + +.IP "\fBunsigned\fP" 0 +A whole number >= 0. + +.br + +.br + +.IP "\fBuser_gpio\fP" 0 +0-31, a Broadcom numbered GPIO. + +.br + +.br +See \fBgpio\fP. + +.br + +.br + +.IP "\fB*userdata\fP" 0 +A pointer to arbitrary user data. This may be used to identify the instance. + +.br + +.br + +.IP "\fBvoid\fP" 0 +Denoting no parameter is required + +.br + +.br + +.IP "\fBwave_add_*\fP" 0 +One of \fBwave_add_new\fP, \fBwave_add_generic\fP, \fBwave_add_serial\fP. + +.br + +.br + +.IP "\fBwave_id\fP" 0 +A number representing a waveform created by \fBwave_create\fP. + +.br + +.br + +.IP "\fBwave_send_*\fP" 0 +One of \fBwave_send_once\fP, \fBwave_send_repeat\fP. + +.br + +.br + +.IP "\fBwVal\fP: 0-65535 (Hex 0x0-0xFFFF, Octal 0-0177777)" 0 +A 16-bit word value. + +.br + +.br +.SH pigpiod_if Error Codes + +.EX + +.br +typedef enum +.br +{ +.br + pigif_bad_send = -2000, +.br + pigif_bad_recv = -2001, +.br + pigif_bad_getaddrinfo = -2002, +.br + pigif_bad_connect = -2003, +.br + pigif_bad_socket = -2004, +.br + pigif_bad_noib = -2005, +.br + pigif_duplicate_callback = -2006, +.br + pigif_bad_malloc = -2007, +.br + pigif_bad_callback = -2008, +.br + pigif_notify_failed = -2009, +.br + pigif_callback_not_found = -2010, +.br +} pigifError_t; +.br + +.br + +.EE + +.SH SEE ALSO + +pigpiod(1), pig2vcd(1), pigs(1), pigpio(3), pigpiod_if2(3) +.SH AUTHOR + +joan@abyz.me.uk diff --git a/pigpio-master/pigpiod_if.c b/pigpio-master/pigpiod_if.c new file mode 100644 index 0000000..c62b3e8 --- /dev/null +++ b/pigpio-master/pigpiod_if.c @@ -0,0 +1,1572 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* PIGPIOD_IF_VERSION 27 */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include + +#include + +#include "pigpio.h" +#include "command.h" + +#include "pigpiod_if.h" + +#define PISCOPE_MAX_REPORTS_PER_READ 4096 + +#define STACK_SIZE (256*1024) + +typedef void (*CBF_t) (); + +struct callback_s +{ + + int id; + int gpio; + int edge; + CBF_t f; + void * user; + int ex; + callback_t *prev; + callback_t *next; +}; + +/* GLOBALS ---------------------------------------------------------------- */ + +static gpioReport_t gReport[PISCOPE_MAX_REPORTS_PER_READ]; + +static int gPigCommand = -1; +static int gPigHandle = -1; +static int gPigNotify = -1; + +static uint32_t gNotifyBits; +static uint32_t gLastLevel; + +callback_t *gCallBackFirst = 0; +callback_t *gCallBackLast = 0; + +static int gPigStarted = 0; + +static pthread_t *pthNotify; + +static pthread_mutex_t command_mutex = PTHREAD_MUTEX_INITIALIZER; + +/* PRIVATE ---------------------------------------------------------------- */ + +static int pigpio_command(int fd, int command, int p1, int p2, int rl) +{ + cmdCmd_t cmd; + + cmd.cmd = command; + cmd.p1 = p1; + cmd.p2 = p2; + cmd.res = 0; + + pthread_mutex_lock(&command_mutex); + + if (send(fd, &cmd, sizeof(cmd), 0) != sizeof(cmd)) + { + pthread_mutex_unlock(&command_mutex); + return pigif_bad_send; + } + + if (recv(fd, &cmd, sizeof(cmd), MSG_WAITALL) != sizeof(cmd)) + { + pthread_mutex_unlock(&command_mutex); + return pigif_bad_recv; + } + + if (rl) pthread_mutex_unlock(&command_mutex); + + return cmd.res; +} + +static int pigpio_command_ext + (int fd, int command, int p1, int p2, int p3, + int extents, gpioExtent_t *ext, int rl) +{ + int i; + cmdCmd_t cmd; + + cmd.cmd = command; + cmd.p1 = p1; + cmd.p2 = p2; + cmd.p3 = p3; + + pthread_mutex_lock(&command_mutex); + + if (send(fd, &cmd, sizeof(cmd), 0) != sizeof(cmd)) + { + pthread_mutex_unlock(&command_mutex); + return pigif_bad_send; + } + + for (i=0; iai_next) + { + sock = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); + + if (sock == -1) continue; + + /* Disable the Nagle algorithm. */ + opt = 1; + setsockopt(sock, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, sizeof(int)); + + if (connect(sock, rp->ai_addr, rp->ai_addrlen) != -1) break; + } + + freeaddrinfo(res); + + if (rp == NULL) return pigif_bad_connect; + + return sock; +} + +static void dispatch_notification(gpioReport_t *r) +{ + callback_t *p; + uint32_t changed; + int l, g; + + /* + printf("s=%d f=%d l=%8X, t=%10u\n", + r->seqno, r->flags, r->level, r->tick); + */ + + if (r->flags == 0) + { + changed = (r->level ^ gLastLevel) & gNotifyBits; + + gLastLevel = r->level; + + p = gCallBackFirst; + + while (p) + { + if (changed & (1<<(p->gpio))) + { + if ((r->level) & (1<<(p->gpio))) l = 1; else l = 0; + if ((p->edge) ^ l) + { + if (p->ex) (p->f)(p->gpio, l, r->tick, p->user); + else (p->f)(p->gpio, l, r->tick); + } + } + p = p->next; + } + } + else + { + g = (r->flags) & 31; + + p = gCallBackFirst; + + while (p) + { + if ((p->gpio) == g) + { + if (p->ex) (p->f)(g, PI_TIMEOUT, r->tick, p->user); + else (p->f)(g, PI_TIMEOUT, r->tick); + } + p = p->next; + } + } +} + +static void *pthNotifyThread(void *x) +{ + static int got = 0; + + int bytes, r; + + while (1) + { + bytes = read(gPigNotify, (char*)&gReport+got, sizeof(gReport)-got); + + if (bytes > 0) got += bytes; + else break; + + r = 0; + + while (got >= sizeof(gpioReport_t)) + { + dispatch_notification(&gReport[r]); + + r++; + + got -= sizeof(gpioReport_t); + } + + /* copy any partial report to start of array */ + + if (got && r) gReport[0] = gReport[r]; + } + return 0; +} + +static void findNotifyBits(void) +{ + callback_t *p; + uint32_t bits = 0; + + p = gCallBackFirst; + + while (p) + { + bits |= (1<<(p->gpio)); + p = p->next; + } + + if (bits != gNotifyBits) + { + gNotifyBits = bits; + pigpio_command(gPigCommand, PI_CMD_NB, gPigHandle, gNotifyBits, 1); + } +} + +static void _wfe(unsigned user_gpio, unsigned level, uint32_t tick, void *user) +{ + *(int *)user = 1; +} + +static int intCallback(unsigned user_gpio, unsigned edge, void *f, void *user, int ex) +{ + static int id = 0; + callback_t *p; + + if ((user_gpio >=0) && (user_gpio < 32) && (edge >=0) && (edge <= 2) && f) + { + /* prevent duplicates */ + + p = gCallBackFirst; + + while (p) + { + if ((p->gpio == user_gpio) && (p->edge == edge) && (p->f == f)) + { + return pigif_duplicate_callback; + } + p = p->next; + } + + p = malloc(sizeof(callback_t)); + + if (p) + { + if (!gCallBackFirst) gCallBackFirst = p; + + p->id = id++; + p->gpio = user_gpio; + p->edge = edge; + p->f = f; + p->user = user; + p->ex = ex; + p->next = 0; + p->prev = gCallBackLast; + + if (p->prev) (p->prev)->next = p; + gCallBackLast = p; + + findNotifyBits(); + + return p->id; + } + + return pigif_bad_malloc; + } + + return pigif_bad_callback; +} + +/* PUBLIC ----------------------------------------------------------------- */ + +double time_time(void) +{ + struct timeval tv; + double t; + + gettimeofday(&tv, 0); + + t = (double)tv.tv_sec + ((double)tv.tv_usec / 1E6); + + return t; +} + +void time_sleep(double seconds) +{ + struct timespec ts, rem; + + if (seconds > 0.0) + { + ts.tv_sec = seconds; + ts.tv_nsec = (seconds-(double)ts.tv_sec) * 1E9; + + while (clock_nanosleep(CLOCK_REALTIME, 0, &ts, &rem)) + { + /* copy remaining time to ts */ + ts.tv_sec = rem.tv_sec; + ts.tv_nsec = rem.tv_nsec; + } + } +} + +char *pigpio_error(int errnum) +{ + if (errnum > -1000) return cmdErrStr(errnum); + else + { + switch(errnum) + { + case pigif_bad_send: + return "failed to send to pigpiod"; + case pigif_bad_recv: + return "failed to receive from pigpiod"; + case pigif_bad_getaddrinfo: + return "failed to find address of pigpiod"; + case pigif_bad_connect: + return "failed to connect to pigpiod"; + case pigif_bad_socket: + return "failed to create socket"; + case pigif_bad_noib: + return "failed to open noib"; + case pigif_duplicate_callback: + return "identical callback exists"; + case pigif_bad_malloc: + return "failed to malloc"; + case pigif_bad_callback: + return "bad callback parameter"; + case pigif_notify_failed: + return "failed to create notification thread"; + case pigif_callback_not_found: + return "callback not found"; + default: + return "unknown error"; + } + } +} + +unsigned pigpiod_if_version(void) +{ + return PIGPIOD_IF_VERSION; +} + +pthread_t *start_thread(gpioThreadFunc_t thread_func, void *arg) +{ + pthread_t *pth; + pthread_attr_t pthAttr; + + pth = malloc(sizeof(pthread_t)); + + if (pth) + { + if (pthread_attr_init(&pthAttr)) + { + perror("pthread_attr_init failed"); + free(pth); + return NULL; + } + + if (pthread_attr_setstacksize(&pthAttr, STACK_SIZE)) + { + perror("pthread_attr_setstacksize failed"); + free(pth); + return NULL; + } + + if (pthread_create(pth, &pthAttr, thread_func, arg)) + { + perror("pthread_create socket failed"); + free(pth); + return NULL; + } + } + return pth; +} + +void stop_thread(pthread_t *pth) +{ + if (pth) + { + pthread_cancel(*pth); + pthread_join(*pth, NULL); + free(pth); + } +} + +int pigpio_start(char *addrStr, char *portStr) +{ + if ((!addrStr) || (strlen(addrStr) == 0)) + { + addrStr = "localhost"; + } + + if (!gPigStarted) + { + gPigCommand = pigpioOpenSocket(addrStr, portStr); + + if (gPigCommand >= 0) + { + gPigNotify = pigpioOpenSocket(addrStr, portStr); + + if (gPigNotify >= 0) + { + gPigHandle = pigpio_command(gPigNotify, PI_CMD_NOIB, 0, 0, 1); + + if (gPigHandle < 0) return pigif_bad_noib; + else + { + gLastLevel = read_bank_1(); + + pthNotify = start_thread(pthNotifyThread, 0); + if (pthNotify) + { + gPigStarted = 1; + return 0; + } + else return pigif_notify_failed; + } + } + else return gPigNotify; + } + else return gPigCommand; + } + return 0; +} + +void pigpio_stop(void) +{ + gPigStarted = 0; + + if (pthNotify) + { + stop_thread(pthNotify); + pthNotify = 0; + } + + if (gPigNotify >= 0) + { + if (gPigHandle >= 0) + { + pigpio_command(gPigNotify, PI_CMD_NC, gPigHandle, 0, 1); + gPigHandle = -1; + } + + close(gPigNotify); + gPigNotify = -1; + } + + if (gPigCommand >= 0) + { + if (gPigHandle >= 0) + { + pigpio_command(gPigCommand, PI_CMD_NC, gPigHandle, 0, 1); + gPigHandle = -1; + } + + close(gPigCommand); + gPigCommand = -1; + } +} + +int set_mode(unsigned gpio, unsigned mode) + {return pigpio_command(gPigCommand, PI_CMD_MODES, gpio, mode, 1);} + +int get_mode(unsigned gpio) + {return pigpio_command(gPigCommand, PI_CMD_MODEG, gpio, 0, 1);} + +int set_pull_up_down(unsigned gpio, unsigned pud) + {return pigpio_command(gPigCommand, PI_CMD_PUD, gpio, pud, 1);} + +int gpio_read(unsigned gpio) + {return pigpio_command(gPigCommand, PI_CMD_READ, gpio, 0, 1);} + +int gpio_write(unsigned gpio, unsigned level) + {return pigpio_command(gPigCommand, PI_CMD_WRITE, gpio, level, 1);} + +int set_PWM_dutycycle(unsigned user_gpio, unsigned dutycycle) + {return pigpio_command(gPigCommand, PI_CMD_PWM, user_gpio, dutycycle, 1);} + +int get_PWM_dutycycle(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_GDC, user_gpio, 0, 1);} + +int set_PWM_range(unsigned user_gpio, unsigned range) + {return pigpio_command(gPigCommand, PI_CMD_PRS, user_gpio, range, 1);} + +int get_PWM_range(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_PRG, user_gpio, 0, 1);} + +int get_PWM_real_range(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_PRRG, user_gpio, 0, 1);} + +int set_PWM_frequency(unsigned user_gpio, unsigned frequency) + {return pigpio_command(gPigCommand, PI_CMD_PFS, user_gpio, frequency, 1);} + +int get_PWM_frequency(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_PFG, user_gpio, 0, 1);} + +int set_servo_pulsewidth(unsigned user_gpio, unsigned pulsewidth) + {return pigpio_command(gPigCommand, PI_CMD_SERVO, user_gpio, pulsewidth, 1);} + +int get_servo_pulsewidth(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_GPW, user_gpio, 0, 1);} + +int notify_open(void) + {return pigpio_command(gPigCommand, PI_CMD_NO, 0, 0, 1);} + +int notify_begin(unsigned handle, uint32_t bits) + {return pigpio_command(gPigCommand, PI_CMD_NB, handle, bits, 1);} + +int notify_pause(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_NB, handle, 0, 1);} + +int notify_close(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_NC, handle, 0, 1);} + +int set_watchdog(unsigned user_gpio, unsigned timeout) + {return pigpio_command(gPigCommand, PI_CMD_WDOG, user_gpio, timeout, 1);} + +uint32_t read_bank_1(void) + {return pigpio_command(gPigCommand, PI_CMD_BR1, 0, 0, 1);} + +uint32_t read_bank_2(void) + {return pigpio_command(gPigCommand, PI_CMD_BR2, 0, 0, 1);} + +int clear_bank_1(uint32_t levels) + {return pigpio_command(gPigCommand, PI_CMD_BC1, levels, 0, 1);} + +int clear_bank_2(uint32_t levels) + {return pigpio_command(gPigCommand, PI_CMD_BC2, levels, 0, 1);} + +int set_bank_1(uint32_t levels) + {return pigpio_command(gPigCommand, PI_CMD_BS1, levels, 0, 1);} + +int set_bank_2(uint32_t levels) + {return pigpio_command(gPigCommand, PI_CMD_BS2, levels, 0, 1);} + +int hardware_clock(unsigned gpio, unsigned frequency) + {return pigpio_command(gPigCommand, PI_CMD_HC, gpio, frequency, 1);} + +int hardware_PWM(unsigned gpio, unsigned frequency, uint32_t dutycycle) +{ + gpioExtent_t ext[1]; + + /* + p1=gpio + p2=frequency + p3=4 + ## extension ## + uint32_t dutycycle + */ + + ext[0].size = sizeof(dutycycle); + ext[0].ptr = &dutycycle; + + return pigpio_command_ext( + gPigCommand, PI_CMD_HP, gpio, frequency, sizeof(dutycycle), 1, ext, 1); +} + +uint32_t get_current_tick(void) + {return pigpio_command(gPigCommand, PI_CMD_TICK, 0, 0, 1);} + +uint32_t get_hardware_revision(void) + {return pigpio_command(gPigCommand, PI_CMD_HWVER, 0, 0, 1);} + +uint32_t get_pigpio_version(void) + {return pigpio_command(gPigCommand, PI_CMD_PIGPV, 0, 0, 1);} + +int wave_clear(void) + {return pigpio_command(gPigCommand, PI_CMD_WVCLR, 0, 0, 1);} + +int wave_add_new(void) + {return pigpio_command(gPigCommand, PI_CMD_WVNEW, 0, 0, 1);} + +int wave_add_generic(unsigned numPulses, gpioPulse_t *pulses) +{ + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=pulses*sizeof(gpioPulse_t) + ## extension ## + gpioPulse_t[] pulses + */ + + if (!numPulses) return 0; + + ext[0].size = numPulses * sizeof(gpioPulse_t); + ext[0].ptr = pulses; + + return pigpio_command_ext( + gPigCommand, PI_CMD_WVAG, 0, 0, ext[0].size, 1, ext, 1); +} + +int wave_add_serial( + unsigned user_gpio, unsigned baud, uint32_t databits, + uint32_t stophalfbits, uint32_t offset, unsigned numChar, char *str) +{ + uint8_t buf[12]; + gpioExtent_t ext[2]; + + /* + p1=user_gpio + p2=baud + p3=len+12 + ## extension ## + uint32_t databits + uint32_t stophalfbits + uint32_t offset + char[len] str + */ + + if (!numChar) return 0; + + memcpy(buf, &databits, 4); + memcpy(buf+4, &stophalfbits, 4); + memcpy(buf+8, &offset, 4); + + ext[0].size = sizeof(buf); + ext[0].ptr = buf; + + ext[1].size = numChar; + ext[1].ptr = str; + + return pigpio_command_ext(gPigCommand, PI_CMD_WVAS, + user_gpio, baud, numChar+sizeof(buf), 2, ext, 1); +} + +int wave_create(void) + {return pigpio_command(gPigCommand, PI_CMD_WVCRE, 0, 0, 1);} + +int wave_delete(unsigned wave_id) + {return pigpio_command(gPigCommand, PI_CMD_WVDEL, wave_id, 0, 1);} + +int wave_tx_start(void) /* DEPRECATED */ + {return pigpio_command(gPigCommand, PI_CMD_WVGO, 0, 0, 1);} + +int wave_tx_repeat(void) /* DEPRECATED */ + {return pigpio_command(gPigCommand, PI_CMD_WVGOR, 0, 0, 1);} + +int wave_send_once(unsigned wave_id) + {return pigpio_command(gPigCommand, PI_CMD_WVTX, wave_id, 0, 1);} + +int wave_send_repeat(unsigned wave_id) + {return pigpio_command(gPigCommand, PI_CMD_WVTXR, wave_id, 0, 1);} + +int wave_chain(char *buf, unsigned bufSize) +{ + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=bufSize + ## extension ## + char buf[bufSize] + */ + + ext[0].size = bufSize; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_WVCHA, 0, 0, bufSize, 1, ext, 1); +} + +int wave_tx_busy(void) + {return pigpio_command(gPigCommand, PI_CMD_WVBSY, 0, 0, 1);} + +int wave_tx_stop(void) + {return pigpio_command(gPigCommand, PI_CMD_WVHLT, 0, 0, 1);} + +int wave_get_micros(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSM, 0, 0, 1);} + +int wave_get_high_micros(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSM, 1, 0, 1);} + +int wave_get_max_micros(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSM, 2, 0, 1);} + +int wave_get_pulses(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSP, 0, 0, 1);} + +int wave_get_high_pulses(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSP, 1, 0, 1);} + +int wave_get_max_pulses(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSP, 2, 0, 1);} + +int wave_get_cbs(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSC, 0, 0, 1);} + +int wave_get_high_cbs(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSC, 1, 0, 1);} + +int wave_get_max_cbs(void) + {return pigpio_command(gPigCommand, PI_CMD_WVSC, 2, 0, 1);} + +int gpio_trigger(unsigned user_gpio, unsigned pulseLen, uint32_t level) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=pulseLen + p3=4 + ## extension ## + unsigned level + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &level; + + return pigpio_command_ext( + gPigCommand, PI_CMD_TRIG, user_gpio, pulseLen, 4, 1, ext, 1); +} + +int set_glitch_filter(unsigned user_gpio, unsigned steady) + {return pigpio_command(gPigCommand, PI_CMD_FG, user_gpio, steady, 1);} + +int set_noise_filter(unsigned user_gpio, unsigned steady, unsigned active) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=steady + p3=4 + ## extension ## + unsigned active + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &active; + + return pigpio_command_ext( + gPigCommand, PI_CMD_FN, user_gpio, steady, 4, 1, ext, 1); +} + +int store_script(char *script) +{ + unsigned len; + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=len + ## extension ## + char[len] script + */ + + len = strlen(script); + + if (!len) return 0; + + ext[0].size = len; + ext[0].ptr = script; + + return pigpio_command_ext(gPigCommand, PI_CMD_PROC, 0, 0, len, 1, ext, 1); +} + +int run_script(unsigned script_id, unsigned numPar, uint32_t *param) +{ + gpioExtent_t ext[1]; + + /* + p1=script id + p2=0 + p3=numPar * 4 + ## extension ## + uint32_t[numPar] pars + */ + + ext[0].size = 4 * numPar; + ext[0].ptr = param; + + return pigpio_command_ext + (gPigCommand, PI_CMD_PROCR, script_id, 0, numPar*4, 1, ext, 1); +} + +int recvMax(void *buf, int bufsize, int sent) +{ + uint8_t scratch[4096]; + int remaining, fetch, count; + + if (sent < bufsize) count = sent; else count = bufsize; + + if (count) recv(gPigCommand, buf, count, MSG_WAITALL); + + remaining = sent - count; + + while (remaining) + { + fetch = remaining; + if (fetch > sizeof(scratch)) fetch = sizeof(scratch); + recv(gPigCommand, scratch, fetch, MSG_WAITALL); + remaining -= fetch; + } + + return count; +} + +int script_status(unsigned script_id, uint32_t *param) +{ + int status; + uint32_t p[PI_MAX_SCRIPT_PARAMS+1]; /* space for script status */ + + status = pigpio_command(gPigCommand, PI_CMD_PROCP, script_id, 0, 0); + + if (status > 0) + { + recvMax(p, sizeof(p), status); + status = p[0]; + if (param) memcpy(param, p+1, sizeof(p)-4); + } + + pthread_mutex_unlock(&command_mutex); + + return status; +} + +int stop_script(unsigned script_id) + {return pigpio_command(gPigCommand, PI_CMD_PROCS, script_id, 0, 1);} + +int delete_script(unsigned script_id) + {return pigpio_command(gPigCommand, PI_CMD_PROCD, script_id, 0, 1);} + +int bb_serial_read_open(unsigned user_gpio, unsigned baud, uint32_t bbBits) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=baud + p3=4 + ## extension ## + unsigned bbBits + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &bbBits; + + return pigpio_command_ext( + gPigCommand, PI_CMD_SLRO, user_gpio, baud, 4, 1, ext, 1); +} + +int bb_serial_read(unsigned user_gpio, void *buf, size_t bufSize) +{ + int bytes; + + bytes = pigpio_command(gPigCommand, PI_CMD_SLR, user_gpio, bufSize, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, bufSize, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int bb_serial_read_close(unsigned user_gpio) + {return pigpio_command(gPigCommand, PI_CMD_SLRC, user_gpio, 0, 1);} + +int bb_serial_invert(unsigned user_gpio, unsigned invert) + {return pigpio_command(gPigCommand, PI_CMD_SLRI, user_gpio, invert, 1);} + +int i2c_open(unsigned i2c_bus, unsigned i2c_addr, uint32_t i2c_flags) +{ + gpioExtent_t ext[1]; + + /* + p1=i2c_bus + p2=i2c_addr + p3=4 + ## extension ## + uint32_t i2c_flags + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &i2c_flags; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CO, i2c_bus, i2c_addr, 4, 1, ext, 1); +} + +int i2c_close(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_I2CC, handle, 0, 1);} + +int i2c_write_quick(unsigned handle, unsigned bit) + {return pigpio_command(gPigCommand, PI_CMD_I2CWQ, handle, bit, 1);} + +int i2c_write_byte(unsigned handle, unsigned val) + {return pigpio_command(gPigCommand, PI_CMD_I2CWS, handle, val, 1);} + +int i2c_read_byte(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_I2CRS, handle, 0, 1);} + +int i2c_write_byte_data(unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CWB, handle, reg, 4, 1, ext, 1); +} + +int i2c_write_word_data(unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CWW, handle, reg, 4, 1, ext, 1); +} + +int i2c_read_byte_data(unsigned handle, unsigned reg) + {return pigpio_command(gPigCommand, PI_CMD_I2CRB, handle, reg, 1);} + +int i2c_read_word_data(unsigned handle, unsigned reg) + {return pigpio_command(gPigCommand, PI_CMD_I2CRW, handle, reg, 1);} + +int i2c_process_call(unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CPC, handle, reg, 4, 1, ext, 1); +} + +int i2c_write_block_data( + unsigned handle, unsigned reg, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CWK, handle, reg, count, 1, ext, 1); +} + +int i2c_read_block_data(unsigned handle, unsigned reg, char *buf) +{ + int bytes; + + bytes = pigpio_command(gPigCommand, PI_CMD_I2CRK, handle, reg, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, 32, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int i2c_block_process_call( + unsigned handle, unsigned reg, char *buf, unsigned count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_I2CPK, handle, reg, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, 32, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int i2c_read_i2c_block_data( + unsigned handle, unsigned reg, char *buf, uint32_t count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t count + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &count; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_I2CRI, handle, reg, 4, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, count, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + + +int i2c_write_i2c_block_data( + unsigned handle, unsigned reg, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CWI, handle, reg, count, 1, ext, 1); +} + +int i2c_read_device(unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command(gPigCommand, PI_CMD_I2CRD, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, count, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int i2c_write_device(unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_I2CWD, handle, 0, count, 1, ext, 1); +} + +int i2c_zip( + unsigned handle, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=inLen + ## extension ## + char inBuf[inLen] + */ + + ext[0].size = inLen; + ext[0].ptr = inBuf; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_I2CZ, handle, 0, inLen, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(outBuf, outLen, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int bb_i2c_open(unsigned SDA, unsigned SCL, unsigned baud) +{ + gpioExtent_t ext[1]; + + /* + p1=SDA + p2=SCL + p3=4 + ## extension ## + uint32_t baud + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &baud; + + return pigpio_command_ext + (gPigCommand, PI_CMD_BI2CO, SDA, SCL, 4, 1, ext, 1); +} + +int bb_i2c_close(unsigned SDA) + {return pigpio_command(gPigCommand, PI_CMD_BI2CC, SDA, 0, 1);} + +int bb_i2c_zip( + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=SDA + p2=0 + p3=inLen + ## extension ## + char inBuf[inLen] + */ + + ext[0].size = inLen; + ext[0].ptr = inBuf; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_BI2CZ, SDA, 0, inLen, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(outBuf, outLen, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int spi_open(unsigned channel, unsigned speed, uint32_t flags) +{ + gpioExtent_t ext[1]; + + /* + p1=channel + p2=speed + p3=4 + ## extension ## + uint32_t flags + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &flags; + + return pigpio_command_ext + (gPigCommand, PI_CMD_SPIO, channel, speed, 4, 1, ext, 1); +} + +int spi_close(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_SPIC, handle, 0, 1);} + +int spi_read(unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command + (gPigCommand, PI_CMD_SPIR, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, count, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int spi_write(unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_SPIW, handle, 0, count, 1, ext, 1); +} + +int spi_xfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = txBuf; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_SPIX, handle, 0, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(rxBuf, count, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int serial_open(char *dev, unsigned baud, unsigned flags) +{ + int len; + gpioExtent_t ext[1]; + + len = strlen(dev); + + /* + p1=baud + p2=flags + p3=len + ## extension ## + char dev[len] + */ + + ext[0].size = len; + ext[0].ptr = dev; + + return pigpio_command_ext + (gPigCommand, PI_CMD_SERO, baud, flags, len, 1, ext, 1); +} + +int serial_close(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_SERC, handle, 0, 1);} + +int serial_write_byte(unsigned handle, unsigned val) + {return pigpio_command(gPigCommand, PI_CMD_SERWB, handle, val, 1);} + +int serial_read_byte(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_SERRB, handle, 0, 1);} + +int serial_write(unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (gPigCommand, PI_CMD_SERW, handle, 0, count, 1, ext, 1); +} + +int serial_read(unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command + (gPigCommand, PI_CMD_SERR, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(buf, count, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + +int serial_data_available(unsigned handle) + {return pigpio_command(gPigCommand, PI_CMD_SERDA, handle, 0, 1);} + +int custom_1(unsigned arg1, unsigned arg2, char *argx, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=arg1 + p2=arg2 + p3=count + ## extension ## + char argx[count] + */ + + ext[0].size = count; + ext[0].ptr = argx; + + return pigpio_command_ext( + gPigCommand, PI_CMD_CF1, arg1, arg2, count, 1, ext, 1); +} + + +int custom_2(unsigned arg1, char *argx, unsigned count, + char *retBuf, uint32_t retMax) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=arg1 + p2=retMax + p3=count + ## extension ## + char argx[count] + */ + + ext[0].size = count; + ext[0].ptr = argx; + + bytes = pigpio_command_ext + (gPigCommand, PI_CMD_CF2, arg1, retMax, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(retBuf, retMax, bytes); + } + + pthread_mutex_unlock(&command_mutex); + + return bytes; +} + + +int callback(unsigned user_gpio, unsigned edge, CBFunc_t f) + {return intCallback(user_gpio, edge, f, 0, 0);} + +int callback_ex(unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *user) + {return intCallback(user_gpio, edge, f, user, 1);} + +int callback_cancel(unsigned id) +{ + callback_t *p; + + p = gCallBackFirst; + + while (p) + { + if (p->id == id) + { + if (p->prev) p->prev->next = p->next; + else gCallBackFirst = p->next; + + if (p->next) p->next->prev = p->prev; + else gCallBackLast = p->prev; + + free(p); + + findNotifyBits(); + + return 0; + } + p = p->next; + } + return pigif_callback_not_found; +} + +int wait_for_edge(unsigned user_gpio, unsigned edge, double timeout) +{ + int triggered = 0; + int id; + double due; + + if (timeout <= 0.0) return 0; + + due = time_time() + timeout; + + id = callback_ex(user_gpio, edge, _wfe, &triggered); + + while (!triggered && (time_time() < due)) time_sleep(0.1); + + callback_cancel(id); + + return triggered; +} + + diff --git a/pigpio-master/pigpiod_if.h b/pigpio-master/pigpiod_if.h new file mode 100644 index 0000000..e2b52b4 --- /dev/null +++ b/pigpio-master/pigpiod_if.h @@ -0,0 +1,2996 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +#ifndef PIGPIOD_IF_H +#define PIGPIOD_IF_H + +#include "pigpio.h" + +#define PIGPIOD_IF_VERSION 28 + +/*TEXT + +THIS LIBRARY IS DEPRECATED. NEW CODE SHOULD BE WRITTEN TO +USE THE MORE VERSATILE pigpiod_if2 LIBRARY. + +pigpiod_if is a C library for the Raspberry which allows control +of the GPIO via the socket interface to the pigpio daemon. + +*Features* + +o hardware timed PWM on any of GPIO 0-31 + +o hardware timed servo pulses on any of GPIO 0-31 + +o callbacks when any of GPIO 0-31 change state + +o callbacks at timed intervals + +o reading/writing all of the GPIO in a bank as one operation + +o individually setting GPIO modes, reading and writing + +o notifications when any of GPIO 0-31 change state + +o the construction of output waveforms with microsecond timing + +o rudimentary permission control over GPIO + +o a simple interface to start and stop new threads + +o I2C, SPI, and serial link wrappers + +o creating and running scripts on the pigpio daemon + +*GPIO* + +ALL GPIO are identified by their Broadcom number. + +*Notes* + +The PWM and servo pulses are timed using the DMA and PWM/PCM peripherals. + +*Usage* + +Include in your source files. + +Assuming your source is in prog.c use the following command to build + +. . +gcc -Wall -pthread -o prog prog.c -lpigpiod_if -lrt +. . + +to run make sure the pigpio daemon is running + +. . +sudo pigpiod + + ./prog # sudo is not required to run programs linked to pigpiod_if +. . + +For examples see x_pigpiod_if.c within the pigpio archive file. + +*Notes* + +All the functions which return an int return < 0 on error + +TEXT*/ + +/*OVERVIEW + +ESSENTIAL + +pigpio_start Connects to the pigpio daemon +pigpio_stop Disconnects from the pigpio daemon + +BEGINNER + +set_mode Set a GPIO mode +get_mode Get a GPIO mode + +set_pull_up_down Set/clear GPIO pull up/down resistor + +gpio_read Read a GPIO +gpio_write Write a GPIO + +set_PWM_dutycycle Start/stop PWM pulses on a GPIO +get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO + +set_servo_pulsewidth Start/stop servo pulses on a GPIO +get_servo_pulsewidth Get the servo pulsewidth in use on a GPIO + +callback Create GPIO level change callback +callback_ex Create GPIO level change callback +callback_cancel Cancel a callback +wait_for_edge Wait for GPIO level change + +INTERMEDIATE + +gpio_trigger Send a trigger pulse to a GPIO. + +set_watchdog Set a watchdog on a GPIO. + +set_PWM_range Configure PWM range for a GPIO +get_PWM_range Get configured PWM range for a GPIO + +set_PWM_frequency Configure PWM frequency for a GPIO +get_PWM_frequency Get configured PWM frequency for a GPIO + +read_bank_1 Read all GPIO in bank 1 +read_bank_2 Read all GPIO in bank 2 + +clear_bank_1 Clear selected GPIO in bank 1 +clear_bank_2 Clear selected GPIO in bank 2 + +set_bank_1 Set selected GPIO in bank 1 +set_bank_2 Set selected GPIO in bank 2 + +start_thread Start a new thread +stop_thread Stop a previously started thread + +ADVANCED + +get_PWM_real_range Get underlying PWM range for a GPIO + +notify_open Request a notification handle +notify_begin Start notifications for selected GPIO +notify_pause Pause notifications +notify_close Close a notification + +bb_serial_read_open Opens a GPIO for bit bang serial reads +bb_serial_read Reads bit bang serial data from a GPIO +bb_serial_read_close Closes a GPIO for bit bang serial reads +bb_serial_invert Invert serial logic (1 invert, 0 normal) + +hardware_clock Start hardware clock on supported GPIO +hardware_PWM Start hardware PWM on supported GPIO + +set_glitch_filter Set a glitch filter on a GPIO +set_noise_filter Set a noise filter on a GPIO + +SCRIPTS + +store_script Store a script +run_script Run a stored script +script_status Get script status and parameters +stop_script Stop a running script +delete_script Delete a stored script + +WAVES + +wave_clear Deletes all waveforms + +wave_add_new Starts a new waveform +wave_add_generic Adds a series of pulses to the waveform +wave_add_serial Adds serial data to the waveform + +wave_create Creates a waveform from added data +wave_delete Deletes one or more waveforms + +wave_send_once Transmits a waveform once +wave_send_repeat Transmits a waveform repeatedly + +wave_chain Transmits a chain of waveforms + +wave_tx_busy Checks to see if the waveform has ended +wave_tx_stop Aborts the current waveform + +wave_get_micros Length in microseconds of the current waveform +wave_get_high_micros Length of longest waveform so far +wave_get_max_micros Absolute maximum allowed micros + +wave_get_pulses Length in pulses of the current waveform +wave_get_high_pulses Length of longest waveform so far +wave_get_max_pulses Absolute maximum allowed pulses + +wave_get_cbs Length in cbs of the current waveform +wave_get_high_cbs Length of longest waveform so far +wave_get_max_cbs Absolute maximum allowed cbs + +I2C + +i2c_open Opens an I2C device +i2c_close Closes an I2C device + +i2c_write_quick smbus write quick +i2c_write_byte smbus write byte +i2c_read_byte smbus read byte +i2c_write_byte_data smbus write byte data +i2c_write_word_data smbus write word data +i2c_read_byte_data smbus read byte data +i2c_read_word_data smbus read word data +i2c_process_call smbus process call +i2c_write_block_data smbus write block data +i2c_read_block_data smbus read block data +i2c_block_process_call smbus block process call + +i2c_write_i2c_block_data smbus write I2C block data +i2c_read_i2c_block_data smbus read I2C block data + +i2c_read_device Reads the raw I2C device +i2c_write_device Writes the raw I2C device + +i2c_zip Performs multiple I2C transactions + +bb_i2c_open Opens GPIO for bit banging I2C +bb_i2c_close Closes GPIO for bit banging I2C +bb_i2c_zip Performs multiple bit banged I2C transactions + +SPI + +spi_open Opens a SPI device +spi_close Closes a SPI device + +spi_read Reads bytes from a SPI device +spi_write Writes bytes to a SPI device +spi_xfer Transfers bytes with a SPI device + +SERIAL + +serial_open Opens a serial device +serial_close Closes a serial device + +serial_write_byte Writes a byte to a serial device +serial_read_byte Reads a byte from a serial device +serial_write Writes bytes to a serial device +serial_read Reads bytes from a serial device + +serial_data_available Returns number of bytes ready to be read + +CUSTOM + +custom_1 User custom function 1 +custom_2 User custom function 2 + +UTILITIES + +get_current_tick Get current tick (microseconds) + +get_hardware_revision Get hardware revision +get_pigpio_version Get the pigpio version +pigpiod_if_version Get the pigpiod_if version + +pigpio_error Get a text description of an error code. + +time_sleep Sleeps for a float number of seconds +time_time Float number of seconds since the epoch + +OVERVIEW*/ + +#ifdef __cplusplus +extern "C" { +#endif + +typedef void (*CBFunc_t) (unsigned user_gpio, unsigned level, uint32_t tick); + +typedef void (*CBFuncEx_t) + (unsigned user_gpio, unsigned level, uint32_t tick, void * user); + +typedef struct callback_s callback_t; + +/*F*/ +double time_time(void); +/*D +Return the current time in seconds since the Epoch. +D*/ + +/*F*/ +void time_sleep(double seconds); +/*D +Delay execution for a given number of seconds. + +. . +seconds: the number of seconds to delay. +. . +D*/ + +/*F*/ +char *pigpio_error(int errnum); +/*D +Return a text description for an error code. + +. . +errnum: the error code. +. . +D*/ + +/*F*/ +unsigned pigpiod_if_version(void); +/*D +Return the pigpiod_if version. +D*/ + +/*F*/ +pthread_t *start_thread(gpioThreadFunc_t thread_func, void *userdata); +/*D +Starts a new thread of execution with thread_func as the main routine. + +. . +thread_func: the main function for the new thread. + userdata: a pointer to an arbitrary argument. +. . + +Returns a pointer to pthread_t if OK, otherwise NULL. + +The function is passed the single argument userdata. + +The thread can be cancelled by passing the pointer to pthread_t to +[*stop_thread*]. +D*/ + +/*F*/ +void stop_thread(pthread_t *pth); +/*D +Cancels the thread pointed at by pth. + +. . +pth: the thread to be stopped. +. . + +No value is returned. + +The thread to be stopped should have been started with [*start_thread*]. +D*/ + +/*F*/ +int pigpio_start(char *addrStr, char *portStr); +/*D +Connect to the pigpio daemon. Reserving command and +notification streams. + +. . +addrStr: specifies the host or IP address of the Pi running the + pigpio daemon. It may be NULL in which case localhost + is used unless overridden by the PIGPIO_ADDR environment + variable. + +portStr: specifies the port address used by the Pi running the + pigpio daemon. It may be NULL in which case "8888" + is used unless overridden by the PIGPIO_PORT environment + variable. +. . +D*/ + +/*F*/ +void pigpio_stop(void); +/*D +Terminates the connection to the pigpio daemon and releases +resources used by the library. +D*/ + +/*F*/ +int set_mode(unsigned gpio, unsigned mode); +/*D +Set the GPIO mode. + +. . +gpio: 0-53. +mode: PI_INPUT, PI_OUTPUT, PI_ALT0, PI_ALT1, + PI_ALT2, PI_ALT3, PI_ALT4, PI_ALT5. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_MODE, +or PI_NOT_PERMITTED. +D*/ + +/*F*/ +int get_mode(unsigned gpio); +/*D +Get the GPIO mode. + +. . +gpio: 0-53. +. . + +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. +D*/ + +/*F*/ +int set_pull_up_down(unsigned gpio, unsigned pud); +/*D +Set or clear the GPIO pull-up/down resistor. + +. . +gpio: 0-53. + pud: PI_PUD_UP, PI_PUD_DOWN, PI_PUD_OFF. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_PUD, +or PI_NOT_PERMITTED. +D*/ + +/*F*/ +int gpio_read(unsigned gpio); +/*D +Read the GPIO level. + +. . +gpio:0-53. +. . + +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. +D*/ + +/*F*/ +int gpio_write(unsigned gpio, unsigned level); +/*D +Write the GPIO level. + +. . + gpio: 0-53. +level: 0, 1. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_LEVEL, +or PI_NOT_PERMITTED. + +Notes + +If PWM or servo pulses are active on the GPIO they are switched off. +D*/ + +/*F*/ +int set_PWM_dutycycle(unsigned user_gpio, unsigned dutycycle); +/*D +Start (non-zero dutycycle) or stop (0) PWM pulses on the GPIO. + +. . +user_gpio: 0-31. +dutycycle: 0-range (range defaults to 255). +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYCYCLE, +or PI_NOT_PERMITTED. +Notes + +The [*set_PWM_range*] function may be used to change the +default range of 255. +D*/ + +/*F*/ +int get_PWM_dutycycle(unsigned user_gpio); +/*D +Return the PWM dutycycle in use on a GPIO. + +. . +user_gpio: 0-31. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see [*get_PWM_range*]). + +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). +D*/ + +/*F*/ +int set_PWM_range(unsigned user_gpio, unsigned range); +/*D +Set the range of PWM values to be used on the GPIO. + +. . +user_gpio: 0-31. + range: 25-40000. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYRANGE, +or PI_NOT_PERMITTED. + +Notes + +If PWM is currently active on the GPIO its dutycycle will be +scaled to reflect the new range. + +The real range, the number of steps between fully off and fully on +for each of the 18 available GPIO frequencies is + +. . + 25(#1), 50(#2), 100(#3), 125(#4), 200(#5), 250(#6), + 400(#7), 500(#8), 625(#9), 800(#10), 1000(#11), 1250(#12), +2000(#13), 2500(#14), 4000(#15), 5000(#16), 10000(#17), 20000(#18) +. . + +The real value set by set_PWM_range is (dutycycle * real range) / range. +D*/ + +/*F*/ +int get_PWM_range(unsigned user_gpio); +/*D +Get the range of PWM values being used on the GPIO. + +. . +user_gpio: 0-31. +. . + +Returns the dutycycle range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +If a hardware clock or hardware PWM is active on the GPIO the +reported range will be 1000000 (1M). +D*/ + +/*F*/ +int get_PWM_real_range(unsigned user_gpio); +/*D +Get the real underlying range of PWM values being used on the GPIO. + +. . +user_gpio: 0-31. +. . + +Returns the real range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +D*/ + +/*F*/ +int set_PWM_frequency(unsigned user_gpio, unsigned frequency); +/*D +Set the frequency (in Hz) of the PWM to be used on the GPIO. + +. . +user_gpio: 0-31. +frequency: >=0 (Hz). +. . + +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PERMITTED. + +If PWM is currently active on the GPIO it will be switched +off and then back on at the new frequency. + +Each GPIO can be independently set to one of 18 different +PWM frequencies. + +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +The frequencies for each sample rate are: + +. . + Hertz + + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 + 1250 1000 800 500 400 250 200 100 50 + + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 + 625 500 400 250 200 125 100 50 25 + + 4: 10000 5000 2500 2000 1250 1000 625 500 400 + 313 250 200 125 100 63 50 25 13 +sample + rate + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 + 250 200 160 100 80 50 40 20 10 + + 8: 5000 2500 1250 1000 625 500 313 250 200 + 156 125 100 63 50 31 25 13 6 + + 10: 4000 2000 1000 800 500 400 250 200 160 + 125 100 80 50 40 25 20 10 5 +. . +D*/ + +/*F*/ +int get_PWM_frequency(unsigned user_gpio); +/*D +Get the frequency of PWM being used on the GPIO. + +. . +user_gpio: 0-31. +. . + +For normal PWM the frequency will be that defined for the GPIO by +[*set_PWM_frequency*]. + +If a hardware clock is active on the GPIO the reported frequency +will be that set by [*hardware_clock*]. + +If hardware PWM is active on the GPIO the reported frequency +will be that set by [*hardware_PWM*]. + +Returns the frequency (in hertz) used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. +D*/ + +/*F*/ +int set_servo_pulsewidth(unsigned user_gpio, unsigned pulsewidth); +/*D +Start (500-2500) or stop (0) servo pulses on the GPIO. + +. . + user_gpio: 0-31. +pulsewidth: 0 (off), 500 (anti-clockwise) - 2500 (clockwise). +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_PULSEWIDTH or +PI_NOT_PERMITTED. + +The selected pulsewidth will continue to be transmitted until +changed by a subsequent call to set_servo_pulsewidth. + +The pulsewidths supported by servos varies and should probably be +determined by experiment. A value of 1500 should always be safe and +represents the mid-point of rotation. + +You can DAMAGE a servo if you command it to move beyond its limits. + +OTHER UPDATE RATES: + +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +. . +Update Rate (Hz) 50 100 200 400 500 +1E6/Hz 20000 10000 5000 2500 2000 +. . + +Firstly set the desired PWM frequency using [*set_PWM_frequency*]. + +Then set the PWM range using [*set_PWM_range*] to 1E6/Hz. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +E.g. If you want to update a servo connected to GPIO 25 at 400Hz + +. . +set_PWM_frequency(25, 400); +set_PWM_range(25, 2500); +. . + +Thereafter use the [*set_PWM_dutycycle*] function to move the servo, +e.g. set_PWM_dutycycle(25, 1500) will set a 1500 us pulse. +D*/ + +/*F*/ +int get_servo_pulsewidth(unsigned user_gpio); +/*D +Return the servo pulsewidth in use on a GPIO. + +. . +user_gpio: 0-31. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. +D*/ + +/*F*/ +int notify_open(void); +/*D +Get a free notification handle. + +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +A notification is a method for being notified of GPIO state +changes via a pipe. + +Pipes are only accessible from the local machine so this function +serves no purpose if you are using the library from a remote machine. +The in-built (socket) notifications provided by [*callback*] +should be used instead. + +Notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). +E.g. if the function returns 15 then the notifications must be +read from /dev/pigpio15. +D*/ + +/*F*/ +int notify_begin(unsigned handle, uint32_t bits); +/*D +Start notifications on a previously opened handle. + +. . +handle: 0-31 (as returned by [*notify_open*]) + bits: a mask indicating the GPIO to be notified. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +The notification sends state changes for each GPIO whose +corresponding bit in bits is set. + +Each notification occupies 12 bytes in the fifo as follows: + +. . +typedef struct +{ + uint16_t seqno; + uint16_t flags; + uint32_t tick; + uint32_t level; +} gpioReport_t; +. . + +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +flags: two flags are defined, PI_NTFY_FLAGS_WDOG and PI_NTFY_FLAGS_ALIVE. + +PI_NTFY_FLAGS_WDOG, if bit 5 is set then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +PI_NTFY_FLAGS_ALIVE, if bit 6 is set this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +level: indicates the level of each GPIO. If bit 1<=0 + numBytes: >=1 + str: an array of chars. +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOP_BITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +NOTES: + +The serial data is formatted as one start bit, [*data_bits*] data bits, +and [*stop_bits*]/2 stop bits. + +It is legal to add serial data streams with different baud rates to +the same waveform. + +[*numBytes*] is the number of bytes of data in str. + +The bytes required for each character depend upon [*data_bits*]. + +For [*data_bits*] 1-8 there will be one byte per character. +For [*data_bits*] 9-16 there will be two bytes per character. +For [*data_bits*] 17-32 there will be four bytes per character. +D*/ + +/*F*/ +int wave_create(void); +/*D +This function creates a waveform from the data provided by the prior +calls to the [*wave_add_**] functions. Upon success a wave id +greater than or equal to 0 is returned, otherwise PI_EMPTY_WAVEFORM, +PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + +The data provided by the [*wave_add_**] functions is consumed by this +function. + +As many waveforms may be created as there is space available. The +wave id is passed to [*wave_send_**] to specify the waveform to transmit. + +Normal usage would be + +Step 1. [*wave_clear*] to clear all waveforms and added data. + +Step 2. [*wave_add_**] calls to supply the waveform data. + +Step 3. [*wave_create*] to create the waveform and get a unique id + +Repeat steps 2 and 3 as needed. + +Step 4. [*wave_send_**] with the id of the waveform to transmit. + +A waveform comprises one or more pulses. Each pulse consists of a +[*gpioPulse_t*] structure. + +. . +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; +} gpioPulse_t; +. . + +The fields specify + +1) the GPIO to be switched on at the start of the pulse. +2) the GPIO to be switched off at the start of the pulse. +3) the delay in microseconds before the next pulse. + +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +When a waveform is started each pulse is executed in order with the +specified delay between the pulse and the next. + +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. +D*/ + + +/*F*/ +int wave_delete(unsigned wave_id); +/*D +This function deletes the waveform with id wave_id. + +. . +wave_id: >=0, as returned by [*wave_create*]. +. . + +Wave ids are allocated in order, 0, 1, 2, etc. + +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. +D*/ + +/*F*/ +int wave_send_once(unsigned wave_id); +/*D +This function transmits the waveform with id wave_id. The waveform +is sent once. + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +. . +wave_id: >=0, as returned by [*wave_create*]. +. . + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + +/*F*/ +int wave_send_repeat(unsigned wave_id); +/*D +This function transmits the waveform with id wave_id. The waveform +cycles until cancelled (either by the sending of a new waveform or +by [*wave_tx_stop*]). + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +. . +wave_id: >=0, as returned by [*wave_create*]. +. . + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + +/*F*/ +int wave_chain(char *buf, unsigned bufSize); +/*D +This function transmits a chain of waveforms. + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of [*wave_id*]s and optional command +codes and related data. + +. . + buf: pointer to the wave_ids and optional command codes +bufSize: the number of bytes in buf +. . + +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +Delays between waves may be added with the delay command. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +Loop Start @ 255 0 @ Identify start of a wave block +Loop Repeat @ 255 1 x y @ loop x + y*256 times +Delay @ 255 2 x y @ delay x + y*256 microseconds +Loop Forever @ 255 3 @ loop forever + +If present Loop Forever must be the last entry in the chain. + +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +... +#include +#include + +#define WAVES 5 +#define GPIO 4 + +int main(int argc, char *argv[]) +{ + int i, wid[WAVES]; + + if (pigpio_start(0, 0)<0) return -1; + + set_mode(GPIO, PI_OUTPUT); + + for (i=0; i=0, as returned by [*store_script*]. + numPar: 0-10, the number of parameters. + param: an array of parameters. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM + +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. +D*/ + +/*F*/ +int script_status(unsigned script_id, uint32_t *param); +/*D +This function returns the run status of a stored script as well +as the current values of parameters 0 to 9. + +. . +script_id: >=0, as returned by [*store_script*]. + param: an array to hold the returned 10 parameters. +. . + +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +The run status may be + +. . +PI_SCRIPT_INITING +PI_SCRIPT_HALTED +PI_SCRIPT_RUNNING +PI_SCRIPT_WAITING +PI_SCRIPT_FAILED +. . + +The current value of script parameters 0 to 9 are returned in param. +D*/ + +/*F*/ +int stop_script(unsigned script_id); +/*D +This function stops a running script. + +. . +script_id: >=0, as returned by [*store_script*]. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + +/*F*/ +int delete_script(unsigned script_id); +/*D +This function deletes a stored script. + +. . +script_id: >=0, as returned by [*store_script*]. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + +/*F*/ +int bb_serial_read_open(unsigned user_gpio, unsigned baud, unsigned data_bits); +/*D +This function opens a GPIO for bit bang reading of serial data. + +. . +user_gpio: 0-31. + baud: 50-250000 +data_bits: 1-32 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, +or PI_GPIO_IN_USE. + +The serial data is returned in a cyclic buffer and is read using +bb_serial_read. + +It is the caller's responsibility to read data from the cyclic buffer +in a timely fashion. +D*/ + +/*F*/ +int bb_serial_read(unsigned user_gpio, void *buf, size_t bufSize); +/*D +This function copies up to bufSize bytes of data read from the +bit bang serial cyclic buffer to the buffer starting at buf. + +. . +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. + buf: an array to receive the read bytes. + bufSize: >=0 +. . + +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +The bytes returned for each character depend upon the number of +data bits [*data_bits*] specified in the [*bb_serial_read_open*] command. + +For [*data_bits*] 1-8 there will be one byte per character. +For [*data_bits*] 9-16 there will be two bytes per character. +For [*data_bits*] 17-32 there will be four bytes per character. +D*/ + +/*F*/ +int bb_serial_read_close(unsigned user_gpio); +/*D +This function closes a GPIO for bit bang reading of serial data. + +. . +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. +D*/ + +/*F*/ +int bb_serial_invert(unsigned user_gpio, unsigned invert); +/*D +This function inverts serial logic for big bang serial reads. + +. . +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. + invert: 0-1, 1 invert, 0 normal. +. . + +Returns 0 if OK, otherwise PI_NOT_SERIAL_GPIO or PI_BAD_SER_INVERT. +D*/ + +/*F*/ +int i2c_open(unsigned i2c_bus, unsigned i2c_addr, unsigned i2c_flags); +/*D +This returns a handle for the device at address i2c_addr on bus i2c_bus. + +. . + i2c_bus: >=0. + i2c_addr: 0-0x7F. +i2c_flags: 0. +. . + +No flags are currently defined. This parameter should be set to zero. + +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +The GPIO used are given in the following table. + + @ SDA @ SCL +I2C 0 @ 0 @ 1 +I2C 1 @ 2 @ 3 + +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +. . +S (1 bit) : Start bit +P (1 bit) : Stop bit +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +A, NA (1 bit) : Accept and not accept bit. +Addr (7 bits): I2C 7 bit address. +Comm (8 bits): Command byte, a data byte which often selects a register. +Data (8 bits): A data byte. +Count (8 bits): A data byte containing the length of a block operation. + +[..]: Data sent by the device. +. . +D*/ + +/*F*/ +int i2c_close(unsigned handle); +/*D +This closes the I2C device associated with the handle. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int i2c_write_quick(unsigned handle, unsigned bit); +/*D +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. + bit: 0-1, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Quick command. SMBus 2.0 5.5.1 +. . +S Addr Rd/Wr [A] P +. . +D*/ + +/*F*/ +int i2c_write_byte(unsigned handle, unsigned bVal); +/*D +This sends a single byte to the device associated with handle. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. + bVal: 0-0xFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Send byte. SMBus 2.0 5.5.2 +. . +S Addr Wr [A] Data [A] P +. . +D*/ + +/*F*/ +int i2c_read_byte(unsigned handle); +/*D +This reads a single byte from the device associated with handle. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +Receive byte. SMBus 2.0 5.5.3 +. . +S Addr Rd [A] [Data] NA P +. . +D*/ + +/*F*/ +int i2c_write_byte_data(unsigned handle, unsigned i2c_reg, unsigned bVal); +/*D +This writes a single byte to the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + bVal: 0-0xFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write byte. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] Comm [A] Data [A] P +. . +D*/ + +/*F*/ +int i2c_write_word_data(unsigned handle, unsigned i2c_reg, unsigned wVal); +/*D +This writes a single 16 bit word to the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + wVal: 0-0xFFFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write word. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] Comm [A] DataLow [A] DataHigh [A] P +. . +D*/ + +/*F*/ +int i2c_read_byte_data(unsigned handle, unsigned i2c_reg); +/*D +This reads a single byte from the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read byte. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] Comm [A] S Addr Rd [A] [Data] NA P +. . +D*/ + +/*F*/ +int i2c_read_word_data(unsigned handle, unsigned i2c_reg); +/*D +This reads a single 16 bit word from the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read word. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] Comm [A] S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + +/*F*/ +int i2c_process_call(unsigned handle, unsigned i2c_reg, unsigned wVal); +/*D +This writes 16 bits of data to the specified register of the device +associated with handle and and reads 16 bits of data in return. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write/read. + wVal: 0-0xFFFF, the value to write. +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Process call. SMBus 2.0 5.5.6 +. . +S Addr Wr [A] Comm [A] DataLow [A] DataHigh [A] + S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + +/*F*/ +int i2c_write_block_data( +unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes up to 32 bytes to the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + buf: an array with the data to send. + count: 1-32, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Block write. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] Comm [A] Count [A] Data [A] Data [A] ... [A] Data [A] P +. . +D*/ + +/*F*/ +int i2c_read_block_data(unsigned handle, unsigned i2c_reg, char *buf); +/*D +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. + buf: an array to receive the read data. +. . + +The amount of returned data is set by the device. + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Block read. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] Comm [A] + S Addr Rd [A] [Count] A [Data] A [Data] A ... A [Data] NA P +. . +D*/ + +/*F*/ +int i2c_block_process_call( +unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write/read. + buf: an array with the data to send and to receive the read data. + count: 1-32, the number of bytes to write. +. . + + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +The smbus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +Block write-block read. SMBus 2.0 5.5.8 +. . +S Addr Wr [A] Comm [A] Count [A] Data [A] ... + S Addr Rd [A] [Count] A [Data] ... A P +. . +D*/ + +/*F*/ +int i2c_read_i2c_block_data( +unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. + buf: an array to receive the read data. + count: 1-32, the number of bytes to read. +. . + +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +. . +S Addr Wr [A] Comm [A] + S Addr Rd [A] [Data] A [Data] A ... A [Data] NA P +. . +D*/ + + +/*F*/ +int i2c_write_i2c_block_data( +unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +. . + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + buf: the data to write. + count: 1-32, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +. . +S Addr Wr [A] Comm [A] Data [A] Data [A] ... [A] Data [A] P +. . +D*/ + +/*F*/ +int i2c_read_device(unsigned handle, char *buf, unsigned count); +/*D +This reads count bytes from the raw device into buf. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. + buf: an array to receive the read data bytes. + count: >0, the number of bytes to read. +. . + +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. +D*/ + +/*F*/ +int i2c_write_device(unsigned handle, char *buf, unsigned count); +/*D +This writes count bytes from buf to the raw device. + +. . +handle: >=0, as returned by a call to [*i2c_open*]. + buf: an array containing the data bytes to write. + count: >0, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. +D*/ + +/*F*/ +int i2c_zip( + unsigned handle, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . +handle: >=0, as returned by a call to [*i2cOpen*] + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +On @ 2 @ Switch combined flag on +Off @ 3 @ Switch combined flag off +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53, write 0x32, read 6 bytes +Set address 0x1E, write 0x03, read 6 bytes +Set address 0x68, write 0x1B, read 8 bytes +End + +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +0x00 +... + +D*/ + +/*F*/ +int bb_i2c_open(unsigned SDA, unsigned SCL, unsigned baud); +/*D +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +o baud rates as low as 50 +o repeated starts +o clock stretching +o I2C on any pair of spare GPIO + +. . + SDA: 0-31 + SCL: 0-31 +baud: 50-500000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +NOTE: + +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. +D*/ + +/*F*/ +int bb_i2c_close(unsigned SDA); +/*D +This function stops bit banging I2C on a pair of GPIO previously +opened with [*bb_i2c_open*]. + +. . +SDA: 0-31, the SDA GPIO used in a prior call to [*bb_i2c_open*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. +D*/ + +/*F*/ +int bb_i2c_zip( + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . + SDA: 0-31 (as used in a prior call to [*bb_i2c_open*]) + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +Start @ 2 @ Start condition +Stop @ 3 @ Stop condition +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +No flags are currently defined. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53 +start, write 0x32, (re)start, read 6 bytes, stop +Set address 0x1E +start, write 0x03, (re)start, read 6 bytes, stop +Set address 0x68 +start, write 0x1B, (re)start, read 8 bytes, stop +End + +0x04 0x53 +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 + +0x04 0x1E +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 + +0x04 0x68 +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 + +0x00 +... +D*/ + +/*F*/ +int spi_open(unsigned spi_channel, unsigned baud, unsigned spi_flags); +/*D +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +The Pi has two SPI peripherals: main and auxiliary. + +The main SPI has two chip selects (channels), the auxiliary has +three. + +The auxiliary SPI is available on all models but the A and B. + +The GPIO used are given in the following table. + + @ MISO @ MOSI @ SCLK @ CE0 @ CE1 @ CE2 +Main SPI @ 9 @ 10 @ 11 @ 8 @ 7 @ - +Aux SPI @ 19 @ 20 @ 21 @ 18 @ 17 @ 16 + +. . +spi_channel: 0-1 (0-2 for the auxiliary SPI). + baud: 32K-125M (values above 30M are unlikely to work). + spi_flags: see below. +. . + +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +spi_flags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +. . + +mm defines the SPI mode. + +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +. . +Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +px is 0 if CEx is active low (default) and 1 for active high. + +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +A is 0 for the main SPI, 1 for the auxiliary SPI. + +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +The [*spi_read*], [*spi_write*], and [*spi_xfer*] functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +For bits 1-8 there will be one byte per word. +For bits 9-16 there will be two bytes per word. +For bits 17-32 there will be four bytes per word. + +Multi-byte transfers are made in least significant byte first order. + +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +The other bits in flags should be set to zero. +D*/ + +/*F*/ +int spi_close(unsigned handle); +/*D +This functions closes the SPI device identified by the handle. + +. . +handle: >=0, as returned by a call to [*spi_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int spi_read(unsigned handle, char *buf, unsigned count); +/*D +This function reads count bytes of data from the SPI +device associated with the handle. + +. . +handle: >=0, as returned by a call to [*spi_open*]. + buf: an array to receive the read data bytes. + count: the number of bytes to read. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int spi_write(unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +. . +handle: >=0, as returned by a call to [*spi_open*]. + buf: the data bytes to write. + count: the number of bytes to write. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int spi_xfer(unsigned handle, char *txBuf, char *rxBuf, unsigned count); +/*D +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +. . +handle: >=0, as returned by a call to [*spi_open*]. + txBuf: the data bytes to write. + rxBuf: the received data bytes. + count: the number of bytes to transfer. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int serial_open(char *ser_tty, unsigned baud, unsigned ser_flags); +/*D +This function opens a serial device at a specified baud rate +with specified flags. The device name must start with +/dev/tty or /dev/serial. + +. . + ser_tty: the serial device to open. + baud: the baud rate in bits per second, see below. +ser_flags: 0. +. . + +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +No flags are currently defined. This parameter should be set to zero. +D*/ + +/*F*/ +int serial_close(unsigned handle); +/*D +This function closes the serial device associated with handle. + +. . +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int serial_write_byte(unsigned handle, unsigned bVal); +/*D +This function writes bVal to the serial port associated with handle. + +. . +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + +/*F*/ +int serial_read_byte(unsigned handle); +/*D +This function reads a byte from the serial port associated with handle. + +. . +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +If no data is ready PI_SER_READ_NO_DATA is returned. +D*/ + +/*F*/ +int serial_write(unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes from buf to the the serial port +associated with handle. + +. . +handle: >=0, as returned by a call to [*serial_open*]. + buf: the array of bytes to write. + count: the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + +/*F*/ +int serial_read(unsigned handle, char *buf, unsigned count); +/*D +This function reads up to count bytes from the the serial port +associated with handle and writes them to buf. + +. . +handle: >=0, as returned by a call to [*serial_open*]. + buf: an array to receive the read data. + count: the maximum number of bytes to read. +. . + +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, PI_SER_READ_NO_DATA, or PI_SER_WRITE_FAILED. + +If no data is ready zero is returned. +D*/ + +/*F*/ +int serial_data_available(unsigned handle); +/*D +Returns the number of bytes available to be read from the +device associated with handle. + +. . +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int custom_1(unsigned arg1, unsigned arg2, char *argx, unsigned argc); +/*D +This function is available for user customisation. + +It returns a single integer value. + +. . +arg1: >=0 +arg2: >=0 +argx: extra (byte) arguments +argc: number of extra arguments +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. +D*/ + + +/*F*/ +int custom_2(unsigned arg1, char *argx, unsigned argc, + char *retBuf, unsigned retMax); +/*D +This function is available for user customisation. + +It differs from custom_1 in that it returns an array of bytes +rather than just an integer. + +The return value is an integer indicating the number of returned bytes. +. . + arg1: >=0 + argc: extra (byte) arguments + count: number of extra arguments +retBuf: buffer for returned data +retMax: maximum number of bytes to return +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. + +Note, the number of returned bytes will be retMax or less. +D*/ + + +/*F*/ +int callback(unsigned user_gpio, unsigned edge, CBFunc_t f); +/*D +This function initialises a new callback. + +. . +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + f: the callback function. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the GPIO, edge, and tick, whenever the +GPIO has the identified edge. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +edge 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes +. . +D*/ + +/*F*/ +int callback_ex + (unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *userdata); +/*D +This function initialises a new callback. + +. . +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + f: the callback function. + userdata: a pointer to arbitrary user data. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the GPIO, edge, tick, and user, whenever +the GPIO has the identified edge. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +edge 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes + +userdata pointer Pointer to an arbitrary object +. . +D*/ + +/*F*/ +int callback_cancel(unsigned callback_id); +/*D +This function cancels a callback identified by its id. + +. . +callback_id: >=0, as returned by a call to [*callback*] or [*callback_ex*]. +. . + +The function returns 0 if OK, otherwise pigif_callback_not_found. +D*/ + +/*F*/ +int wait_for_edge(unsigned user_gpio, unsigned edge, double timeout); +/*D +This function waits for edge on the GPIO for up to timeout +seconds. + +. . +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + timeout: >=0. +. . + +The function returns 1 if the edge occurred, otherwise 0. + +The function returns when the edge occurs or after the timeout. +D*/ + +/*PARAMS + +active :: 0-1000000 + +The number of microseconds level changes are reported for once +a noise filter has been triggered (by [*steady*] microseconds of +a stable level). + +*addrStr:: +A string specifying the host or IP address of the Pi running +the pigpio daemon. It may be NULL in which case localhost +is used unless overridden by the PIGPIO_ADDR environment +variable. + +arg1:: +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +arg2:: +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +argc:: +The count of bytes passed to a user customised function. + +*argx:: +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +baud:: +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +bit:: +A value of 0 or 1. + +bits:: +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +A convenient way to set bit n is to or in (1<=0, as returned by a call to [*callback*] or [*callback_ex*]. This is +passed to [*callback_cancel*] to cancel the callback. + +CBFunc_t:: +. . +typedef void (*CBFunc_t) + (unsigned user_gpio, unsigned level, uint32_t tick); +. . + +CBFuncEx_t:: +. . +typedef void (*CBFuncEx_t) + (unsigned user_gpio, unsigned level, uint32_t tick, void * user); +. . + +char:: +A single character, an 8 bit quantity able to store 0-255. + +clkfreq::4689-250000000 (250M) +The hardware clock frequency. + +count:: +The number of bytes to be transferred in an I2C, SPI, or Serial +command. + +data_bits::1-32 +The number of data bits in each character of serial data. + +. . +#define PI_MIN_WAVE_DATABITS 1 +#define PI_MAX_WAVE_DATABITS 32 +. . + +double:: +A floating point number. + +dutycycle::0-range +A number representing the ratio of on time to off time for PWM. + +The number may vary between 0 and range (default 255) where +0 is off and range is fully on. + +edge:: +Used to identify a GPIO level transition of interest. A rising edge is +a level change from 0 to 1. A falling edge is a level change from 1 to 0. + +. . +RISING_EDGE 0 +FALLING_EDGE 1 +EITHER_EDGE. 2 +. . + +errnum:: +A negative number indicating a function call failed and the nature +of the error. + +f:: +A function. + +frequency::>=0 +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + + +gpio:: +A Broadcom numbered GPIO, in the range 0-53. + +There are 54 General Purpose Input Outputs (GPIO) named gpio0 through +gpio53. + +They are split into two banks. Bank 1 consists of gpio0 through +gpio31. Bank 2 consists of gpio32 through gpio53. + +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +See [*get_hardware_revision*]. + +The user GPIO are marked with an X in the following table. + +. . + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +Type 1 X X - - X - - X X X X X - - X X +Type 2 - - X X X - - X X X X X - - X X +Type 3 X X X X X X X X X X X X X X + + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +Type 1 - X X - - X X X X X - - - - - - +Type 2 - X X - - - X X X X - X X X X X +Type 3 X X X X X X X X X X X X - - - - +. . + +gpioPulse_t:: +. . +typedef struct +{ +uint32_t gpioOn; +uint32_t gpioOff; +uint32_t usDelay; +} gpioPulse_t; +. . + +gpioThreadFunc_t:: +. . +typedef void *(gpioThreadFunc_t) (void *); +. . + +handle::>=0 +A number referencing an object opened by one of [*i2c_open*], [*notify_open*], +[*serial_open*], and [*spi_open*]. + +i2c_addr:: 0-0x7F +The address of a device on the I2C bus. + +i2c_bus::>=0 +An I2C bus number. + +i2c_flags::0 +Flags which modify an I2C open command. None are currently defined. + +i2c_reg:: 0-255 +A register of an I2C device. + +*inBuf:: +A buffer used to pass data to a function. + +inLen:: +The number of bytes of data in a buffer. + +int:: +A whole number, negative or positive. + +invert:: +A flag used to set normal or inverted bit bang serial data level logic. + +level:: +The level of a GPIO. Low or High. + +. . +PI_OFF 0 +PI_ON 1 + +PI_CLEAR 0 +PI_SET 1 + +PI_LOW 0 +PI_HIGH 1 +. . + +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See [*set_watchdog*]. + +. . +PI_TIMEOUT 2 +. . + +mode::0-7 +The operational mode of a GPIO, normally INPUT or OUTPUT. + +. . +PI_INPUT 0 +PI_OUTPUT 1 +PI_ALT0 4 +PI_ALT1 5 +PI_ALT2 6 +PI_ALT3 7 +PI_ALT4 3 +PI_ALT5 2 +. . + +numBytes:: +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +numPar:: 0-10 +The number of parameters passed to a script. + +numPulses:: +The number of pulses to be added to a waveform. + +offset:: +The associated data starts this number of microseconds from the start of +the waveform. + +*outBuf:: +A buffer used to return data from a function. + +outLen:: +The size in bytes of an output buffer. + +*param:: +An array of script parameters. + +*portStr:: +A string specifying the port address used by the Pi running +the pigpio daemon. It may be NULL in which case "8888" +is used unless overridden by the PIGPIO_PORT environment +variable. + +*pth:: +A thread identifier, returned by [*start_thread*]. + + +pthread_t:: +A thread identifier. + +pud::0-2 +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. +. . +PI_PUD_OFF 0 +PI_PUD_DOWN 1 +PI_PUD_UP 2 +. . + +pulseLen:: +1-100, the length of a trigger pulse in microseconds. + +*pulses:: +An array of pulses to be added to a waveform. + +pulsewidth::0, 500-2500 +. . +PI_SERVO_OFF 0 +PI_MIN_SERVO_PULSEWIDTH 500 +PI_MAX_SERVO_PULSEWIDTH 2500 +. . + +PWMduty::0-1000000 (1M) +The hardware PWM dutycycle. + +. . +#define PI_HW_PWM_RANGE 1000000 +. . + +PWMfreq::1-125000000 (125M) +The hardware PWM frequency. + +. . +#define PI_HW_PWM_MIN_FREQ 1 +#define PI_HW_PWM_MAX_FREQ 125000000 +. . + +range::25-40000 +The permissible dutycycle values are 0-range. +. . +PI_MIN_DUTYCYCLE_RANGE 25 +PI_MAX_DUTYCYCLE_RANGE 40000 +. . + +*retBuf:: +A buffer to hold a number of bytes returned to a used customised function, + +retMax:: +The maximum number of bytes a user customised function should return. + + +*rxBuf:: +A pointer to a buffer to receive data. + +SCL:: +The user GPIO to use for the clock when bit banging I2C. + +*script:: +A pointer to the text of a script. + +script_id:: +An id of a stored script as returned by [*store_script*]. + +SDA:: +The user GPIO to use for data when bit banging I2C. + +seconds:: +The number of seconds. + +ser_flags:: +Flags which modify a serial open command. None are currently defined. + +*ser_tty:: +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +size_t:: +A standard type used to indicate the size of an object in bytes. + +spi_channel:: +A SPI channel, 0-2. + +spi_flags:: +See [*spi_open*]. + +steady :: 0-300000 + +The number of microseconds level changes must be stable for +before reporting the level changed ([*set_glitch_filter*]) or triggering +the active part of a noise filter ([*set_noise_filter*]). + +stop_bits::2-8 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +. . +#define PI_MIN_WAVE_HALFSTOPBITS 2 +#define PI_MAX_WAVE_HALFSTOPBITS 8 +. . + +*str:: + An array of characters. + +thread_func:: +A function of type gpioThreadFunc_t used as the main function of a +thread. + +timeout:: +A GPIO watchdog timeout in milliseconds. +. . +PI_MIN_WDOG_TIMEOUT 0 +PI_MAX_WDOG_TIMEOUT 60000 +. . + +*txBuf:: +An array of bytes to transmit. + +uint32_t::0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF) +A 32-bit unsigned value. + +unsigned:: +A whole number >= 0. + +user_gpio:: +0-31, a Broadcom numbered GPIO. + +See [*gpio*]. + +*userdata:: +A pointer to arbitrary user data. This may be used to identify the instance. + +void:: +Denoting no parameter is required + +wave_add_*:: +One of [*wave_add_new*], [*wave_add_generic*], [*wave_add_serial*]. + +wave_id:: +A number representing a waveform created by [*wave_create*]. + +wave_send_*:: +One of [*wave_send_once*], [*wave_send_repeat*]. + +wVal::0-65535 (Hex 0x0-0xFFFF, Octal 0-0177777) +A 16-bit word value. + +PARAMS*/ + +/*DEF_S pigpiod_if Error Codes*/ + +typedef enum +{ + pigif_bad_send = -2000, + pigif_bad_recv = -2001, + pigif_bad_getaddrinfo = -2002, + pigif_bad_connect = -2003, + pigif_bad_socket = -2004, + pigif_bad_noib = -2005, + pigif_duplicate_callback = -2006, + pigif_bad_malloc = -2007, + pigif_bad_callback = -2008, + pigif_notify_failed = -2009, + pigif_callback_not_found = -2010, +} pigifError_t; + +/*DEF_E*/ + +#ifdef __cplusplus +} +#endif + +#endif + diff --git a/pigpio-master/pigpiod_if2.3 b/pigpio-master/pigpiod_if2.3 new file mode 100644 index 0000000..1f55ee5 --- /dev/null +++ b/pigpio-master/pigpiod_if2.3 @@ -0,0 +1,8069 @@ + +." Process this file with +." groff -man -Tascii pigpiod_if2.3 +." +.TH pigpiod_if2 3 2012-2020 Linux "pigpio archive" +.SH NAME +pigpiod_if2 - A C library to interface to the pigpio daemon. + +.SH SYNOPSIS + +#include + + +gcc -Wall -pthread -o prog prog.c -lpigpiod_if2 -lrt + + ./prog +.SH DESCRIPTION + + +.ad l + +.nh + +.br + +.br +pigpiod_if2 is a C library for the Raspberry which allows control +of the GPIO via the socket interface to the pigpio daemon. +.br + +.br + +.br +.SS Features +.br + +.br +o hardware timed PWM on any of GPIO 0-31 + +.br + +.br +o hardware timed servo pulses on any of GPIO 0-31 + +.br + +.br +o callbacks when any of GPIO 0-31 change state + +.br + +.br +o callbacks at timed intervals + +.br + +.br +o reading/writing all of the GPIO in a bank as one operation + +.br + +.br +o individually setting GPIO modes, reading and writing + +.br + +.br +o notifications when any of GPIO 0-31 change state + +.br + +.br +o the construction of output waveforms with microsecond timing + +.br + +.br +o rudimentary permission control over GPIO + +.br + +.br +o a simple interface to start and stop new threads + +.br + +.br +o I2C, SPI, and serial link wrappers + +.br + +.br +o creating and running scripts on the pigpio daemon + +.br + +.br +.SS GPIO +.br + +.br +ALL GPIO are identified by their Broadcom number. + +.br + +.br +.SS Notes +.br + +.br +The PWM and servo pulses are timed using the DMA and PWM/PCM peripherals. + +.br + +.br +.SS Usage +.br + +.br +Include in your source files. + +.br + +.br +Assuming your source is in prog.c use the following command to build + +.br + +.br + +.EX +gcc -Wall -pthread -o prog prog.c -lpigpiod_if2 -lrt +.br + +.EE + +.br + +.br +to run make sure the pigpio daemon is running + +.br + +.br + +.EX +sudo pigpiod +.br + +.br + ./prog # sudo is not required to run programs linked to pigpiod_if2 +.br + +.EE + +.br + +.br +For examples see x_pigpiod_if2.c within the pigpio archive file. + +.br + +.br +.SS Notes +.br + +.br +All the functions which return an int return < 0 on error + +.br + +.br + +.SH OVERVIEW + +.br +.SS ESSENTIAL +.br + +.br +pigpio_start Connects to a pigpio daemon +.br +pigpio_stop Disconnects from a pigpio daemon +.br +.SS BASIC +.br + +.br +set_mode Set a GPIO mode +.br +get_mode Get a GPIO mode +.br + +.br +set_pull_up_down Set/clear GPIO pull up/down resistor +.br + +.br +gpio_read Read a GPIO +.br +gpio_write Write a GPIO +.br +.SS PWM (overrides servo commands on same GPIO) +.br + +.br +set_PWM_dutycycle Start/stop PWM pulses on a GPIO +.br +set_PWM_frequency Configure PWM frequency for a GPIO +.br +set_PWM_range Configure PWM range for a GPIO +.br + +.br +get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO +.br +get_PWM_frequency Get configured PWM frequency for a GPIO +.br +get_PWM_range Get configured PWM range for a GPIO +.br + +.br +get_PWM_real_range Get underlying PWM range for a GPIO +.br +.SS Servo (overrides PWM commands on same GPIO) +.br + +.br +set_servo_pulsewidth Start/stop servo pulses on a GPIO +.br + +.br +get_servo_pulsewidth Get the servo pulsewidth in use on a GPIO +.br +.SS INTERMEDIATE +.br + +.br +gpio_trigger Send a trigger pulse to a GPIO. +.br + +.br +set_watchdog Set a watchdog on a GPIO. +.br + +.br +read_bank_1 Read all GPIO in bank 1 +.br +read_bank_2 Read all GPIO in bank 2 +.br + +.br +clear_bank_1 Clear selected GPIO in bank 1 +.br +clear_bank_2 Clear selected GPIO in bank 2 +.br + +.br +set_bank_1 Set selected GPIO in bank 1 +.br +set_bank_2 Set selected GPIO in bank 2 +.br + +.br +callback Create GPIO level change callback +.br +callback_ex Create GPIO level change callback, extended +.br + +.br +callback_cancel Cancel a callback +.br + +.br +wait_for_edge Wait for GPIO level change +.br + +.br +start_thread Start a new thread +.br +stop_thread Stop a previously started thread +.br +.SS ADVANCED +.br + +.br +notify_open Request a notification handle +.br +notify_begin Start notifications for selected GPIO +.br +notify_pause Pause notifications +.br +notify_close Close a notification +.br + +.br +hardware_clock Start hardware clock on supported GPIO +.br + +.br +hardware_PWM Start hardware PWM on supported GPIO +.br + +.br +set_glitch_filter Set a glitch filter on a GPIO +.br +set_noise_filter Set a noise filter on a GPIO +.br + +.br +set_pad_strength Sets a pads drive strength +.br +get_pad_strength Gets a pads drive strength +.br + +.br +shell_ Executes a shell command +.br +.SS Custom +.br + +.br +custom_1 User custom function 1 +.br +custom_2 User custom function 2 +.br +.SS Events +.br + +.br +event_callback Sets a callback for an event +.br +event_callback_ex Sets a callback for an event, extended +.br + +.br +event_callback_cancel Cancel an event callback +.br + +.br +event_trigger Triggers an event +.br + +.br +wait_for_event Wait for an event +.br +.SS Scripts +.br + +.br +store_script Store a script +.br +run_script Run a stored script +.br +update_script Set a scripts parameters +.br +script_status Get script status and parameters +.br +stop_script Stop a running script +.br +delete_script Delete a stored script +.br +.SS I2C +.br + +.br +i2c_open Opens an I2C device +.br +i2c_close Closes an I2C device +.br + +.br +i2c_write_quick smbus write quick +.br + +.br +i2c_read_byte smbus read byte +.br +i2c_write_byte smbus write byte +.br + +.br +i2c_read_byte_data smbus read byte data +.br +i2c_write_byte_data smbus write byte data +.br + +.br +i2c_read_word_data smbus read word data +.br +i2c_write_word_data smbus write word data +.br + +.br +i2c_read_block_data smbus read block data +.br +i2c_write_block_data smbus write block data +.br + +.br +i2c_read_i2c_block_data smbus read I2C block data +.br +i2c_write_i2c_block_data smbus write I2C block data +.br + +.br +i2c_read_device Reads the raw I2C device +.br +i2c_write_device Writes the raw I2C device +.br + +.br +i2c_process_call smbus process call +.br +i2c_block_process_call smbus block process call +.br + +.br +i2c_zip Performs multiple I2C transactions +.br +.SS I2C BIT BANG +.br + +.br +bb_i2c_open Opens GPIO for bit banging I2C +.br +bb_i2c_close Closes GPIO for bit banging I2C +.br + +.br +bb_i2c_zip Performs bit banged I2C transactions +.br +.SS I2C/SPI SLAVE +.br + +.br +bsc_xfer I2C/SPI as slave transfer +.br +bsc_i2c I2C as slave transfer +.br +.SS SERIAL +.br + +.br +serial_open Opens a serial device +.br +serial_close Closes a serial device +.br + +.br +serial_read_byte Reads a byte from a serial device +.br +serial_write_byte Writes a byte to a serial device +.br + +.br +serial_read Reads bytes from a serial device +.br +serial_write Writes bytes to a serial device +.br + +.br +serial_data_available Returns number of bytes ready to be read +.br +.SS SERIAL BIT BANG (read only) +.br + +.br +bb_serial_read_open Opens a GPIO for bit bang serial reads +.br +bb_serial_read_close Closes a GPIO for bit bang serial reads +.br + +.br +bb_serial_invert Invert serial logic (1 invert, 0 normal) +.br + +.br +bb_serial_read Reads bit bang serial data from a GPIO +.br +.SS SPI +.br + +.br +spi_open Opens a SPI device +.br +spi_close Closes a SPI device +.br + +.br +spi_read Reads bytes from a SPI device +.br +spi_write Writes bytes to a SPI device +.br +spi_xfer Transfers bytes with a SPI device +.br +.SS SPI BIT BANG +.br + +.br +bb_spi_open Opens GPIO for bit banging SPI +.br +bb_spi_close Closes GPIO for bit banging SPI +.br + +.br +bb_spi_xfer Transfers bytes with bit banging SPI +.br +.SS FILES +.br + +.br +file_open Opens a file +.br +file_close Closes a file +.br + +.br +file_read Reads bytes from a file +.br +file_write Writes bytes to a file +.br + +.br +file_seek Seeks to a position within a file +.br + +.br +file_list List files which match a pattern +.br +.SS WAVES +.br + +.br +wave_clear Deletes all waveforms +.br + +.br +wave_add_new Starts a new waveform +.br +wave_add_generic Adds a series of pulses to the waveform +.br +wave_add_serial Adds serial data to the waveform +.br + +.br +wave_create Creates a waveform from added data +.br +wave_create_and_pad Creates a waveform of fixed size from added data +.br +wave_delete Deletes one or more waveforms +.br + +.br +wave_send_once Transmits a waveform once +.br +wave_send_repeat Transmits a waveform repeatedly +.br +wave_send_using_mode Transmits a waveform in the chosen mode +.br + +.br +wave_chain Transmits a chain of waveforms +.br + +.br +wave_tx_at Returns the current transmitting waveform +.br + +.br +wave_tx_busy Checks to see if the waveform has ended +.br + +.br +wave_tx_stop Aborts the current waveform +.br + +.br +wave_get_cbs Length in cbs of the current waveform +.br +wave_get_high_cbs Length of longest waveform so far +.br +wave_get_max_cbs Absolute maximum allowed cbs +.br + +.br +wave_get_micros Length in micros of the current waveform +.br +wave_get_high_micros Length of longest waveform so far +.br +wave_get_max_micros Absolute maximum allowed micros +.br + +.br +wave_get_pulses Length in pulses of the current waveform +.br +wave_get_high_pulses Length of longest waveform so far +.br +wave_get_max_pulses Absolute maximum allowed pulses +.br +.SS UTILITIES +.br + +.br +get_current_tick Get current tick (microseconds) +.br + +.br +get_hardware_revision Get hardware revision +.br +get_pigpio_version Get the pigpio version +.br +pigpiod_if_version Get the pigpiod_if2 version +.br + +.br +pigpio_error Get a text description of an error code. +.br + +.br +time_sleep Sleeps for a float number of seconds +.br +time_time Float number of seconds since the epoch +.br +.SH FUNCTIONS + +.IP "\fBdouble time_time(void)\fP" +.IP "" 4 +Return the current time in seconds since the Epoch. + +.IP "\fBvoid time_sleep(double seconds)\fP" +.IP "" 4 +Delay execution for a given number of seconds. + +.br + +.br + +.EX +seconds: the number of seconds to delay. +.br + +.EE + +.IP "\fBchar *pigpio_error(int errnum)\fP" +.IP "" 4 +Return a text description for an error code. + +.br + +.br + +.EX +errnum: the error code. +.br + +.EE + +.IP "\fBunsigned pigpiod_if_version(void)\fP" +.IP "" 4 +Return the pigpiod_if2 version. + +.IP "\fBpthread_t *start_thread(gpioThreadFunc_t thread_func, void *userdata)\fP" +.IP "" 4 +Starts a new thread of execution with thread_func as the main routine. + +.br + +.br + +.EX +thread_func: the main function for the new thread. +.br + userdata: a pointer to an arbitrary argument. +.br + +.EE + +.br + +.br +Returns a pointer to pthread_t if OK, otherwise NULL. + +.br + +.br +The function is passed the single argument userdata. + +.br + +.br +The thread can be cancelled by passing the pointer to pthread_t to +\fBstop_thread\fP. + +.IP "\fBvoid stop_thread(pthread_t *pth)\fP" +.IP "" 4 +Cancels the thread pointed at by pth. + +.br + +.br + +.EX +pth: the thread to be stopped. +.br + +.EE + +.br + +.br +No value is returned. + +.br + +.br +The thread to be stopped should have been started with \fBstart_thread\fP. + +.IP "\fBint pigpio_start(const char *addrStr, const char *portStr)\fP" +.IP "" 4 +Connect to the pigpio daemon. Reserving command and +notification streams. + +.br + +.br + +.EX +addrStr: specifies the host or IP address of the Pi running the +.br + pigpio daemon. It may be NULL in which case localhost +.br + is used unless overridden by the PIGPIO_ADDR environment +.br + variable. +.br + +.br +portStr: specifies the port address used by the Pi running the +.br + pigpio daemon. It may be NULL in which case "8888" +.br + is used unless overridden by the PIGPIO_PORT environment +.br + variable. +.br + +.EE + +.br + +.br +Returns an integer value greater than or equal to zero if OK. + +.br + +.br +This value is passed to the GPIO routines to specify the Pi +to be operated on. + +.IP "\fBvoid pigpio_stop(int pi)\fP" +.IP "" 4 +Terminates the connection to a pigpio daemon and releases +resources used by the library. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint set_mode(int pi, unsigned gpio, unsigned mode)\fP" +.IP "" 4 +Set the GPIO mode. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +gpio: 0-53. +.br +mode: PI_INPUT, PI_OUTPUT, PI_ALT0, PI_ALT1, +.br + PI_ALT2, PI_ALT3, PI_ALT4, PI_ALT5. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_MODE, +or PI_NOT_PERMITTED. + +.IP "\fBint get_mode(int pi, unsigned gpio)\fP" +.IP "" 4 +Get the GPIO mode. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +gpio: 0-53. +.br + +.EE + +.br + +.br +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. + +.IP "\fBint set_pull_up_down(int pi, unsigned gpio, unsigned pud)\fP" +.IP "" 4 +Set or clear the GPIO pull-up/down resistor. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +gpio: 0-53. +.br + pud: PI_PUD_UP, PI_PUD_DOWN, PI_PUD_OFF. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_PUD, +or PI_NOT_PERMITTED. + +.IP "\fBint gpio_read(int pi, unsigned gpio)\fP" +.IP "" 4 +Read the GPIO level. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +gpio:0-53. +.br + +.EE + +.br + +.br +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. + +.IP "\fBint gpio_write(int pi, unsigned gpio, unsigned level)\fP" +.IP "" 4 +Write the GPIO level. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + gpio: 0-53. +.br +level: 0, 1. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_LEVEL, +or PI_NOT_PERMITTED. + +.br + +.br +Notes + +.br + +.br +If PWM or servo pulses are active on the GPIO they are switched off. + +.IP "\fBint set_PWM_dutycycle(int pi, unsigned user_gpio, unsigned dutycycle)\fP" +.IP "" 4 +Start (non-zero dutycycle) or stop (0) PWM pulses on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br +dutycycle: 0-range (range defaults to 255). +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYCYCLE, +or PI_NOT_PERMITTED. +Notes + +.br + +.br +The \fBset_PWM_range\fP function may be used to change the +default range of 255. + +.IP "\fBint get_PWM_dutycycle(int pi, unsigned user_gpio)\fP" +.IP "" 4 +Return the PWM dutycycle in use on a GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns current PWM dutycycle if OK, +otherwise PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +.br + +.br +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see \fBget_PWM_range\fP). + +.br + +.br +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +.IP "\fBint set_PWM_range(int pi, unsigned user_gpio, unsigned range)\fP" +.IP "" 4 +Set the range of PWM values to be used on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + range: 25-40000. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYRANGE, +or PI_NOT_PERMITTED. + +.br + +.br +Notes + +.br + +.br +If PWM is currently active on the GPIO its dutycycle will be +scaled to reflect the new range. + +.br + +.br +The real range, the number of steps between fully off and fully on +for each of the 18 available GPIO frequencies is + +.br + +.br + +.EX + 25(#1), 50(#2), 100(#3), 125(#4), 200(#5), 250(#6), +.br + 400(#7), 500(#8), 625(#9), 800(#10), 1000(#11), 1250(#12), +.br +2000(#13), 2500(#14), 4000(#15), 5000(#16), 10000(#17), 20000(#18) +.br + +.EE + +.br + +.br +The real value set by set_PWM_range is (dutycycle * real range) / range. + +.IP "\fBint get_PWM_range(int pi, unsigned user_gpio)\fP" +.IP "" 4 +Get the range of PWM values being used on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns the dutycycle range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.br + +.br +If a hardware clock or hardware PWM is active on the GPIO the +reported range will be 1000000 (1M). + +.IP "\fBint get_PWM_real_range(int pi, unsigned user_gpio)\fP" +.IP "" 4 +Get the real underlying range of PWM values being used on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns the real range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.br + +.br +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +.br + +.br +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +.br + +.br + +.IP "\fBint set_PWM_frequency(int pi, unsigned user_gpio, unsigned frequency)\fP" +.IP "" 4 +Set the frequency (in Hz) of the PWM to be used on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br +frequency: >=0 (Hz). +.br + +.EE + +.br + +.br +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PERMITTED. + +.br + +.br +If PWM is currently active on the GPIO it will be switched +off and then back on at the new frequency. + +.br + +.br +Each GPIO can be independently set to one of 18 different +PWM frequencies. + +.br + +.br +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +.br + +.br +The frequencies for each sample rate are: + +.br + +.br + +.EX + Hertz +.br + +.br + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 +.br + 1250 1000 800 500 400 250 200 100 50 +.br + +.br + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 +.br + 625 500 400 250 200 125 100 50 25 +.br + +.br + 4: 10000 5000 2500 2000 1250 1000 625 500 400 +.br + 313 250 200 125 100 63 50 25 13 +.br +sample +.br + rate +.br + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 +.br + 250 200 160 100 80 50 40 20 10 +.br + +.br + 8: 5000 2500 1250 1000 625 500 313 250 200 +.br + 156 125 100 63 50 31 25 13 6 +.br + +.br + 10: 4000 2000 1000 800 500 400 250 200 160 +.br + 125 100 80 50 40 25 20 10 5 +.br + +.EE + +.IP "\fBint get_PWM_frequency(int pi, unsigned user_gpio)\fP" +.IP "" 4 +Get the frequency of PWM being used on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + +.EE + +.br + +.br +For normal PWM the frequency will be that defined for the GPIO by +\fBset_PWM_frequency\fP. + +.br + +.br +If a hardware clock is active on the GPIO the reported frequency +will be that set by \fBhardware_clock\fP. + +.br + +.br +If hardware PWM is active on the GPIO the reported frequency +will be that set by \fBhardware_PWM\fP. + +.br + +.br +Returns the frequency (in hertz) used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +.IP "\fBint set_servo_pulsewidth(int pi, unsigned user_gpio, unsigned pulsewidth)\fP" +.IP "" 4 +Start (500-2500) or stop (0) servo pulses on the GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + user_gpio: 0-31. +.br +pulsewidth: 0 (off), 500 (anti-clockwise) - 2500 (clockwise). +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_PULSEWIDTH or +PI_NOT_PERMITTED. + +.br + +.br +The selected pulsewidth will continue to be transmitted until +changed by a subsequent call to set_servo_pulsewidth. + +.br + +.br +The pulsewidths supported by servos varies and should probably be +determined by experiment. A value of 1500 should always be safe and +represents the mid-point of rotation. + +.br + +.br +You can DAMAGE a servo if you command it to move beyond its limits. + +.br + +.br +OTHER UPDATE RATES: + +.br + +.br +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +.br + +.br + +.EX +Update Rate (Hz) 50 100 200 400 500 +.br +1E6/Hz 20000 10000 5000 2500 2000 +.br + +.EE + +.br + +.br +Firstly set the desired PWM frequency using \fBset_PWM_frequency\fP. + +.br + +.br +Then set the PWM range using \fBset_PWM_range\fP to 1E6/Hz. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +.br + +.br +E.g. If you want to update a servo connected to GPIO 25 at 400Hz + +.br + +.br + +.EX +set_PWM_frequency(25, 400); +.br +set_PWM_range(25, 2500); +.br + +.EE + +.br + +.br +Thereafter use the \fBset_PWM_dutycycle\fP function to move the servo, +e.g. set_PWM_dutycycle(25, 1500) will set a 1500 us pulse. +.br + +.IP "\fBint get_servo_pulsewidth(int pi, unsigned user_gpio)\fP" +.IP "" 4 +Return the servo pulsewidth in use on a GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. + +.IP "\fBint notify_open(int pi)\fP" +.IP "" 4 +Get a free notification handle. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +.br + +.br +A notification is a method for being notified of GPIO state +changes via a pipe. + +.br + +.br +Pipes are only accessible from the local machine so this function +serves no purpose if you are using the library from a remote machine. +The in-built (socket) notifications provided by \fBcallback\fP +should be used instead. + +.br + +.br +Notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). +E.g. if the function returns 15 then the notifications must be +read from /dev/pigpio15. + +.IP "\fBint notify_begin(int pi, unsigned handle, uint32_t bits)\fP" +.IP "" 4 +Start notifications on a previously opened handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: 0-31 (as returned by \fBnotify_open\fP) +.br + bits: a mask indicating the GPIO to be notified. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +The notification sends state changes for each GPIO whose +corresponding bit in bits is set. + +.br + +.br +Each notification occupies 12 bytes in the fifo as follows: + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint16_t seqno; +.br + uint16_t flags; +.br + uint32_t tick; +.br + uint32_t level; +.br +} gpioReport_t; +.br + +.EE + +.br + +.br +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +.br + +.br +flags: three flags are defined, PI_NTFY_FLAGS_WDOG, +PI_NTFY_FLAGS_ALIVE, and PI_NTFY_FLAGS_EVENT. + +.br + +.br +If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +.br + +.br +If bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +.br + +.br +If bit 7 is set (PI_NTFY_FLAGS_EVENT) then bits 0-4 of the flags +indicate an event which has been triggered. + +.br + +.br +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +.br + +.br +level: indicates the level of each GPIO. If bit 1<=0 (as returned by \fBpigpio_start\fP). +.br +handle: 0-31 (as returned by \fBnotify_open\fP) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +Notifications for the handle are suspended until +\fBnotify_begin\fP is called again. + +.IP "\fBint notify_close(int pi, unsigned handle)\fP" +.IP "" 4 +Stop notifications on a previously opened handle and +release the handle for reuse. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: 0-31 (as returned by \fBnotify_open\fP) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint set_watchdog(int pi, unsigned user_gpio, unsigned timeout)\fP" +.IP "" 4 +Sets a watchdog for a GPIO. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + timeout: 0-60000. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO +or PI_BAD_WDOG_TIMEOUT. + +.br + +.br +The watchdog is nominally in milliseconds. + +.br + +.br +Only one watchdog may be registered per GPIO. + +.br + +.br +The watchdog may be cancelled by setting timeout to 0. + +.br + +.br +Once a watchdog has been started callbacks for the GPIO will be +triggered every timeout interval after the last GPIO activity. + +.br + +.br +The callback will receive the special level PI_TIMEOUT. + +.IP "\fBint set_glitch_filter(int pi, unsigned user_gpio, unsigned steady)\fP" +.IP "" 4 +Sets a glitch filter on a GPIO. + +.br + +.br +Level changes on the GPIO are not reported unless the level +has been stable for at least \fBsteady\fP microseconds. The +level is then reported. Level changes of less than +\fBsteady\fP microseconds are ignored. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31 +.br + steady: 0-300000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +.br + +.br +This filter affects the GPIO samples returned to callbacks set up +with \fBcallback\fP, \fBcallback_ex\fP and \fBwait_for_edge\fP. + +.br + +.br +It does not affect levels read by \fBgpio_read\fP, +\fBread_bank_1\fP, or \fBread_bank_2\fP. + +.br + +.br +Each (stable) edge will be timestamped \fBsteady\fP microseconds +after it was first detected. + +.IP "\fBint set_noise_filter(int pi, unsigned user_gpio, unsigned steady, unsigned active)\fP" +.IP "" 4 +Sets a noise filter on a GPIO. + +.br + +.br +Level changes on the GPIO are ignored until a level which has +been stable for \fBsteady\fP microseconds is detected. Level changes +on the GPIO are then reported for \fBactive\fP microseconds after +which the process repeats. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31 +.br + steady: 0-300000 +.br + active: 0-1000000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +.br + +.br +This filter affects the GPIO samples returned to callbacks set up +with \fBcallback\fP, \fBcallback_ex\fP and \fBwait_for_edge\fP. + +.br + +.br +It does not affect levels read by \fBgpio_read\fP, +\fBread_bank_1\fP, or \fBread_bank_2\fP. + +.br + +.br +Level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. + +.IP "\fBuint32_t read_bank_1(int pi)\fP" +.IP "" 4 +Read the levels of the bank 1 GPIO (GPIO 0-31). + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +The returned 32 bit integer has a bit set if the corresponding +GPIO is logic 1. GPIO n has bit value (1<=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +The returned 32 bit integer has a bit set if the corresponding +GPIO is logic 1. GPIO n has bit value (1<<(n-32)). + +.IP "\fBint clear_bank_1(int pi, uint32_t bits)\fP" +.IP "" 4 +Clears GPIO 0-31 if the corresponding bit in bits is set. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +bits: a bit mask with 1 set if the corresponding GPIO is +.br + to be cleared. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +.br + +.br +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. + +.IP "\fBint clear_bank_2(int pi, uint32_t bits)\fP" +.IP "" 4 +Clears GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +bits: a bit mask with 1 set if the corresponding GPIO is +.br + to be cleared. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +.br + +.br +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. + +.IP "\fBint set_bank_1(int pi, uint32_t bits)\fP" +.IP "" 4 +Sets GPIO 0-31 if the corresponding bit in bits is set. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +bits: a bit mask with 1 set if the corresponding GPIO is +.br + to be set. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +.br + +.br +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. + +.IP "\fBint set_bank_2(int pi, uint32_t bits)\fP" +.IP "" 4 +Sets GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +bits: a bit mask with 1 set if the corresponding GPIO is +.br + to be set. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +.br + +.br +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. + +.IP "\fBint hardware_clock(int pi, unsigned gpio, unsigned clkfreq)\fP" +.IP "" 4 +Starts a hardware clock on a GPIO at the specified frequency. +Frequencies above 30MHz are unlikely to work. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + gpio: see description +.br +frequency: 0 (off) or 4689-250M (13184-375M for the BCM2711) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_NOT_PERMITTED, PI_BAD_GPIO, +PI_NOT_HCLK_GPIO, PI_BAD_HCLK_FREQ,or PI_BAD_HCLK_PASS. + +.br + +.br +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +.br + +.br +The GPIO must be one of the following. + +.br + +.br + +.EX +4 clock 0 All models +.br +5 clock 1 All models but A and B (reserved for system use) +.br +6 clock 2 All models but A and B +.br +20 clock 0 All models but A and B +.br +21 clock 1 All models but A and Rev.2 B (reserved for system use) +.br + +.br +32 clock 0 Compute module only +.br +34 clock 0 Compute module only +.br +42 clock 1 Compute module only (reserved for system use) +.br +43 clock 2 Compute module only +.br +44 clock 1 Compute module only (reserved for system use) +.br + +.EE + +.br + +.br +Access to clock 1 is protected by a password as its use will likely +crash the Pi. The password is given by or'ing 0x5A000000 with the +GPIO number. + +.IP "\fBint hardware_PWM(int pi, unsigned gpio, unsigned PWMfreq, uint32_t PWMduty)\fP" +.IP "" 4 +Starts hardware PWM on a GPIO at the specified frequency and dutycycle. +Frequencies above 30MHz are unlikely to work. + +.br + +.br +NOTE: Any waveform started by \fBwave_send_*\fP or \fBwave_chain\fP +will be cancelled. + +.br + +.br +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden when the pigpio +daemon is started (option -t). + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + gpio: see descripton +.br +PWMfreq: 0 (off) or 1-125M (1-187.5M for the BCM2711) +.br +PWMduty: 0 (off) to 1000000 (1M)(fully on) +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_NOT_PERMITTED, PI_BAD_GPIO, +PI_NOT_HPWM_GPIO, PI_BAD_HPWM_DUTY, PI_BAD_HPWM_FREQ, +or PI_HPWM_ILLEGAL. + +.br + +.br +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +.br + +.br +The GPIO must be one of the following. + +.br + +.br + +.EX +12 PWM channel 0 All models but A and B +.br +13 PWM channel 1 All models but A and B +.br +18 PWM channel 0 All models +.br +19 PWM channel 1 All models but A and B +.br + +.br +40 PWM channel 0 Compute module only +.br +41 PWM channel 1 Compute module only +.br +45 PWM channel 1 Compute module only +.br +52 PWM channel 0 Compute module only +.br +53 PWM channel 1 Compute module only +.br + +.EE + +.br + +.br +The actual number of steps beween off and fully on is the +integral part of 250M/PWMfreq (375M/PWMfreq for the BCM2711). + +.br + +.br +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +.br + +.br +There will only be a million steps for a PWMfreq of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. PWMduty is +automatically scaled to take this into account. + +.IP "\fBuint32_t get_current_tick(int pi)\fP" +.IP "" 4 +Gets the current system tick. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Tick is the number of microseconds since system boot. + +.br + +.br +As tick is an unsigned 32 bit quantity it wraps around after +2**32 microseconds, which is approximately 1 hour 12 minutes. + +.br + +.br + +.IP "\fBuint32_t get_hardware_revision(int pi)\fP" +.IP "" 4 +Get the Pi's hardware revision number. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +The hardware revision is the last few characters on the Revision line +of /proc/cpuinfo. + +.br + +.br +If the hardware revision can not be found or is not a valid +hexadecimal number the function returns 0. + +.br + +.br +The revision number can be used to determine the assignment of GPIO +to pins (see \fBgpio\fP). + +.br + +.br +There are at least three types of board. + +.br + +.br +Type 1 boards have hardware revision numbers of 2 and 3. + +.br + +.br +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +.br + +.br +Type 3 boards have hardware revision numbers of 16 or greater. + +.IP "\fBuint32_t get_pigpio_version(int pi)\fP" +.IP "" 4 +Returns the pigpio version. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_clear(int pi)\fP" +.IP "" 4 +This function clears all waveforms and any data added by calls to the +\fBwave_add_*\fP functions. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.IP "\fBint wave_add_new(int pi)\fP" +.IP "" 4 +This function starts a new empty waveform. You wouldn't normally need +to call this function as it is automatically called after a waveform is +created with the \fBwave_create\fP function. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.IP "\fBint wave_add_generic(int pi, unsigned numPulses, gpioPulse_t *pulses)\fP" +.IP "" 4 +This function adds a number of pulses to the current waveform. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +numPulses: the number of pulses. +.br + pulses: an array of pulses. +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +.br + +.br +The pulses are interleaved in time order within the existing waveform +(if any). + +.br + +.br +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +.br + +.br +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist solely of a delay. + +.IP "\fBint wave_add_serial(int pi, unsigned user_gpio, unsigned baud, unsigned data_bits, unsigned stop_bits, unsigned offset, unsigned numBytes, char *str)\fP" +.IP "" 4 +This function adds a waveform representing serial data to the +existing waveform (if any). The serial data starts offset +microseconds from the start of the waveform. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + baud: 50-1000000 +.br +data_bits: number of data bits (1-32) +.br +stop_bits: number of stop half bits (2-8) +.br + offset: >=0 +.br + numBytes: >=1 +.br + str: an array of chars. +.br + +.EE + +.br + +.br +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOP_BITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +.br + +.br +NOTES: + +.br + +.br +The serial data is formatted as one start bit, \fBdata_bits\fP data bits, +and \fBstop_bits\fP/2 stop bits. + +.br + +.br +It is legal to add serial data streams with different baud rates to +the same waveform. + +.br + +.br +\fBnumBytes\fP is the number of bytes of data in str. + +.br + +.br +The bytes required for each character depend upon \fBdata_bits\fP. + +.br + +.br +For \fBdata_bits\fP 1-8 there will be one byte per character. +.br +For \fBdata_bits\fP 9-16 there will be two bytes per character. +.br +For \fBdata_bits\fP 17-32 there will be four bytes per character. + +.IP "\fBint wave_create(int pi)\fP" +.IP "" 4 +This function creates a waveform from the data provided by the prior +calls to the \fBwave_add_*\fP functions. Upon success a wave id +greater than or equal to 0 is returned, otherwise PI_EMPTY_WAVEFORM, +PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +The data provided by the \fBwave_add_*\fP functions is consumed by this +function. + +.br + +.br +As many waveforms may be created as there is space available. The +wave id is passed to \fBwave_send_*\fP to specify the waveform to transmit. + +.br + +.br +Normal usage would be + +.br + +.br +Step 1. \fBwave_clear\fP to clear all waveforms and added data. + +.br + +.br +Step 2. \fBwave_add_*\fP calls to supply the waveform data. + +.br + +.br +Step 3. \fBwave_create\fP to create the waveform and get a unique id + +.br + +.br +Repeat steps 2 and 3 as needed. + +.br + +.br +Step 4. \fBwave_send_*\fP with the id of the waveform to transmit. + +.br + +.br +A waveform comprises one or more pulses. Each pulse consists of a +\fBgpioPulse_t\fP structure. + +.br + +.br + +.EX +typedef struct +.br +{ +.br + uint32_t gpioOn; +.br + uint32_t gpioOff; +.br + uint32_t usDelay; +.br +} gpioPulse_t; +.br + +.EE + +.br + +.br +The fields specify + +.br + +.br +1) the GPIO to be switched on at the start of the pulse. +.br +2) the GPIO to be switched off at the start of the pulse. +.br +3) the delay in microseconds before the next pulse. +.br + +.br + +.br +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +.br + +.br +When a waveform is started each pulse is executed in order with the +specified delay between the pulse and the next. + +.br + +.br +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. + +.IP "\fBint wave_create_and_pad(int pi, int percent)\fP" +.IP "" 4 +This function creates a waveform like \fBwave_create\fP but pads the consumed +resources. Where percent gives the percentage of the resources to use (in terms +of the theoretical maximum, not the current amount free). This allows the reuse +.br +of deleted waves while a transmission is active. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br +percent: 0-100, size of waveform as percentage of maximum available. +.br + +.EE + +.br + +.br +The data provided by the \fBwave_add_*\fP functions are consumed by this +function. + +.br + +.br +As many waveforms may be created as there is space available. The +wave id is passed to \fBwave_send_*\fP to specify the waveform to transmit. + +.br + +.br +A usage would be the creation of two waves where one is filled while the other +is being transmitted. Each wave is assigned 50% of the resources. +This buffer structure allows the transmission of infinite wave sequences. + +.br + +.br +Normal usage: + +.br + +.br +Step 1. \fBwave_clear\fP to clear all waveforms and added data. + +.br + +.br +Step 2. \fBwave_add_*\fP calls to supply the waveform data. + +.br + +.br +Step 3. \fBwave_create_and_pad\fP to create a waveform of uniform size. + +.br + +.br +Step 4. \fBwave_send_*\fP with the id of the waveform to transmit. + +.br + +.br +Repeat steps 2-4 as needed. + +.br + +.br +Step 5. Any wave id can now be deleted and another wave of the same size + can be created in its place. + +.br + +.br +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. + +.IP "\fBint wave_delete(int pi, unsigned wave_id)\fP" +.IP "" 4 +This function deletes the waveform with id wave_id. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Wave ids are allocated in order, 0, 1, 2, etc. + +.br + +.br +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +.br + +.br +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +.br + +.br +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. + +.IP "\fBint wave_send_once(int pi, unsigned wave_id)\fP" +.IP "" 4 +This function transmits the waveform with id wave_id. The waveform +is sent once. + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint wave_send_repeat(int pi, unsigned wave_id)\fP" +.IP "" 4 +This function transmits the waveform with id wave_id. The waveform +cycles until cancelled (either by the sending of a new waveform or +by \fBwave_tx_stop\fP). + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +wave_id: >=0, as returned by \fBwave_create\fP. +.br + +.EE + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint wave_send_using_mode(int pi, unsigned wave_id, unsigned mode)\fP" +.IP "" 4 +Transmits the waveform with id wave_id using mode mode. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +wave_id: >=0, as returned by \fBwave_create\fP. +.br + mode: PI_WAVE_MODE_ONE_SHOT, PI_WAVE_MODE_REPEAT, +.br + PI_WAVE_MODE_ONE_SHOT_SYNC, or PI_WAVE_MODE_REPEAT_SYNC. +.br + +.EE + +.br + +.br +PI_WAVE_MODE_ONE_SHOT: same as \fBwave_send_once\fP. + +.br + +.br +PI_WAVE_MODE_REPEAT same as \fBwave_send_repeat\fP. + +.br + +.br +PI_WAVE_MODE_ONE_SHOT_SYNC same as \fBwave_send_once\fP but tries +to sync with the previous waveform. + +.br + +.br +PI_WAVE_MODE_REPEAT_SYNC same as \fBwave_send_repeat\fP but tries +to sync with the previous waveform. + +.br + +.br +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. + +.IP "\fBint wave_chain(int pi, char *buf, unsigned bufSize)\fP" +.IP "" 4 +This function transmits a chain of waveforms. + +.br + +.br +NOTE: Any hardware PWM started by \fBhardware_PWM\fP will be cancelled. + +.br + +.br +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of \fBwave_id\fPs and optional command +codes and related data. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + buf: pointer to the wave_ids and optional command codes +.br +bufSize: the number of bytes in buf +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +.br + +.br +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +.br + +.br +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +.br + +.br +Delays between waves may be added with the delay command. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +Loop Start 255 0 Identify start of a wave block +.br +Loop Repeat 255 1 x y loop x + y*256 times +.br +Delay 255 2 x y delay x + y*256 microseconds +.br +Loop Forever 255 3 loop forever +.br + +.br + +.br +If present Loop Forever must be the last entry in the chain. + +.br + +.br +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +#define WAVES 5 +.br +#define GPIO 4 +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int i, pi, wid[WAVES]; +.br + +.br + pi = pigpio_start(0, 0); +.br + if (pi<0) return -1; +.br + +.br + set_mode(pi, GPIO, PI_OUTPUT); +.br + +.br + for (i=0; i=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns the waveform id or one of the following special values: + +.br + +.br +PI_WAVE_NOT_FOUND (9998) - transmitted wave not found. +.br +PI_NO_TX_WAVE (9999) - no wave being transmitted. + +.IP "\fBint wave_tx_busy(int pi)\fP" +.IP "" 4 +This function checks to see if a waveform is currently being +transmitted. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns 1 if a waveform is currently being transmitted, otherwise 0. + +.IP "\fBint wave_tx_stop(int pi)\fP" +.IP "" 4 +This function stops the transmission of the current waveform. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.br + +.br +Returns 0 if OK. + +.br + +.br +This function is intended to stop a waveform started with the repeat mode. + +.IP "\fBint wave_get_micros(int pi)\fP" +.IP "" 4 +This function returns the length in microseconds of the current +waveform. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_high_micros(int pi)\fP" +.IP "" 4 +This function returns the length in microseconds of the longest waveform +created since the pigpio daemon was started. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_max_micros(int pi)\fP" +.IP "" 4 +This function returns the maximum possible size of a waveform in +.br +microseconds. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_pulses(int pi)\fP" +.IP "" 4 +This function returns the length in pulses of the current waveform. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_high_pulses(int pi)\fP" +.IP "" 4 +This function returns the length in pulses of the longest waveform +created since the pigpio daemon was started. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_max_pulses(int pi)\fP" +.IP "" 4 +This function returns the maximum possible size of a waveform in pulses. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_cbs(int pi)\fP" +.IP "" 4 +This function returns the length in DMA control blocks of the current +waveform. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_high_cbs(int pi)\fP" +.IP "" 4 +This function returns the length in DMA control blocks of the longest +waveform created since the pigpio daemon was started. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint wave_get_max_cbs(int pi)\fP" +.IP "" 4 +This function returns the maximum possible size of a waveform in DMA +control blocks. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br + +.EE + +.IP "\fBint gpio_trigger(int pi, unsigned user_gpio, unsigned pulseLen, unsigned level)\fP" +.IP "" 4 +This function sends a trigger pulse to a GPIO. The GPIO is set to +level for pulseLen microseconds and then reset to not level. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + pulseLen: 1-100. +.br + level: 0,1. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_LEVEL, +PI_BAD_PULSELEN, or PI_NOT_PERMITTED. + +.IP "\fBint store_script(int pi, char *script)\fP" +.IP "" 4 +This function stores a script for later execution. + +.br + +.br +See \fBhttp://abyz.me.uk/rpi/pigpio/pigs.html#Scripts\fP for details. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script: the text of the script. +.br + +.EE + +.br + +.br +The function returns a script id if the script is valid, +otherwise PI_BAD_SCRIPT. + +.IP "\fBint run_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param)\fP" +.IP "" 4 +This function runs a stored script. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script_id: >=0, as returned by \fBstore_script\fP. +.br + numPar: 0-10, the number of parameters. +.br + param: an array of parameters. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM + +.br + +.br +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. + +.IP "\fBint update_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param)\fP" +.IP "" 4 +This function sets the parameters of a script. The script may or +may not be running. The first numPar parameters of the script are +overwritten with the new values. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script_id: >=0, as returned by \fBstore_script\fP. +.br + numPar: 0-10, the number of parameters. +.br + param: an array of parameters. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +.br + +.br +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. + +.IP "\fBint script_status(int pi, unsigned script_id, uint32_t *param)\fP" +.IP "" 4 +This function returns the run status of a stored script as well +as the current values of parameters 0 to 9. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script_id: >=0, as returned by \fBstore_script\fP. +.br + param: an array to hold the returned 10 parameters. +.br + +.EE + +.br + +.br +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +.br + +.br +The run status may be + +.br + +.br + +.EX +PI_SCRIPT_INITING +.br +PI_SCRIPT_HALTED +.br +PI_SCRIPT_RUNNING +.br +PI_SCRIPT_WAITING +.br +PI_SCRIPT_FAILED +.br + +.EE + +.br + +.br +The current value of script parameters 0 to 9 are returned in param. + +.IP "\fBint stop_script(int pi, unsigned script_id)\fP" +.IP "" 4 +This function stops a running script. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script_id: >=0, as returned by \fBstore_script\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint delete_script(int pi, unsigned script_id)\fP" +.IP "" 4 +This function deletes a stored script. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +script_id: >=0, as returned by \fBstore_script\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. + +.IP "\fBint bb_serial_read_open(int pi, unsigned user_gpio, unsigned baud, unsigned data_bits)\fP" +.IP "" 4 +This function opens a GPIO for bit bang reading of serial data. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + baud: 50-250000 +.br +data_bits: 1-32 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, +or PI_GPIO_IN_USE. + +.br + +.br +The serial data is returned in a cyclic buffer and is read using +bb_serial_read. + +.br + +.br +It is the caller's responsibility to read data from the cyclic buffer +in a timely fashion. + +.IP "\fBint bb_serial_read(int pi, unsigned user_gpio, void *buf, size_t bufSize)\fP" +.IP "" 4 +This function copies up to bufSize bytes of data read from the +bit bang serial cyclic buffer to the buffer starting at buf. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + buf: an array to receive the read bytes. +.br + bufSize: >=0 +.br + +.EE + +.br + +.br +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +.br + +.br +The bytes returned for each character depend upon the number of +data bits \fBdata_bits\fP specified in the \fBbb_serial_read_open\fP command. + +.br + +.br +For \fBdata_bits\fP 1-8 there will be one byte per character. +.br +For \fBdata_bits\fP 9-16 there will be two bytes per character. +.br +For \fBdata_bits\fP 17-32 there will be four bytes per character. + +.IP "\fBint bb_serial_read_close(int pi, unsigned user_gpio)\fP" +.IP "" 4 +This function closes a GPIO for bit bang reading of serial data. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. + +.IP "\fBint bb_serial_invert(int pi, unsigned user_gpio, unsigned invert)\fP" +.IP "" 4 +This function inverts serial logic for big bang serial reads. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31, previously opened with \fBbb_serial_read_open\fP. +.br + invert: 0-1, 1 invert, 0 normal. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_NOT_SERIAL_GPIO or PI_BAD_SER_INVERT. + +.IP "\fBint i2c_open(int pi, unsigned i2c_bus, unsigned i2c_addr, unsigned i2c_flags)\fP" +.IP "" 4 +This returns a handle for the device at address i2c_addr on bus i2c_bus. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + i2c_bus: >=0. +.br + i2c_addr: 0-0x7F. +.br +i2c_flags: 0. +.br + +.EE + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.br + +.br +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + SDA SCL +.br +I2C 0 0 1 +.br +I2C 1 2 3 +.br + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +.br + +.br +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +.br + +.br + +.EX +S (1 bit) : Start bit +.br +P (1 bit) : Stop bit +.br +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +.br +A, NA (1 bit) : Accept and not accept bit. +.br +.br +.br +Addr (7 bits): I2C 7 bit address. +.br +i2c_reg (8 bits): A byte which often selects a register. +.br +Data (8 bits): A data byte. +.br +Count (8 bits): A byte defining the length of a block operation. +.br + +.br +[..]: Data sent by the device. +.br + +.EE + +.IP "\fBint i2c_close(int pi, unsigned handle)\fP" +.IP "" 4 +This closes the I2C device associated with the handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint i2c_write_quick(int pi, unsigned handle, unsigned bit)\fP" +.IP "" 4 +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + bit: 0-1, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Quick command. SMBus 2.0 5.5.1 + +.EX +S Addr bit [A] P +.br + +.EE + +.IP "\fBint i2c_write_byte(int pi, unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This sends a single byte to the device associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + bVal: 0-0xFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Send byte. SMBus 2.0 5.5.2 + +.EX +S Addr Wr [A] bVal [A] P +.br + +.EE + +.IP "\fBint i2c_read_byte(int pi, unsigned handle)\fP" +.IP "" 4 +This reads a single byte from the device associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +.br + +.br +Receive byte. SMBus 2.0 5.5.3 + +.EX +S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2c_write_byte_data(int pi, unsigned handle, unsigned i2c_reg, unsigned bVal)\fP" +.IP "" 4 +This writes a single byte to the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + bVal: 0-0xFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write byte. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] i2c_reg [A] bVal [A] P +.br + +.EE + +.IP "\fBint i2c_write_word_data(int pi, unsigned handle, unsigned i2c_reg, unsigned wVal)\fP" +.IP "" 4 +This writes a single 16 bit word to the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + wVal: 0-0xFFFF, the value to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Write word. SMBus 2.0 5.5.4 + +.EX +S Addr Wr [A] i2c_reg [A] wval_Low [A] wVal_High [A] P +.br + +.EE + +.IP "\fBint i2c_read_byte_data(int pi, unsigned handle, unsigned i2c_reg)\fP" +.IP "" 4 +This reads a single byte from the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + +.EE + +.br + +.br +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read byte. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] i2c_reg [A] S Addr Rd [A] [Data] NA P +.br + +.EE + +.IP "\fBint i2c_read_word_data(int pi, unsigned handle, unsigned i2c_reg)\fP" +.IP "" 4 +This reads a single 16 bit word from the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Read word. SMBus 2.0 5.5.5 + +.EX +S Addr Wr [A] i2c_reg [A] +.br + S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2c_process_call(int pi, unsigned handle, unsigned i2c_reg, unsigned wVal)\fP" +.IP "" 4 +This writes 16 bits of data to the specified register of the device +associated with handle and and reads 16 bits of data in return. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write/read. +.br + wVal: 0-0xFFFF, the value to write. +.br + +.EE + +.br + +.br +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Process call. SMBus 2.0 5.5.6 + +.EX +S Addr Wr [A] i2c_reg [A] wVal_Low [A] wVal_High [A] +.br + S Addr Rd [A] [DataLow] A [DataHigh] NA P +.br + +.EE + +.IP "\fBint i2c_write_block_data(int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes up to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + buf: an array with the data to send. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br +Block write. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] i2c_reg [A] count [A] buf0 [A] buf1 [A] ... +.br + [A] bufn [A] P +.br + +.EE + +.IP "\fBint i2c_read_block_data(int pi, unsigned handle, unsigned i2c_reg, char *buf)\fP" +.IP "" 4 +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + buf: an array to receive the read data. +.br + +.EE + +.br + +.br +The amount of returned data is set by the device. + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +Block read. SMBus 2.0 5.5.7 + +.EX +S Addr Wr [A] i2c_reg [A] +.br + S Addr Rd [A] [Count] A [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2c_block_process_call(int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write/read. +.br + buf: an array with the data to send and to receive the read data. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br +The smbus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +.br + +.br +Block write-block read. SMBus 2.0 5.5.8 + +.EX +S Addr Wr [A] i2c_reg [A] count [A] buf0 [A] ... +.br + S Addr Rd [A] [Count] A [Data] ... A P +.br + +.EE + +.IP "\fBint i2c_read_i2c_block_data(int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to read. +.br + buf: an array to receive the read data. +.br + count: 1-32, the number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] i2c_reg [A] +.br + S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2c_write_i2c_block_data(int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count)\fP" +.IP "" 4 +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0, as returned by a call to \fBi2c_open\fP. +.br +i2c_reg: 0-255, the register to write. +.br + buf: the data to write. +.br + count: 1-32, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] i2c_reg [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +.br + +.EE + +.IP "\fBint i2c_read_device(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This reads count bytes from the raw device into buf. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + buf: an array to receive the read data bytes. +.br + count: >0, the number of bytes to read. +.br + +.EE + +.br + +.br +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. + +.br + +.br + +.EX +S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +.br + +.EE + +.IP "\fBint i2c_write_device(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This writes count bytes from buf to the raw device. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2c_open\fP. +.br + buf: an array containing the data bytes to write. +.br + count: >0, the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +.br + +.br + +.EX +S Addr Wr [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +.br + +.EE + +.IP "\fBint i2c_zip(int pi, unsigned handle, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBi2cOpen\fP +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +On 2 Switch combined flag on +.br +Off 3 Switch combined flag off +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53, write 0x32, read 6 bytes +.br +Set address 0x1E, write 0x03, read 6 bytes +.br +Set address 0x68, write 0x1B, read 8 bytes +.br +End +.br + +.br +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +.br +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +.br +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +.br +0x00 +.br + +.EE + +.br + +.br + +.IP "\fBint bb_i2c_open(int pi, unsigned SDA, unsigned SCL, unsigned baud)\fP" +.IP "" 4 +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +.br + +.br +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +.br + +.br +o baud rates as low as 50 +.br +o repeated starts +.br +o clock stretching +.br +o I2C on any pair of spare GPIO + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + SDA: 0-31 +.br + SCL: 0-31 +.br +baud: 50-500000 +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +.br + +.br +NOTE: + +.br + +.br +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + +.IP "\fBint bb_i2c_close(int pi, unsigned SDA)\fP" +.IP "" 4 +This function stops bit banging I2C on a pair of GPIO previously +opened with \fBbb_i2c_open\fP. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +SDA: 0-31, the SDA GPIO used in a prior call to \fBbb_i2c_open\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. + +.IP "\fBint bb_i2c_zip(int pi, unsigned SDA, char *inBuf, unsigned inLen, char *outBuf, unsigned outLen)\fP" +.IP "" 4 +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + SDA: 0-31 (as used in a prior call to \fBbb_i2c_open\fP) +.br + inBuf: pointer to the concatenated I2C commands, see below +.br + inLen: size of command buffer +.br +outBuf: pointer to buffer to hold returned data +.br +outLen: size of output buffer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +.br + +.br +The following command codes are supported: + +.br + +.br +Name Cmd & Data Meaning +.br +End 0 No more commands +.br +Escape 1 Next P is two bytes +.br +Start 2 Start condition +.br +Stop 3 Stop condition +.br +Address 4 P Set I2C address to P +.br +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +.br +Read 6 P Read P bytes of data +.br +Write 7 P ... Write P bytes of data +.br + +.br + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br + +.br +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +.br + +.br +No flags are currently defined. + +.br + +.br +The returned I2C data is stored in consecutive locations of outBuf. + +.br + +.br +\fBExample\fP +.br + +.EX +Set address 0x53 +.br +start, write 0x32, (re)start, read 6 bytes, stop +.br +Set address 0x1E +.br +start, write 0x03, (re)start, read 6 bytes, stop +.br +Set address 0x68 +.br +start, write 0x1B, (re)start, read 8 bytes, stop +.br +End +.br + +.br +0x04 0x53 +.br +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x1E +.br +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x68 +.br +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 +.br + +.br +0x00 +.br + +.EE + +.IP "\fBint bb_spi_open(int pi, unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, unsigned baud, unsigned spi_flags)\fP" +.IP "" 4 +This function selects a set of GPIO for bit banging SPI at a +specified baud rate. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + CS: 0-31 +.br + MISO: 0-31 +.br + MOSI: 0-31 +.br + SCLK: 0-31 +.br + baud: 50-250000 +.br +spi_flags: see below +.br + +.EE + +.br + +.br +spi_flags consists of the least significant 22 bits. + +.br + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +.br + +.EE + +.br + +.br +mm defines the SPI mode, defaults to 0 + +.br + +.br + +.EX +Mode CPOL CPHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br + +.br +p is 0 if CS is active low (default) and 1 for active high. + +.br + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +.br + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +.br + +.br +The other bits in flags should be set to zero. + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_SPI_BAUD, or +PI_GPIO_IN_USE. + +.br + +.br +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +.br + +.br +\fBExample\fP +.br + +.EX +bb_spi_open(pi,10, MISO, MOSI, SCLK, 10000, 0); // device 1 +.br +bb_spi_open(pi,11, MISO, MOSI, SCLK, 20000, 3); // device 2 +.br + +.EE + +.IP "\fBint bb_spi_close(int pi, unsigned CS)\fP" +.IP "" 4 +This function stops bit banging SPI on a set of GPIO +opened with \fBbbSPIOpen\fP. + +.br + +.br + +.EX +pi: >=0 (as returned by \fBpigpio_start\fP). +.br +CS: 0-31, the CS GPIO used in a prior call to \fBbb_spi_open\fP +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SPI_GPIO. + +.IP "\fBint bb_spi_xfer(int pi, unsigned CS, char *txBuf, char *rxBuf, unsigned count)\fP" +.IP "" 4 +This function executes a bit banged SPI transfer. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + CS: 0-31 (as used in a prior call to \fBbb_spi_open\fP) +.br +txBuf: pointer to buffer to hold data to be sent +.br +rxBuf: pointer to buffer to hold returned data +.br +count: size of data transfer +.br + +.EE + +.br + +.br +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_SPI_GPIO or PI_BAD_POINTER. + +.br + +.br +\fBExample\fP +.br + +.EX +// gcc -Wall -pthread -o bb_spi_x_test bb_spi_x_test.c -lpigpiod_if2 +.br +// ./bb_spi_x_test +.br + +.br +#include +.br + +.br +#include "pigpiod_if2.h" +.br + +.br +#define CE0 5 +.br +#define CE1 6 +.br +#define MISO 13 +.br +#define MOSI 19 +.br +#define SCLK 12 +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int i, pi, count, set_val, read_val; +.br + unsigned char inBuf[3]; +.br + char cmd1[] = {0, 0}; +.br + char cmd2[] = {12, 0}; +.br + char cmd3[] = {1, 128, 0}; +.br + +.br + if ((pi = pigpio_start(0, 0)) < 0) +.br + { +.br + fprintf(stderr, "pigpio initialisation failed (%d).\n", pi); +.br + return 1; +.br + } +.br + +.br + bb_spi_open(pi, CE0, MISO, MOSI, SCLK, 10000, 0); // MCP4251 DAC +.br + bb_spi_open(pi, CE1, MISO, MOSI, SCLK, 20000, 3); // MCP3008 ADC +.br + +.br + for (i=0; i<256; i++) +.br + { +.br + cmd1[1] = i; +.br + +.br + count = bb_spi_xfer(pi, CE0, cmd1, (char *)inBuf, 2); // > DAC +.br + +.br + if (count == 2) +.br + { +.br + count = bb_spi_xfer(pi, CE0, cmd2, (char *)inBuf, 2); // < DAC +.br + +.br + if (count == 2) +.br + { +.br + set_val = inBuf[1]; +.br + +.br + count = bb_spi_xfer(pi, CE1, cmd3, (char *)inBuf, 3); // < ADC +.br + +.br + if (count == 3) +.br + { +.br + read_val = ((inBuf[1]&3)<<8) | inBuf[2]; +.br + printf("%d %d\n", set_val, read_val); +.br + } +.br + } +.br + } +.br + } +.br + +.br + bb_spi_close(pi, CE0); +.br + bb_spi_close(pi, CE1); +.br + +.br + pigpio_stop(pi); +.br +} +.br + +.EE + +.IP "\fBint spi_open(int pi, unsigned spi_channel, unsigned baud, unsigned spi_flags)\fP" +.IP "" 4 +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +.br + +.br +The Pi has two SPI peripherals: main and auxiliary. + +.br + +.br +The main SPI has two chip selects (channels), the auxiliary has +three. + +.br + +.br +The auxiliary SPI is available on all models but the A and B. + +.br + +.br +The GPIO used are given in the following table. + +.br + +.br + MISO MOSI SCLK CE0 CE1 CE2 +.br +Main SPI 9 10 11 8 7 - +.br +Aux SPI 19 20 21 18 17 16 +.br + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +spi_channel: 0-1 (0-2 for the auxiliary SPI). +.br + baud: 32K-125M (values above 30M are unlikely to work). +.br + spi_flags: see below. +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +.br + +.br +spi_flags consists of the least significant 22 bits. + +.br + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +.br + +.EE + +.br + +.br +mm defines the SPI mode. + +.br + +.br +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +.br + +.br + +.EX +Mode POL PHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br + +.br +px is 0 if CEx is active low (default) and 1 for active high. + +.br + +.br +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +.br + +.br +A is 0 for the main SPI, 1 for the auxiliary SPI. + +.br + +.br +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +.br + +.br +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +.br + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +.br + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +.br + +.br +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +.br + +.br +The \fBspi_read\fP, \fBspi_write\fP, and \fBspi_xfer\fP functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +.br + +.br +For bits 1-8 there will be one byte per character. +.br +For bits 9-16 there will be two bytes per character. +.br +For bits 17-32 there will be four bytes per character. + +.br + +.br +Multi-byte transfers are made in least significant byte first order. + +.br + +.br +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +.br + +.br +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +.br + +.br +The other bits in flags should be set to zero. + +.IP "\fBint spi_close(int pi, unsigned handle)\fP" +.IP "" 4 +This functions closes the SPI device identified by the handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint spi_read(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads count bytes of data from the SPI +device associated with the handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + buf: an array to receive the read data bytes. +.br + count: the number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spi_write(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + buf: the data bytes to write. +.br + count: the number of bytes to write. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint spi_xfer(int pi, unsigned handle, char *txBuf, char *rxBuf, unsigned count)\fP" +.IP "" 4 +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBspi_open\fP. +.br + txBuf: the data bytes to write. +.br + rxBuf: the received data bytes. +.br + count: the number of bytes to transfer. +.br + +.EE + +.br + +.br +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. + +.IP "\fBint serial_open(int pi, char *ser_tty, unsigned baud, unsigned ser_flags)\fP" +.IP "" 4 +This function opens a serial device at a specified baud rate +with specified flags. The device name must start with +/dev/tty or /dev/serial. + +.br + +.br + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + ser_tty: the serial device to open. +.br + baud: the baud rate in bits per second, see below. +.br +ser_flags: 0. +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +.br + +.br +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +.br + +.br +No flags are currently defined. This parameter should be set to zero. + +.IP "\fBint serial_close(int pi, unsigned handle)\fP" +.IP "" 4 +This function closes the serial device associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.IP "\fBint serial_write_byte(int pi, unsigned handle, unsigned bVal)\fP" +.IP "" 4 +This function writes bVal to the serial port associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serial_read_byte(int pi, unsigned handle)\fP" +.IP "" 4 +This function reads a byte from the serial port associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +.br + +.br +If no data is ready PI_SER_READ_NO_DATA is returned. + +.IP "\fBint serial_write(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes from buf to the the serial port +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + buf: the array of bytes to write. +.br + count: the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. + +.IP "\fBint serial_read(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads up to count bytes from the the serial port +associated with handle and writes them to buf. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + buf: an array to receive the read data. +.br + count: the maximum number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, PI_SER_READ_NO_DATA, or PI_SER_WRITE_FAILED. + +.br + +.br +If no data is ready zero is returned. + +.IP "\fBint serial_data_available(int pi, unsigned handle)\fP" +.IP "" 4 +Returns the number of bytes available to be read from the +device associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0, as returned by a call to \fBserial_open\fP. +.br + +.EE + +.br + +.br +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. + +.IP "\fBint custom_1(int pi, unsigned arg1, unsigned arg2, char *argx, unsigned argc)\fP" +.IP "" 4 +This function is available for user customisation. + +.br + +.br +It returns a single integer value. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +arg1: >=0 +.br +arg2: >=0 +.br +argx: extra (byte) arguments +.br +argc: number of extra arguments +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.IP "\fBint custom_2(int pi, unsigned arg1, char *argx, unsigned argc, char *retBuf, unsigned retMax)\fP" +.IP "" 4 +This function is available for user customisation. + +.br + +.br +It differs from custom_1 in that it returns an array of bytes +rather than just an integer. + +.br + +.br +The return value is an integer indicating the number of returned bytes. + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + arg1: >=0 +.br + argc: extra (byte) arguments +.br + count: number of extra arguments +.br +retBuf: buffer for returned data +.br +retMax: maximum number of bytes to return +.br + +.EE + +.br + +.br +Returns >= 0 if OK, less than 0 indicates a user defined error. + +.br + +.br +Note, the number of returned bytes will be retMax or less. + +.IP "\fBint get_pad_strength(int pi, unsigned pad)\fP" +.IP "" 4 +This function returns the pad drive strength in mA. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +pad: 0-2, the pad to get. +.br + +.EE + +.br + +.br +Returns the pad drive strength if OK, otherwise PI_BAD_PAD. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +strength = get_pad_strength(pi, 0); // get pad 0 strength +.br + +.EE + +.IP "\fBint set_pad_strength(int pi, unsigned pad, unsigned padStrength)\fP" +.IP "" 4 +This function sets the pad drive strength in mA. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + pad: 0-2, the pad to set. +.br +padStrength: 1-16 mA. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_PAD, or PI_BAD_STRENGTH. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +set_pad_strength(pi, 0, 10); // set pad 0 strength to 10 mA +.br + +.EE + +.IP "\fBint shell_(int pi, char *scriptName, char *scriptString)\fP" +.IP "" 4 +This function uses the system call to execute a shell script +with the given string as its parameter. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + scriptName: the name of the script, only alphanumeric characters, +.br + '-' and '_' are allowed in the name. +.br +scriptString: the string to pass to the script. +.br + +.EE + +.br + +.br +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +.br + +.br +scriptName must exist in /opt/pigpio/cgi and must be executable. + +.br + +.br +The returned exit status is normally 256 times that set by the +shell script exit function. If the script can't be found 32512 will +be returned. + +.br + +.br +The following table gives some example returned statuses. + +.br + +.br +Script exit status Returned system call status +.br +1 256 +.br +5 1280 +.br +10 2560 +.br +200 51200 +.br +script not found 32512 +.br + +.br + +.br +\fBExample\fP +.br + +.EX +// pass two parameters, hello and world +.br +status = shell_(pi, "scr1", "hello world"); +.br + +.br +// pass three parameters, hello, string with spaces, and world +.br +status = shell_(pi, "scr1", "hello 'string with spaces' world"); +.br + +.br +// pass one parameter, hello string with spaces world +.br +status = shell_(pi, "scr1", "\"hello string with spaces world\""); +.br + +.EE + +.IP "\fBint file_open(int pi, char *file, unsigned mode)\fP" +.IP "" 4 +This function returns a handle to a file opened in a specified mode. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +file: the file to open. +.br +mode: the file open mode. +.br + +.EE + +.br + +.br +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, PI_NO_FILE_ACCESS, +PI_BAD_FILE_MODE, PI_FILE_OPEN_FAILED, or PI_FILE_IS_A_DIR. + +.br + +.br +File + +.br + +.br +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +.br + +.br +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +.br + +.br +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +.br + +.br +Suppose /opt/pigpio/access contains the following entries + +.br + +.br + +.EX +/home/* n +.br +/home/pi/shared/dir_1/* w +.br +/home/pi/shared/dir_2/* r +.br +/home/pi/shared/dir_3/* u +.br +/home/pi/shared/dir_1/file.txt n +.br + +.EE + +.br + +.br +Files may be written in directory dir_1 with the exception +of file.txt. + +.br + +.br +Files may be read in directory dir_2. + +.br + +.br +Files may be read and written in directory dir_3. + +.br + +.br +If a directory allows read, write, or read/write access then files may +be created in that directory. + +.br + +.br +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +.br + +.br + +.EX +a path containing .. +.br +a path containing only wildcards (*?) +.br +a path containing less than two non-wildcard parts +.br + +.EE + +.br + +.br +Mode + +.br + +.br +The mode may have the following values. + +.br + +.br +Macro Value Meaning +.br +PI_FILE_READ 1 open file for reading +.br +PI_FILE_WRITE 2 open file for writing +.br +PI_FILE_RW 3 open file for reading and writing +.br + +.br + +.br +The following values may be or'd into the mode. + +.br + +.br +Macro Value Meaning +.br +PI_FILE_APPEND 4 Writes append data to the end of the file +.br +PI_FILE_CREATE 8 The file is created if it doesn't exist +.br +PI_FILE_TRUNC 16 The file is truncated +.br + +.br + +.br +Newly created files are owned by root with permissions owner read and write. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int pi, handle, c; +.br + char buf[60000]; +.br + +.br + pi = pigpio_start(NULL, NULL); +.br + +.br + if (pi < 0) return 1; +.br + +.br + // assumes /opt/pigpio/access contains the following line +.br + // /ram/*.c r +.br + +.br + handle = file_open(pi, "/ram/pigpio.c", PI_FILE_READ); +.br + +.br + if (handle >= 0) +.br + { +.br + while ((c=file_read(pi, handle, buf, sizeof(buf)-1))) +.br + { +.br + buf[c] = 0; +.br + printf("%s", buf); +.br + } +.br + +.br + file_close(pi, handle); +.br + } +.br + +.br + pigpio_stop(pi); +.br +} +.br + +.EE + +.IP "\fBint file_close(int pi, unsigned handle)\fP" +.IP "" 4 +This function closes the file associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0 (as returned by \fBfile_open\fP). +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +.br + +.br +\fBExample\fP +.br + +.EX +file_close(pi, handle); +.br + +.EE + +.IP "\fBint file_write(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function writes count bytes from buf to the the file +associated with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0 (as returned by \fBfile_open\fP). +.br + buf: the array of bytes to write. +.br + count: the number of bytes to write. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, +PI_FILE_NOT_WOPEN, or PI_BAD_FILE_WRITE. + +.br + +.br +\fBExample\fP +.br + +.EX +if (file_write(pi, handle, buf, 100) == 0) +.br +{ +.br + // file written okay +.br +} +.br +else +.br +{ +.br + // error +.br +} +.br + +.EE + +.IP "\fBint file_read(int pi, unsigned handle, char *buf, unsigned count)\fP" +.IP "" 4 +This function reads up to count bytes from the the file +associated with handle and writes them to buf. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +handle: >=0 (as returned by \fBfile_open\fP). +.br + buf: an array to receive the read data. +.br + count: the maximum number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, PI_FILE_NOT_ROPEN, or PI_BAD_FILE_WRITE. + +.br + +.br +\fBExample\fP +.br + +.EX + bytes = file_read(pi, handle, buf, sizeof(buf)); +.br + +.br + if (bytes >= 0) +.br + { +.br + // process read data +.br + } +.br + +.EE + +.IP "\fBint file_seek(int pi, unsigned handle, int32_t seekOffset, int seekFrom)\fP" +.IP "" 4 +This function seeks to a position within the file associated +with handle. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + handle: >=0 (as returned by \fBfile_open\fP). +.br +seekOffset: the number of bytes to move. Positive offsets +.br + move forward, negative offsets backwards. +.br + seekFrom: one of PI_FROM_START (0), PI_FROM_CURRENT (1), +.br + or PI_FROM_END (2). +.br + +.EE + +.br + +.br +Returns the new byte position within the file (>=0) if OK, otherwise PI_BAD_HANDLE, or PI_BAD_FILE_SEEK. + +.br + +.br +\fBExample\fP +.br + +.EX +file_seek(pi, handle, 123, PI_FROM_START); // Start plus 123 +.br + +.br +size = file_seek(pi, handle, 0, PI_FROM_END); // End, return size +.br + +.br +pos = file_seek(pi, handle, 0, PI_FROM_CURRENT); // Current position +.br + +.EE + +.IP "\fBint file_list(int pi, char *fpat, char *buf, unsigned count)\fP" +.IP "" 4 +This function returns a list of files which match a pattern. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + fpat: file pattern to match. +.br + buf: an array to receive the matching file names. +.br +count: the maximum number of bytes to read. +.br + +.EE + +.br + +.br +Returns the number of returned bytes if OK, otherwise PI_NO_FILE_ACCESS, +or PI_NO_FILE_MATCH. + +.br + +.br +The pattern must match an entry in /opt/pigpio/access. The pattern +may contain wildcards. See \fBfile_open\fP. + +.br + +.br +NOTE + +.br + +.br +The returned value is not the number of files, it is the number +of bytes in the buffer. The file names are separated by newline +characters. + +.br + +.br +\fBExample\fP +.br + +.EX +#include +.br +#include +.br + +.br +int main(int argc, char *argv[]) +.br +{ +.br + int pi, handle, c; +.br + char buf[60000]; +.br + +.br + pi = pigpio_start(NULL, NULL); +.br + +.br + if (pi < 0) return 1; +.br + +.br + // assumes /opt/pigpio/access contains the following line +.br + // /ram/*.c r +.br + +.br + c = file_list(pi, "/ram/p*.c", buf, sizeof(buf)); +.br + +.br + if (c >= 0) +.br + { +.br + buf[c] = 0; +.br + printf("%s", buf); +.br + } +.br + +.br + pigpio_stop(pi); +.br +} +.br + +.EE + +.IP "\fBint callback(int pi, unsigned user_gpio, unsigned edge, CBFunc_t f)\fP" +.IP "" 4 +This function initialises a new callback. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + f: the callback function. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the GPIO, edge, and tick, whenever the +GPIO has the identified edge. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +edge 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.EE + +.br + +.br +The GPIO are sampled at a rate set when the pigpio daemon +is started (default 5 us). + +.br + +.br +The number of samples per second is given in the following table. + +.br + +.br + +.EX + samples +.br + per sec +.br + +.br + 1 1,000,000 +.br + 2 500,000 +.br +sample 4 250,000 +.br +rate 5 200,000 +.br +(us) 8 125,000 +.br + 10 100,000 +.br + +.EE + +.br + +.br +GPIO level changes shorter than the sample rate may be missed. + +.br + +.br +The daemon software which generates the callbacks is triggered +1000 times per second. The callbacks will be called once per +level change since the last time they were called. +i.e. The callbacks will get all level changes but there will +be a latency. + +.br + +.br +If you want to track the level of more than one GPIO do so by +maintaining the state in the callback. Do not use \fBgpio_read\fP. +Remember the event that triggered the callback may have +happened several milliseconds before and the GPIO may have +changed level many times since then. + +.IP "\fBint callback_ex(int pi, unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *userdata)\fP" +.IP "" 4 +This function initialises a new callback. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + f: the callback function. +.br + userdata: a pointer to arbitrary user data. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the GPIO, edge, tick, and the userdata +pointer, whenever the GPIO has the identified edge. + +.br + +.br + +.EX +Parameter Value Meaning +.br + +.br +GPIO 0-31 The GPIO which has changed state +.br + +.br +edge 0-2 0 = change to low (a falling edge) +.br + 1 = change to high (a rising edge) +.br + 2 = no level change (a watchdog timeout) +.br + +.br +tick 32 bit The number of microseconds since boot +.br + WARNING: this wraps around from +.br + 4294967295 to 0 roughly every 72 minutes +.br + +.br +userdata pointer Pointer to an arbitrary object +.br + +.EE + +.IP "\fBint callback_cancel(unsigned callback_id)\fP" +.IP "" 4 +This function cancels a callback identified by its id. + +.br + +.br + +.EX +callback_id: >=0, as returned by a call to \fBcallback\fP or \fBcallback_ex\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise pigif_callback_not_found. + +.IP "\fBint wait_for_edge(int pi, unsigned user_gpio, unsigned edge, double timeout)\fP" +.IP "" 4 +This function waits for an edge on the GPIO for up to timeout +seconds. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +user_gpio: 0-31. +.br + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. +.br + timeout: >=0. +.br + +.EE + +.br + +.br +The function returns when the edge occurs or after the timeout. + +.br + +.br +Do not use this function for precise timing purposes, +the edge is only checked 20 times a second. Whenever +you need to know the accurate time of GPIO events use +a \fBcallback\fP function. + +.br + +.br +The function returns 1 if the edge occurred, otherwise 0. + +.IP "\fBint bsc_xfer(int pi, bsc_xfer_t *bscxfer)\fP" +.IP "" 4 +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +.br + +.br +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +.br + +.br +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +.br + +.br +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +.br + +.br +The function sets the BSC mode, writes any data in +the transmit buffer to the BSC transmit FIFO, and +copies any data in the BSC receive FIFO to the +receive buffer. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +bscxfer: a structure defining the transfer. +.br + +.br +typedef struct +.br +{ +.br + uint32_t control; // Write +.br + int rxCnt; // Read only +.br + char rxBuf[BSC_FIFO_SIZE]; // Read only +.br + int txCnt; // Write +.br + char txBuf[BSC_FIFO_SIZE]; // Write +.br +} bsc_xfer_t; +.br + +.EE + +.br + +.br +To start a transfer set control (see below), copy the bytes to +be added to the transmit FIFO (if any) to txBuf and set txCnt to +the number of copied bytes. + +.br + +.br +Upon return rxCnt will be set to the number of received bytes placed +in rxBuf. + +.br + +.br +The returned function value is the status of the transfer (see below). + +.br + +.br +If there was an error the status will be less than zero +(and will contain the error code). + +.br + +.br +The most significant word of the returned status contains the number +of bytes actually copied from txBuf to the BSC transmit FIFO (may be +less than requested if the FIFO already contained untransmitted data). + +.br + +.br +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +.br + +.br +GPIO used for models other than those based on the BCM2711. + +.br + +.br + SDA SCL MOSI SCLK MISO CE +.br +I2C 18 19 - - - - +.br +SPI - - 20 19 18 21 +.br + +.br + +.br +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + +.br + +.br + SDA SCL MOSI SCLK MISO CE +.br +I2C 10 11 - - - - +.br +SPI - - 9 11 10 8 +.br + +.br + +.br +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +.br + +.br +control consists of the following bits. + +.br + +.br + +.EX +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +.br + +.EE + +.br + +.br +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +.br + +.br +aaaaaaa defines the I2C slave address (only relevant in I2C mode) +.br +IT invert transmit status flags +.br +HC enable host control +.br +TF enable test FIFO +.br +IR invert receive status flags +.br +RE enable receive +.br +TE enable transmit +.br +BK abort operation and clear FIFOs +.br +EC send control register as first I2C byte +.br +ES send status register as first I2C byte +.br +PL set SPI polarity high +.br +PH set SPI phase high +.br +I2 enable I2C mode +.br +SP enable SPI mode +.br +EN enable BSC peripheral +.br + +.br + +.br +The returned status has the following format + +.br + +.br + +.EX +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + S S S S S R R R R R T T T T T RB TE RF TF RE TB +.br + +.EE + +.br + +.br +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +.br + +.br +SSSSS number of bytes successfully copied to transmit FIFO +.br +RRRRR number of bytes in receive FIFO +.br +TTTTT number of bytes in transmit FIFO +.br +RB receive busy +.br +TE transmit FIFO empty +.br +RF receive FIFO full +.br +TF transmit FIFO full +.br +RE receive FIFO empty +.br +TB transmit busy +.br + +.br + +.br +The following example shows how to configure the BSC peripheral as +an I2C slave with address 0x13 and send four bytes. + +.br + +.br +\fBExample\fP +.br + +.EX +bsc_xfer_t xfer; +.br + +.br +xfer.control = (0x13<<16) | 0x305; +.br + +.br +memcpy(xfer.txBuf, "ABCD", 4); +.br +xfer.txCnt = 4; +.br + +.br +status = bsc_xfer(pi, &xfer); +.br + +.br +if (status >= 0) +.br +{ +.br + // process transfer +.br +} +.br + +.EE + +.br + +.br +The BSC slave in SPI mode deserializes data from the MOSI pin into its +receiver/FIFO when the LSB of the first byte is a 0. No data is output on +the MISO pin. When the LSB of the first byte on MOSI is a 1, the +transmitter/FIFO data is serialized onto the MISO pin while all other data +on the MOSI pin is ignored. + +.br + +.br +The BK bit of the BSC control register is non-functional when in the SPI +mode. The transmitter along with its FIFO can be dequeued by successively +disabling and re-enabling the TE bit on the BSC control register while in +SPI mode. + +.IP "\fBint bsc_i2c(int pi, int i2c_addr, bsc_xfer_t *bscxfer)\fP" +.IP "" 4 +This function allows the Pi to act as a slave I2C device. + +.br + +.br +This function is not available on the BCM2711 (e.g.as +used in the Pi4B). + +.br + +.br +The data bytes (if any) are written to the BSC transmit +FIFO and the bytes in the BSC receive FIFO are returned. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +i2c_addr: 0-0x7F. +.br + bscxfer: a structure defining the transfer. +.br + +.br +typedef struct +.br +{ +.br + uint32_t control; // N/A +.br + int rxCnt; // Read only +.br + char rxBuf[BSC_FIFO_SIZE]; // Read only +.br + int txCnt; // Write +.br + char txBuf[BSC_FIFO_SIZE]; // Write +.br +} bsc_xfer_t; +.br + +.EE + +.br + +.br +txCnt is set to the number of bytes to be transmitted, possibly +zero. The data itself should be copied to txBuf. + +.br + +.br +Any received data will be written to rxBuf with rxCnt set. + +.br + +.br +See \fBbsc_xfer\fP for details of the returned status value. + +.br + +.br +If there was an error the status will be less than zero +(and will contain the error code). + +.br + +.br +Note that an i2c_address of 0 may be used to close +the BSC device and reassign the used GPIO as inputs. + +.IP "\fBint event_callback(int pi, unsigned event, evtCBFunc_t f)\fP" +.IP "" 4 +This function initialises an event callback. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +event: 0-31. +.br + f: the callback function. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the event id, and tick, whenever the +event occurs. + +.IP "\fBint event_callback_ex(int pi, unsigned event, evtCBFuncEx_t f, void *userdata)\fP" +.IP "" 4 +This function initialises an event callback. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + event: 0-31. +.br + f: the callback function. +.br +userdata: a pointer to arbitrary user data. +.br + +.EE + +.br + +.br +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +.br + +.br +The callback is called with the event id, the tick, and the userdata +pointer whenever the event occurs. + +.IP "\fBint event_callback_cancel(unsigned callback_id)\fP" +.IP "" 4 +This function cancels an event callback identified by its id. + +.br + +.br + +.EX +callback_id: >=0, as returned by a call to \fBevent_callback\fP or +.br +\fBevent_callback_ex\fP. +.br + +.EE + +.br + +.br +The function returns 0 if OK, otherwise pigif_callback_not_found. + +.IP "\fBint wait_for_event(int pi, unsigned event, double timeout)\fP" +.IP "" 4 +This function waits for an event for up to timeout seconds. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br + event: 0-31. +.br +timeout: >=0. +.br + +.EE + +.br + +.br +The function returns when the event occurs or after the timeout. + +.br + +.br +The function returns 1 if the event occurred, otherwise 0. + +.IP "\fBint event_trigger(int pi, unsigned event)\fP" +.IP "" 4 +This function signals the occurrence of an event. + +.br + +.br + +.EX + pi: >=0 (as returned by \fBpigpio_start\fP). +.br +event: 0-31. +.br + +.EE + +.br + +.br +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +.br + +.br +An event is a signal used to inform one or more consumers +to start an action. Each consumer which has registered an interest +in the event (e.g. by calling \fBevent_callback\fP) will be informed by +a callback. + +.br + +.br +One event, PI_EVENT_BSC (31) is predefined. This event is +auto generated on BSC slave activity. + +.br + +.br +The meaning of other events is arbitrary. + +.br + +.br +Note that other than its id and its tick there is no data associated +with an event. +.SH PARAMETERS + +.br + +.br + +.IP "\fBactive\fP: 0-1000000" 0 + +.br + +.br +The number of microseconds level changes are reported for once +a noise filter has been triggered (by \fBsteady\fP microseconds of +a stable level). + +.br + +.br + +.IP "\fB*addrStr\fP" 0 +A string specifying the host or IP address of the Pi running +the pigpio daemon. It may be NULL in which case localhost +is used unless overridden by the PIGPIO_ADDR environment +variable. + +.br + +.br + +.IP "\fBarg1\fP" 0 +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBarg2\fP" 0 +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +.br + +.br + +.IP "\fBargc\fP" 0 +The count of bytes passed to a user customised function. + +.br + +.br + +.IP "\fB*argx\fP" 0 +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +.br + +.br + +.IP "\fBbaud\fP" 0 +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +.br + +.br + +.IP "\fBbit\fP" 0 +A value of 0 or 1. + +.br + +.br + +.IP "\fBbits\fP" 0 +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +.br + +.br +A convenient way to set bit n is to or in (1<=0, as returned by a call to a callback function, one of + +.br + +.br +\fBcallback\fP +.br +\fBcallback_ex\fP +.br +\fBevent_callback\fP +.br +\fBevent_callback_ex\fP + +.br + +.br +The id is passed to \fBcallback_cancel\fP or \fBevent_callback_cancel\fP +to cancel the callback. + +.br + +.br + +.IP "\fBCBFunc_t\fP" 0 + +.EX +typedef void (*CBFunc_t) +.br + (int pi, unsigned user_gpio, unsigned level, uint32_t tick); +.br + +.EE + +.br + +.br + +.IP "\fBCBFuncEx_t\fP" 0 + +.EX +typedef void (*CBFuncEx_t) +.br + (int pi, unsigned user_gpio, unsigned level, uint32_t tick, void * userdata); +.br + +.EE + +.br + +.br + +.IP "\fBchar\fP" 0 +A single character, an 8 bit quantity able to store 0-255. + +.br + +.br + +.IP "\fBclkfreq\fP: 4689-250M (13184-375M for the BCM2711)" 0 +The hardware clock frequency. + +.br + +.br + +.IP "\fBcount\fP" 0 +The number of bytes to be transferred in a file, I2C, SPI, or serial +command. + +.br + +.br + +.IP "\fBCS\fP" 0 +The GPIO used for the slave select signal when bit banging SPI. + +.br + +.br + +.IP "\fBdata_bits\fP: 1-32" 0 +The number of data bits in each character of serial data. + +.br + +.br + +.EX +#define PI_MIN_WAVE_DATABITS 1 +.br +#define PI_MAX_WAVE_DATABITS 32 +.br + +.EE + +.br + +.br + +.IP "\fBdouble\fP" 0 +A floating point number. + +.br + +.br + +.IP "\fBdutycycle\fP: 0-range" 0 +A number representing the ratio of on time to off time for PWM. + +.br + +.br +The number may vary between 0 and range (default 255) where +0 is off and range is fully on. + +.br + +.br + +.IP "\fBedge\fP" 0 +Used to identify a GPIO level transition of interest. A rising edge is +a level change from 0 to 1. A falling edge is a level change from 1 to 0. + +.br + +.br + +.EX +RISING_EDGE 0 +.br +FALLING_EDGE 1 +.br +EITHER_EDGE. 2 +.br + +.EE + +.br + +.br + +.IP "\fBerrnum\fP" 0 +A negative number indicating a function call failed and the nature +of the error. + +.br + +.br + +.IP "\fBevent\fP: 0-31" 0 +An event is a signal used to inform one or more consumers +to start an action. + +.br + +.br + +.IP "\fBevtCBFunc_t\fP" 0 + +.br + +.br + +.EX +typedef void (*evtCBFunc_t) +.br + (int pi, unsigned event, uint32_t tick); +.br + +.EE + +.br + +.br + +.IP "\fBevtCBFuncEx_t\fP" 0 + +.br + +.br + +.EX +typedef void (*evtCBFuncEx_t) +.br + (int pi, unsigned event, uint32_t tick, void *userdata); +.br + +.EE + +.br + +.br + +.IP "\fBf\fP" 0 +A function. + +.br + +.br + +.IP "\fB*file\fP" 0 +A full file path. To be accessible the path must match an entry in +/opt/pigpio/access. + +.br + +.br + +.IP "\fB*fpat\fP" 0 +A file path which may contain wildcards. To be accessible the path +must match an entry in /opt/pigpio/access. + +.br + +.br + +.IP "\fBfrequency\fP: >=0" 0 +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + +.br + +.br + +.IP "\fBgpio\fP" 0 +A Broadcom numbered GPIO, in the range 0-53. + +.br + +.br +There are 54 General Purpose Input Outputs (GPIO) named GPIO0 through +GPIO53. + +.br + +.br +They are split into two banks. Bank 1 consists of GPIO0 through +GPIO31. Bank 2 consists of GPIO32 through GPIO53. + +.br + +.br +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +.br + +.br +See \fBget_hardware_revision\fP. + +.br + +.br +The user GPIO are marked with an X in the following table. + +.br + +.br + +.EX + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +.br +Type 1 X X - - X - - X X X X X - - X X +.br +Type 2 - - X X X - - X X X X X - - X X +.br +Type 3 X X X X X X X X X X X X X X +.br + +.br + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +.br +Type 1 - X X - - X X X X X - - - - - - +.br +Type 2 - X X - - - X X X X - X X X X X +.br +Type 3 X X X X X X X X X X X X - - - - +.br + +.EE + +.br + +.br + +.IP "\fBgpioPulse_t\fP" 0 + +.EX +typedef struct +.br +{ +.br + uint32_t gpioOn; +.br + uint32_t gpioOff; +.br + uint32_t usDelay; +.br +} gpioPulse_t; +.br + +.EE + +.br + +.br + +.IP "\fBgpioThreadFunc_t\fP" 0 + +.EX +typedef void *(gpioThreadFunc_t) (void *); +.br + +.EE + +.br + +.br + +.IP "\fBhandle\fP: >=0" 0 +A number referencing an object opened by one of + +.br + +.br +\fBfile_open\fP +.br +\fBi2c_open\fP +.br +\fBnotify_open\fP +.br +\fBserial_open\fP +.br +\fBspi_open\fP + +.br + +.br + +.IP "\fBi2c_addr\fP: 0-0x7F" 0 +The address of a device on the I2C bus. + +.br + +.br + +.IP "\fBi2c_bus\fP: >=0" 0 +An I2C bus number. + +.br + +.br + +.IP "\fBi2c_flags\fP: 0" 0 +Flags which modify an I2C open command. None are currently defined. + +.br + +.br + +.IP "\fBi2c_reg\fP: 0-255" 0 +A register of an I2C device. + +.br + +.br + +.IP "\fB*inBuf\fP" 0 +A buffer used to pass data to a function. + +.br + +.br + +.IP "\fBinLen\fP" 0 +The number of bytes of data in a buffer. + +.br + +.br + +.IP "\fBint\fP" 0 +A whole number, negative or positive. + +.br + +.br + +.IP "\fBint32_t\fP" 0 +A 32-bit signed value. + +.br + +.br + +.IP "\fBinvert\fP" 0 +A flag used to set normal or inverted bit bang serial data level logic. + +.br + +.br + +.IP "\fBlevel\fP" 0 +The level of a GPIO. Low or High. + +.br + +.br + +.EX +PI_OFF 0 +.br +PI_ON 1 +.br + +.br +PI_CLEAR 0 +.br +PI_SET 1 +.br + +.br +PI_LOW 0 +.br +PI_HIGH 1 +.br + +.EE + +.br + +.br +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See \fBset_watchdog\fP. + +.br + +.br + +.EX +PI_TIMEOUT 2 +.br + +.EE + +.br + +.br + +.IP "\fBMISO\fP" 0 +The GPIO used for the MISO signal when bit banging SPI. + +.br + +.br + +.IP "\fBmode\fP" 0 +1. The operational mode of a GPIO, normally INPUT or OUTPUT. + +.br + +.br + +.EX +PI_INPUT 0 +.br +PI_OUTPUT 1 +.br +PI_ALT0 4 +.br +PI_ALT1 5 +.br +PI_ALT2 6 +.br +PI_ALT3 7 +.br +PI_ALT4 3 +.br +PI_ALT5 2 +.br + +.EE + +.br + +.br +2. The mode of waveform transmission. + +.br + +.br + +.EX +PI_WAVE_MODE_ONE_SHOT 0 +.br +PI_WAVE_MODE_REPEAT 1 +.br +PI_WAVE_MODE_ONE_SHOT_SYNC 2 +.br +PI_WAVE_MODE_REPEAT_SYNC 3 +.br + +.EE + +.br + +.br +3. A file open mode. + +.br + +.br + +.EX +PI_FILE_READ 1 +.br +PI_FILE_WRITE 2 +.br +PI_FILE_RW 3 +.br + +.EE + +.br + +.br +The following values can be or'd into the mode. + +.br + +.br + +.EX +PI_FILE_APPEND 4 +.br +PI_FILE_CREATE 8 +.br +PI_FILE_TRUNC 16 +.br + +.EE + +.br + +.br + +.IP "\fBMOSI\fP" 0 +The GPIO used for the MOSI signal when bit banging SPI. + +.br + +.br + +.IP "\fBnumBytes\fP" 0 +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +.br + +.br + +.IP "\fBnumPar\fP: 0-10" 0 +The number of parameters passed to a script. + +.br + +.br + +.IP "\fBnumPulses\fP" 0 +The number of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBoffset\fP" 0 +The associated data starts this number of microseconds from the start of +the waveform. + +.br + +.br + +.IP "\fB*outBuf\fP" 0 +A buffer used to return data from a function. + +.br + +.br + +.IP "\fBoutLen\fP" 0 +The size in bytes of an output buffer. + +.br + +.br + +.IP "\fBpad\fP: 0-2" 0 +A set of GPIO which share common drivers. + +.br + +.br +Pad GPIO +.br +0 0-27 +.br +1 28-45 +.br +2 46-53 +.br + +.br + +.br + +.IP "\fBpadStrength\fP: 1-16" 0 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +.br + +.br + +.IP "\fB*param\fP" 0 +An array of script parameters. + +.br + +.br + +.IP "\fBpercent\fP: 0-100" 0 +The size of waveform as percentage of maximum available. + +.br + +.br + +.IP "\fBpi\fP" 0 +An integer defining a connected Pi. The value is returned by +\fBpigpio_start\fP upon success. + +.br + +.br + +.IP "\fB*portStr\fP" 0 +A string specifying the port address used by the Pi running +the pigpio daemon. It may be NULL in which case "8888" +is used unless overridden by the PIGPIO_PORT environment +variable. + +.br + +.br + +.IP "\fB*pth\fP" 0 +A thread identifier, returned by \fBstart_thread\fP. + +.br + +.br + +.br + +.br + +.IP "\fBpthread_t\fP" 0 +A thread identifier. + +.br + +.br + +.IP "\fBpud\fP: 0-2" 0 +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. + +.EX +PI_PUD_OFF 0 +.br +PI_PUD_DOWN 1 +.br +PI_PUD_UP 2 +.br + +.EE + +.br + +.br + +.IP "\fBpulseLen\fP" 0 +1-100, the length of a trigger pulse in microseconds. + +.br + +.br + +.IP "\fB*pulses\fP" 0 +An array of pulses to be added to a waveform. + +.br + +.br + +.IP "\fBpulsewidth\fP: 0, 500-2500" 0 + +.EX +PI_SERVO_OFF 0 +.br +PI_MIN_SERVO_PULSEWIDTH 500 +.br +PI_MAX_SERVO_PULSEWIDTH 2500 +.br + +.EE + +.br + +.br + +.IP "\fBPWMduty\fP: 0-1000000 (1M)" 0 +The hardware PWM dutycycle. + +.br + +.br + +.EX +#define PI_HW_PWM_RANGE 1000000 +.br + +.EE + +.br + +.br + +.IP "\fBPWMfreq\fP: 1-125M (1-187.5M for the BCM2711)" 0 +The hardware PWM frequency. + +.br + +.br + +.EX +#define PI_HW_PWM_MIN_FREQ 1 +.br +#define PI_HW_PWM_MAX_FREQ 125000000 +.br +#define PI_HW_PWM_MAX_FREQ_2711 187500000 +.br + +.EE + +.br + +.br + +.IP "\fBrange\fP: 25-40000" 0 +The permissible dutycycle values are 0-range. + +.br + +.br + +.EX +PI_MIN_DUTYCYCLE_RANGE 25 +.br +PI_MAX_DUTYCYCLE_RANGE 40000 +.br + +.EE + +.br + +.br + +.IP "\fB*retBuf\fP" 0 +A buffer to hold a number of bytes returned to a used customised function, + +.br + +.br + +.IP "\fBretMax\fP" 0 +The maximum number of bytes a user customised function should return. + +.br + +.br + +.br + +.br + +.IP "\fB*rxBuf\fP" 0 +A pointer to a buffer to receive data. + +.br + +.br + +.IP "\fBSCL\fP" 0 +The user GPIO to use for the clock when bit banging I2C. + +.br + +.br + +.IP "\fBSCLK\fP" 0 +The GPIO used for the SCLK signal when bit banging SPI. + +.br + +.br + +.IP "\fB*script\fP" 0 +A pointer to the text of a script. + +.br + +.br + +.IP "\fBscript_id\fP" 0 +An id of a stored script as returned by \fBstore_script\fP. + +.br + +.br + +.IP "\fB*scriptName\fP" 0 +The name of a \fBshell_\fP script to be executed. The script must be present in +/opt/pigpio/cgi and must have execute permission. + +.br + +.br + +.IP "\fB*scriptString\fP" 0 +The string to be passed to a \fBshell_\fP script to be executed. + +.br + +.br + +.IP "\fBSDA\fP" 0 +The user GPIO to use for data when bit banging I2C. + +.br + +.br + +.IP "\fBseconds\fP" 0 +The number of seconds. + +.br + +.br + +.IP "\fBseekFrom\fP" 0 + +.br + +.br + +.EX +PI_FROM_START 0 +.br +PI_FROM_CURRENT 1 +.br +PI_FROM_END 2 +.br + +.EE + +.br + +.br + +.IP "\fBseekOffset\fP" 0 +The number of bytes to move forward (positive) or backwards (negative) +from the seek position (start, current, or end of file). + +.br + +.br + +.IP "\fBser_flags\fP" 0 +Flags which modify a serial open command. None are currently defined. + +.br + +.br + +.IP "\fB*ser_tty\fP" 0 +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +.br + +.br + +.IP "\fBsize_t\fP" 0 +A standard type used to indicate the size of an object in bytes. + +.br + +.br + +.IP "\fBspi_channel\fP" 0 +A SPI channel, 0-2. + +.br + +.br + +.IP "\fBspi_flags\fP" 0 +See \fBspi_open\fP and \fBbb_spi_open\fP. + +.br + +.br + +.IP "\fBsteady\fP: 0-300000" 0 + +.br + +.br +The number of microseconds level changes must be stable for +before reporting the level changed (\fBset_glitch_filter\fP) or triggering +the active part of a noise filter (\fBset_noise_filter\fP). + +.br + +.br + +.IP "\fBstop_bits\fP: 2-8" 0 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +.br + +.br + +.EX +#define PI_MIN_WAVE_HALFSTOPBITS 2 +.br +#define PI_MAX_WAVE_HALFSTOPBITS 8 +.br + +.EE + +.br + +.br + +.IP "\fB*str\fP" 0 + An array of characters. + +.br + +.br + +.IP "\fBthread_func\fP" 0 +A function of type gpioThreadFunc_t used as the main function of a +thread. + +.br + +.br + +.IP "\fBtimeout\fP" 0 +A GPIO watchdog timeout in milliseconds. + +.br + +.br + +.EX +PI_MIN_WDOG_TIMEOUT 0 +.br +PI_MAX_WDOG_TIMEOUT 60000 +.br + +.EE + +.br + +.br + +.IP "\fB*txBuf\fP" 0 +An array of bytes to transmit. + +.br + +.br + +.IP "\fBuint32_t\fP: 0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF)" 0 +A 32-bit unsigned value. + +.br + +.br + +.IP "\fBunsigned\fP" 0 +A whole number >= 0. + +.br + +.br + +.IP "\fBuser_gpio\fP" 0 +0-31, a Broadcom numbered GPIO. + +.br + +.br +See \fBgpio\fP. + +.br + +.br + +.IP "\fB*userdata\fP" 0 + +.br + +.br +A pointer to arbitrary user data. This may be used to identify the instance. + +.br + +.br +You must ensure that the pointer is in scope at the time it is processed. If +it is a pointer to a global this is automatic. Do not pass the address of a +local variable. If you want to pass a transient object then use the +following technique. + +.br + +.br +In the calling function: + +.br + +.br + +.EX +user_type *userdata; +.br +.br +.br +user_type my_userdata; +.br + +.br +userdata = malloc(sizeof(user_type)); +.br +.br +.br +*userdata = my_userdata; +.br + +.EE + +.br + +.br +In the receiving function: + +.br + +.br + +.EX +user_type my_userdata = *(user_type*)userdata; +.br + +.br +free(userdata); +.br + +.EE + +.br + +.br + +.IP "\fBvoid\fP" 0 +Denoting no parameter is required + +.br + +.br + +.IP "\fBwave_add_*\fP" 0 +One of + +.br + +.br +\fBwave_add_new\fP +.br +\fBwave_add_generic\fP +.br +\fBwave_add_serial\fP + +.br + +.br + +.IP "\fBwave_id\fP" 0 +A number representing a waveform created by \fBwave_create\fP. + +.br + +.br + +.IP "\fBwave_send_*\fP" 0 +One of + +.br + +.br +\fBwave_send_once\fP +.br +\fBwave_send_repeat\fP + +.br + +.br + +.IP "\fBwVal\fP: 0-65535 (Hex 0x0-0xFFFF, Octal 0-0177777)" 0 +A 16-bit word value. + +.br + +.br +.SH pigpiod_if2 Error Codes + +.EX + +.br +typedef enum +.br +{ +.br + pigif_bad_send = -2000, +.br + pigif_bad_recv = -2001, +.br + pigif_bad_getaddrinfo = -2002, +.br + pigif_bad_connect = -2003, +.br + pigif_bad_socket = -2004, +.br + pigif_bad_noib = -2005, +.br + pigif_duplicate_callback = -2006, +.br + pigif_bad_malloc = -2007, +.br + pigif_bad_callback = -2008, +.br + pigif_notify_failed = -2009, +.br + pigif_callback_not_found = -2010, +.br + pigif_unconnected_pi = -2011, +.br + pigif_too_many_pis = -2012, +.br +} pigifError_t; +.br + +.br + +.EE + +.SH SEE ALSO + +pigpiod(1), pig2vcd(1), pigs(1), pigpio(3), pigpiod_if(3) +.SH AUTHOR + +joan@abyz.me.uk diff --git a/pigpio-master/pigpiod_if2.c b/pigpio-master/pigpiod_if2.c new file mode 100644 index 0000000..f8dc9c7 --- /dev/null +++ b/pigpio-master/pigpiod_if2.c @@ -0,0 +1,2126 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* PIGPIOD_IF2_VERSION 17 */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include + +#include + +#include "pigpio.h" +#include "command.h" + +#include "pigpiod_if2.h" + +#define PI_MAX_REPORTS_PER_READ 4096 + +#define STACK_SIZE (256*1024) + +#define MAX_PI 32 + +typedef void (*CBF_t) (); + +struct callback_s +{ + + int id; + int pi; + int gpio; + int edge; + CBF_t f; + void * user; + int ex; + callback_t *prev; + callback_t *next; +}; + +struct evtCallback_s +{ + + int id; + int pi; + int event; + CBF_t f; + void * user; + int ex; + evtCallback_t *prev; + evtCallback_t *next; +}; + +/* GLOBALS ---------------------------------------------------------------- */ + +static int gPiInUse [MAX_PI]; + +static int gPigCommand [MAX_PI]; +static int gPigHandle [MAX_PI]; +static int gPigNotify [MAX_PI]; + +static uint32_t gEventBits [MAX_PI]; +static uint32_t gNotifyBits [MAX_PI]; +static uint32_t gLastLevel [MAX_PI]; + +static pthread_t *gPthNotify [MAX_PI]; + +static pthread_mutex_t gCmdMutex [MAX_PI]; +static int gCancelState [MAX_PI]; + +static callback_t *gCallBackFirst = 0; +static callback_t *gCallBackLast = 0; + +static evtCallback_t *geCallBackFirst = 0; +static evtCallback_t *geCallBackLast = 0; + +/* PRIVATE ---------------------------------------------------------------- */ + +static void _pml(int pi) +{ + int cancelState; + + pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, &cancelState); + pthread_mutex_lock(&gCmdMutex[pi]); + gCancelState[pi] = cancelState; +} + +static void _pmu(int pi) +{ + int cancelState; + + cancelState = gCancelState[pi]; + pthread_mutex_unlock(&gCmdMutex[pi]); + pthread_setcancelstate(cancelState, NULL); +} + +static int pigpio_command(int pi, int command, int p1, int p2, int rl) +{ + cmdCmd_t cmd; + + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) + return pigif_unconnected_pi; + + cmd.cmd = command; + cmd.p1 = p1; + cmd.p2 = p2; + cmd.res = 0; + + _pml(pi); + + if (send(gPigCommand[pi], &cmd, sizeof(cmd), 0) != sizeof(cmd)) + { + _pmu(pi); + return pigif_bad_send; + } + + if (recv(gPigCommand[pi], &cmd, sizeof(cmd), MSG_WAITALL) != sizeof(cmd)) + { + _pmu(pi); + return pigif_bad_recv; + } + + if (rl) _pmu(pi); + + return cmd.res; +} + +static int pigpio_notify(int pi) +{ + cmdCmd_t cmd; + + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) + return pigif_unconnected_pi; + + cmd.cmd = PI_CMD_NOIB; + cmd.p1 = 0; + cmd.p2 = 0; + cmd.res = 0; + + _pml(pi); + + if (send(gPigNotify[pi], &cmd, sizeof(cmd), 0) != sizeof(cmd)) + { + _pmu(pi); + return pigif_bad_send; + } + + if (recv(gPigNotify[pi], &cmd, sizeof(cmd), MSG_WAITALL) != sizeof(cmd)) + { + _pmu(pi); + return pigif_bad_recv; + } + + _pmu(pi); + + return cmd.res; +} + +static int pigpio_command_ext + (int pi, int command, int p1, int p2, int p3, + int extents, gpioExtent_t *ext, int rl) +{ + int i; + cmdCmd_t cmd; + + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) + return pigif_unconnected_pi; + + cmd.cmd = command; + cmd.p1 = p1; + cmd.p2 = p2; + cmd.p3 = p3; + + _pml(pi); + + if (send(gPigCommand[pi], &cmd, sizeof(cmd), 0) != sizeof(cmd)) + { + _pmu(pi); + return pigif_bad_send; + } + + for (i=0; iai_next) + { + sock = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); + + if (sock == -1) continue; + + /* Disable the Nagle algorithm. */ + opt = 1; + setsockopt(sock, IPPROTO_TCP, TCP_NODELAY, (char*)&opt, sizeof(int)); + + if (connect(sock, rp->ai_addr, rp->ai_addrlen) != -1) break; + } + + freeaddrinfo(res); + + if (rp == NULL) return pigif_bad_connect; + + return sock; +} + +static void dispatch_notification(int pi, gpioReport_t *r) +{ + callback_t *p; + evtCallback_t *ep; + uint32_t changed; + int l, g; + +/* + printf("s=%4x f=%4x t=%10u l=%8x\n", + r->seqno, r->flags, r->tick, r->level); +*/ + + if (r->flags == 0) + { + changed = (r->level ^ gLastLevel[pi]) & gNotifyBits[pi]; + + gLastLevel[pi] = r->level; + + p = gCallBackFirst; + + while (p) + { + if (((p->pi) == pi) && (changed & (1<<(p->gpio)))) + { + if ((r->level) & (1<<(p->gpio))) l = 1; else l = 0; + if ((p->edge) ^ l) + { + if (p->ex) (p->f)(pi, p->gpio, l, r->tick, p->user); + else (p->f)(pi, p->gpio, l, r->tick); + } + } + p = p->next; + } + } + else + { + if ((r->flags) & PI_NTFY_FLAGS_WDOG) + { + g = (r->flags) & 31; + + p = gCallBackFirst; + + while (p) + { + if (((p->pi) == pi) && ((p->gpio) == g)) + { + if (p->ex) (p->f)(pi, g, PI_TIMEOUT, r->tick, p->user); + else (p->f)(pi, g, PI_TIMEOUT, r->tick); + } + p = p->next; + } + } + else if ((r->flags) & PI_NTFY_FLAGS_EVENT) + { + g = (r->flags) & 31; + + ep = geCallBackFirst; + + while (ep) + { + if (((ep->pi) == pi) && ((ep->event) == g)) + { + if (ep->ex) (ep->f)(pi, g, r->tick, ep->user); + else (ep->f)(pi, g, r->tick); + } + ep = ep->next; + } + } + } +} + +static void *pthNotifyThread(void *x) +{ + static int got = 0; + int pi; + int bytes, r; + gpioReport_t report[PI_MAX_REPORTS_PER_READ]; + + pi = *((int*)x); + free(x); /* memory allocated in pigpio_start */ + + while (1) + { + bytes = read(gPigNotify[pi], (char*)&report+got, sizeof(report)-got); + + if (bytes > 0) got += bytes; + else break; + + r = 0; + + while (got >= sizeof(gpioReport_t)) + { + dispatch_notification(pi, &report[r]); + + r++; + + got -= sizeof(gpioReport_t); + } + + /* copy any partial report to start of array */ + + if (got && r) report[0] = report[r]; + } + + fprintf(stderr, "notify thread for pi %d broke with read error %d\n", + pi, bytes); + + while (1) sleep(1); + + return NULL; +} + +static void findNotifyBits(int pi) +{ + callback_t *p; + uint32_t bits = 0; + + p = gCallBackFirst; + + while (p) + { + if (p->pi == pi) bits |= (1<<(p->gpio)); + p = p->next; + } + + if (bits != gNotifyBits[pi]) + { + gNotifyBits[pi] = bits; + pigpio_command(pi, PI_CMD_NB, gPigHandle[pi], gNotifyBits[pi], 1); + } +} + +static void _wfe( + int pi, unsigned user_gpio, unsigned level, uint32_t tick, void *user) +{ + *(int *)user = 1; +} + +static int intCallback( + int pi, unsigned user_gpio, unsigned edge, void *f, void *user, int ex) +{ + static int id = 0; + callback_t *p; + + if ((user_gpio >=0) && (user_gpio < 32) && (edge >=0) && (edge <= 2) && f) + { + /* prevent duplicates */ + + p = gCallBackFirst; + + while (p) + { + if ((p->pi == pi) && + (p->gpio == user_gpio) && + (p->edge == edge) && + (p->f == f)) + { + return pigif_duplicate_callback; + } + p = p->next; + } + + p = malloc(sizeof(callback_t)); + + if (p) + { + if (!gCallBackFirst) gCallBackFirst = p; + + p->id = id++; + p->pi = pi; + p->gpio = user_gpio; + p->edge = edge; + p->f = f; + p->user = user; + p->ex = ex; + p->next = 0; + p->prev = gCallBackLast; + + if (p->prev) (p->prev)->next = p; + gCallBackLast = p; + + findNotifyBits(pi); + + return p->id; + } + + return pigif_bad_malloc; + } + + return pigif_bad_callback; +} + +static void findEventBits(int pi) +{ + evtCallback_t *ep; + uint32_t bits = 0; + + ep = geCallBackFirst; + + while (ep) + { + if (ep->pi == pi) bits |= (1<<(ep->event)); + ep = ep->next; + } + + if (bits != gEventBits[pi]) + { + gEventBits[pi] = bits; + pigpio_command(pi, PI_CMD_EVM, gPigHandle[pi], gEventBits[pi], 1); + } +} + +static void _ewfe( + int pi, unsigned event, uint32_t tick, void *user) +{ + *(int *)user = 1; +} + +static int intEventCallback( + int pi, unsigned event, void *f, void *user, int ex) +{ + static int id = 0; + evtCallback_t *ep; + + if ((event >=0) && (event < 32) && f) + { + /* prevent duplicates */ + + ep = geCallBackFirst; + + while (ep) + { + if ((ep->pi == pi) && + (ep->event == event) && + (ep->f == f)) + { + return pigif_duplicate_callback; + } + ep = ep->next; + } + + ep = malloc(sizeof(evtCallback_t)); + + if (ep) + { + if (!geCallBackFirst) geCallBackFirst = ep; + + ep->id = id++; + ep->pi = pi; + ep->event = event; + ep->f = f; + ep->user = user; + ep->ex = ex; + ep->next = 0; + ep->prev = geCallBackLast; + + if (ep->prev) (ep->prev)->next = ep; + geCallBackLast = ep; + + findEventBits(pi); + + return ep->id; + } + + return pigif_bad_malloc; + } + + return pigif_bad_callback; +} + +static int recvMax(int pi, void *buf, int bufsize, int sent) +{ + /* + Copy at most bufSize bytes from the receieved message to + buf. Discard the rest of the message. + */ + uint8_t scratch[4096]; + int remaining, fetch, count; + + if (sent < bufsize) count = sent; else count = bufsize; + + if (count) recv(gPigCommand[pi], buf, count, MSG_WAITALL); + + remaining = sent - count; + + while (remaining) + { + fetch = remaining; + if (fetch > sizeof(scratch)) fetch = sizeof(scratch); + recv(gPigCommand[pi], scratch, fetch, MSG_WAITALL); + remaining -= fetch; + } + + return count; +} + +/* PUBLIC ----------------------------------------------------------------- */ + +double time_time(void) +{ + struct timeval tv; + double t; + + gettimeofday(&tv, 0); + + t = (double)tv.tv_sec + ((double)tv.tv_usec / 1E6); + + return t; +} + +void time_sleep(double seconds) +{ + struct timespec ts, rem; + + if (seconds > 0.0) + { + ts.tv_sec = seconds; + ts.tv_nsec = (seconds-(double)ts.tv_sec) * 1E9; + + while (clock_nanosleep(CLOCK_REALTIME, 0, &ts, &rem)) + { + /* copy remaining time to ts */ + ts.tv_sec = rem.tv_sec; + ts.tv_nsec = rem.tv_nsec; + } + } +} + +char *pigpio_error(int errnum) +{ + if (errnum > -1000) return cmdErrStr(errnum); + else + { + switch(errnum) + { + case pigif_bad_send: + return "failed to send to pigpiod"; + case pigif_bad_recv: + return "failed to receive from pigpiod"; + case pigif_bad_getaddrinfo: + return "failed to find address of pigpiod"; + case pigif_bad_connect: + return "failed to connect to pigpiod"; + case pigif_bad_socket: + return "failed to create socket"; + case pigif_bad_noib: + return "failed to open notification in band"; + case pigif_duplicate_callback: + return "identical callback exists"; + case pigif_bad_malloc: + return "failed to malloc"; + case pigif_bad_callback: + return "bad callback parameter"; + case pigif_notify_failed: + return "failed to create notification thread"; + case pigif_callback_not_found: + return "callback not found"; + case pigif_unconnected_pi: + return "not connected to Pi"; + case pigif_too_many_pis: + return "too many connected Pis"; + + default: + return "unknown error"; + } + } +} + +unsigned pigpiod_if_version(void) +{ + return PIGPIOD_IF2_VERSION; +} + +pthread_t *start_thread(gpioThreadFunc_t thread_func, void *userdata) +{ + pthread_t *pth; + pthread_attr_t pthAttr; + + pth = malloc(sizeof(pthread_t)); + + if (pth) + { + if (pthread_attr_init(&pthAttr)) + { + perror("pthread_attr_init failed"); + free(pth); + return NULL; + } + + if (pthread_attr_setstacksize(&pthAttr, STACK_SIZE)) + { + perror("pthread_attr_setstacksize failed"); + free(pth); + return NULL; + } + + if (pthread_create(pth, &pthAttr, thread_func, userdata)) + { + perror("pthread_create socket failed"); + free(pth); + return NULL; + } + } + return pth; +} + +void stop_thread(pthread_t *pth) +{ + if (pth) + { + pthread_cancel(*pth); + pthread_join(*pth, NULL); + free(pth); + } +} + +int pigpio_start(const char *addrStr, const char *portStr) +{ + int pi; + int *userdata; + + for (pi=0; pi= MAX_PI) return pigif_too_many_pis; + + gPiInUse[pi] = 1; + + if ((!addrStr) || (!strlen(addrStr))) + { + addrStr = getenv(PI_ENVADDR); + + if ((!addrStr) || (!strlen(addrStr))) + { + addrStr = PI_DEFAULT_SOCKET_ADDR_STR; + } + } + + if ((!portStr) || (!strlen(portStr))) + { + portStr = getenv(PI_ENVPORT); + + if ((!portStr) || (!strlen(portStr))) + { + portStr = PI_DEFAULT_SOCKET_PORT_STR; + } + } + + pthread_mutex_init(&gCmdMutex[pi], NULL); + + gPigCommand[pi] = pigpioOpenSocket(addrStr, portStr); + + if (gPigCommand[pi] >= 0) + { + gPigNotify[pi] = pigpioOpenSocket(addrStr, portStr); + + if (gPigNotify[pi] >= 0) + { + gPigHandle[pi] = pigpio_notify(pi); + + if (gPigHandle[pi] < 0) return pigif_bad_noib; + else + { + gLastLevel[pi] = read_bank_1(pi); + + /* must be freed by pthNotifyThread */ + userdata = malloc(sizeof(*userdata)); + *userdata = pi; + + gPthNotify[pi] = start_thread(pthNotifyThread, userdata); + + if (gPthNotify[pi]) return pi; + else return pigif_notify_failed; + + } + } + else return gPigNotify[pi]; + } + else return gPigCommand[pi]; +} + +void pigpio_stop(int pi) +{ + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) return; + + if (gPthNotify[pi]) + { + stop_thread(gPthNotify[pi]); + gPthNotify[pi] = 0; + } + + if (gPigCommand[pi] >= 0) + { + if (gPigHandle[pi] >= 0) + { + pigpio_command(pi, PI_CMD_NC, gPigHandle[pi], 0, 1); + gPigHandle[pi] = -1; + } + + close(gPigCommand[pi]); + gPigCommand[pi] = -1; + } + + if (gPigNotify[pi] >= 0) + { + close(gPigNotify[pi]); + gPigNotify[pi] = -1; + } + + gPiInUse[pi] = 0; +} + +int set_mode(int pi, unsigned gpio, unsigned mode) + {return pigpio_command(pi, PI_CMD_MODES, gpio, mode, 1);} + +int get_mode(int pi, unsigned gpio) + {return pigpio_command(pi, PI_CMD_MODEG, gpio, 0, 1);} + +int set_pull_up_down(int pi, unsigned gpio, unsigned pud) + {return pigpio_command(pi, PI_CMD_PUD, gpio, pud, 1);} + +int gpio_read(int pi, unsigned gpio) + {return pigpio_command(pi, PI_CMD_READ, gpio, 0, 1);} + +int gpio_write(int pi, unsigned gpio, unsigned level) + {return pigpio_command(pi, PI_CMD_WRITE, gpio, level, 1);} + +int set_PWM_dutycycle(int pi, unsigned user_gpio, unsigned dutycycle) + {return pigpio_command(pi, PI_CMD_PWM, user_gpio, dutycycle, 1);} + +int get_PWM_dutycycle(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_GDC, user_gpio, 0, 1);} + +int set_PWM_range(int pi, unsigned user_gpio, unsigned range) + {return pigpio_command(pi, PI_CMD_PRS, user_gpio, range, 1);} + +int get_PWM_range(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_PRG, user_gpio, 0, 1);} + +int get_PWM_real_range(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_PRRG, user_gpio, 0, 1);} + +int set_PWM_frequency(int pi, unsigned user_gpio, unsigned frequency) + {return pigpio_command(pi, PI_CMD_PFS, user_gpio, frequency, 1);} + +int get_PWM_frequency(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_PFG, user_gpio, 0, 1);} + +int set_servo_pulsewidth(int pi, unsigned user_gpio, unsigned pulsewidth) + {return pigpio_command(pi, PI_CMD_SERVO, user_gpio, pulsewidth, 1);} + +int get_servo_pulsewidth(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_GPW, user_gpio, 0, 1);} + +int notify_open(int pi) + {return pigpio_command(pi, PI_CMD_NO, 0, 0, 1);} + +int notify_begin(int pi, unsigned handle, uint32_t bits) + {return pigpio_command(pi, PI_CMD_NB, handle, bits, 1);} + +int notify_pause(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_NB, handle, 0, 1);} + +int notify_close(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_NC, handle, 0, 1);} + +int set_watchdog(int pi, unsigned user_gpio, unsigned timeout) + {return pigpio_command(pi, PI_CMD_WDOG, user_gpio, timeout, 1);} + +uint32_t read_bank_1(int pi) + {return pigpio_command(pi, PI_CMD_BR1, 0, 0, 1);} + +uint32_t read_bank_2(int pi) + {return pigpio_command(pi, PI_CMD_BR2, 0, 0, 1);} + +int clear_bank_1(int pi, uint32_t levels) + {return pigpio_command(pi, PI_CMD_BC1, levels, 0, 1);} + +int clear_bank_2(int pi, uint32_t levels) + {return pigpio_command(pi, PI_CMD_BC2, levels, 0, 1);} + +int set_bank_1(int pi, uint32_t levels) + {return pigpio_command(pi, PI_CMD_BS1, levels, 0, 1);} + +int set_bank_2(int pi, uint32_t levels) + {return pigpio_command(pi, PI_CMD_BS2, levels, 0, 1);} + +int hardware_clock(int pi, unsigned gpio, unsigned frequency) + {return pigpio_command(pi, PI_CMD_HC, gpio, frequency, 1);} + +int hardware_PWM(int pi, unsigned gpio, unsigned frequency, uint32_t dutycycle) +{ + gpioExtent_t ext[1]; + + /* + p1=gpio + p2=frequency + p3=4 + ## extension ## + uint32_t dutycycle + */ + + ext[0].size = sizeof(dutycycle); + ext[0].ptr = &dutycycle; + + return pigpio_command_ext( + pi, PI_CMD_HP, gpio, frequency, sizeof(dutycycle), 1, ext, 1); +} + +uint32_t get_current_tick(int pi) + {return pigpio_command(pi, PI_CMD_TICK, 0, 0, 1);} + +uint32_t get_hardware_revision(int pi) + {return pigpio_command(pi, PI_CMD_HWVER, 0, 0, 1);} + +uint32_t get_pigpio_version(int pi) + {return pigpio_command(pi, PI_CMD_PIGPV, 0, 0, 1);} + +int wave_clear(int pi) + {return pigpio_command(pi, PI_CMD_WVCLR, 0, 0, 1);} + +int wave_add_new(int pi) + {return pigpio_command(pi, PI_CMD_WVNEW, 0, 0, 1);} + +int wave_add_generic(int pi, unsigned numPulses, gpioPulse_t *pulses) +{ + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=pulses*sizeof(gpioPulse_t) + ## extension ## + gpioPulse_t[] pulses + */ + + if (!numPulses) return 0; + + ext[0].size = numPulses * sizeof(gpioPulse_t); + ext[0].ptr = pulses; + + return pigpio_command_ext( + pi, PI_CMD_WVAG, 0, 0, ext[0].size, 1, ext, 1); +} + +int wave_add_serial( + int pi, unsigned user_gpio, unsigned baud, uint32_t databits, + uint32_t stophalfbits, uint32_t offset, unsigned numChar, char *str) +{ + uint8_t buf[12]; + gpioExtent_t ext[2]; + + /* + p1=user_gpio + p2=baud + p3=len+12 + ## extension ## + uint32_t databits + uint32_t stophalfbits + uint32_t offset + char[len] str + */ + + if (!numChar) return 0; + + memcpy(buf, &databits, 4); + memcpy(buf+4, &stophalfbits, 4); + memcpy(buf+8, &offset, 4); + + ext[0].size = sizeof(buf); + ext[0].ptr = buf; + + ext[1].size = numChar; + ext[1].ptr = str; + + return pigpio_command_ext(pi, PI_CMD_WVAS, + user_gpio, baud, numChar+sizeof(buf), 2, ext, 1); +} + +int wave_create(int pi) + {return pigpio_command(pi, PI_CMD_WVCRE, 0, 0, 1);} + +int wave_create_and_pad(int pi, int percent) + {return pigpio_command(pi, PI_CMD_WVCAP, percent, 0, 1);} + +int wave_delete(int pi, unsigned wave_id) + {return pigpio_command(pi, PI_CMD_WVDEL, wave_id, 0, 1);} + +int wave_tx_start(int pi) /* DEPRECATED */ + {return pigpio_command(pi, PI_CMD_WVGO, 0, 0, 1);} + +int wave_tx_repeat(int pi) /* DEPRECATED */ + {return pigpio_command(pi, PI_CMD_WVGOR, 0, 0, 1);} + +int wave_send_once(int pi, unsigned wave_id) + {return pigpio_command(pi, PI_CMD_WVTX, wave_id, 0, 1);} + +int wave_send_repeat(int pi, unsigned wave_id) + {return pigpio_command(pi, PI_CMD_WVTXR, wave_id, 0, 1);} + +int wave_send_using_mode(int pi, unsigned wave_id, unsigned mode) + {return pigpio_command(pi, PI_CMD_WVTXM, wave_id, mode, 1);} + +int wave_chain(int pi, char *buf, unsigned bufSize) +{ + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=bufSize + ## extension ## + char buf[bufSize] + */ + + ext[0].size = bufSize; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_WVCHA, 0, 0, bufSize, 1, ext, 1); +} + +int wave_tx_at(int pi) + {return pigpio_command(pi, PI_CMD_WVTAT, 0, 0, 1);} + +int wave_tx_busy(int pi) + {return pigpio_command(pi, PI_CMD_WVBSY, 0, 0, 1);} + +int wave_tx_stop(int pi) + {return pigpio_command(pi, PI_CMD_WVHLT, 0, 0, 1);} + +int wave_get_micros(int pi) + {return pigpio_command(pi, PI_CMD_WVSM, 0, 0, 1);} + +int wave_get_high_micros(int pi) + {return pigpio_command(pi, PI_CMD_WVSM, 1, 0, 1);} + +int wave_get_max_micros(int pi) + {return pigpio_command(pi, PI_CMD_WVSM, 2, 0, 1);} + +int wave_get_pulses(int pi) + {return pigpio_command(pi, PI_CMD_WVSP, 0, 0, 1);} + +int wave_get_high_pulses(int pi) + {return pigpio_command(pi, PI_CMD_WVSP, 1, 0, 1);} + +int wave_get_max_pulses(int pi) + {return pigpio_command(pi, PI_CMD_WVSP, 2, 0, 1);} + +int wave_get_cbs(int pi) + {return pigpio_command(pi, PI_CMD_WVSC, 0, 0, 1);} + +int wave_get_high_cbs(int pi) + {return pigpio_command(pi, PI_CMD_WVSC, 1, 0, 1);} + +int wave_get_max_cbs(int pi) + {return pigpio_command(pi, PI_CMD_WVSC, 2, 0, 1);} + +int gpio_trigger(int pi, unsigned user_gpio, unsigned pulseLen, uint32_t level) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=pulseLen + p3=4 + ## extension ## + unsigned level + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &level; + + return pigpio_command_ext( + pi, PI_CMD_TRIG, user_gpio, pulseLen, 4, 1, ext, 1); +} + +int set_glitch_filter(int pi, unsigned user_gpio, unsigned steady) + {return pigpio_command(pi, PI_CMD_FG, user_gpio, steady, 1);} + +int set_noise_filter(int pi, unsigned user_gpio, unsigned steady, unsigned active) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=steady + p3=4 + ## extension ## + unsigned active + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &active; + + return pigpio_command_ext( + pi, PI_CMD_FN, user_gpio, steady, 4, 1, ext, 1); +} + +int store_script(int pi, char *script) +{ + unsigned len; + gpioExtent_t ext[1]; + + /* + p1=0 + p2=0 + p3=len + ## extension ## + char[len] script + */ + + len = strlen(script); + + if (!len) return 0; + + ext[0].size = len; + ext[0].ptr = script; + + return pigpio_command_ext(pi, PI_CMD_PROC, 0, 0, len, 1, ext, 1); +} + +int run_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param) +{ + gpioExtent_t ext[1]; + + /* + p1=script id + p2=0 + p3=numPar * 4 + ## extension ## + uint32_t[numPar] pars + */ + + ext[0].size = 4 * numPar; + ext[0].ptr = param; + + return pigpio_command_ext + (pi, PI_CMD_PROCR, script_id, 0, numPar*4, 1, ext, 1); +} + +int update_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param) +{ + gpioExtent_t ext[1]; + + /* + p1=script id + p2=0 + p3=numPar * 4 + ## extension ## + uint32_t[numPar] pars + */ + + ext[0].size = 4 * numPar; + ext[0].ptr = param; + + return pigpio_command_ext + (pi, PI_CMD_PROCU, script_id, 0, numPar*4, 1, ext, 1); +} + +int script_status(int pi, unsigned script_id, uint32_t *param) +{ + int status; + uint32_t p[PI_MAX_SCRIPT_PARAMS+1]; /* space for script status */ + + status = pigpio_command(pi, PI_CMD_PROCP, script_id, 0, 0); + + if (status > 0) + { + recvMax(pi, p, sizeof(p), status); + status = p[0]; + if (param) memcpy(param, p+1, sizeof(p)-4); + } + + _pmu(pi); + + return status; +} + +int stop_script(int pi, unsigned script_id) + {return pigpio_command(pi, PI_CMD_PROCS, script_id, 0, 1);} + +int delete_script(int pi, unsigned script_id) + {return pigpio_command(pi, PI_CMD_PROCD, script_id, 0, 1);} + +int bb_serial_read_open(int pi, unsigned user_gpio, unsigned baud, uint32_t bbBits) +{ + gpioExtent_t ext[1]; + + /* + p1=user_gpio + p2=baud + p3=4 + ## extension ## + unsigned bbBits + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &bbBits; + + return pigpio_command_ext( + pi, PI_CMD_SLRO, user_gpio, baud, 4, 1, ext, 1); +} + +int bb_serial_read(int pi, unsigned user_gpio, void *buf, size_t bufSize) +{ + int bytes; + + bytes = pigpio_command(pi, PI_CMD_SLR, user_gpio, bufSize, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, bufSize, bytes); + } + + _pmu(pi); + + return bytes; +} + +int bb_serial_read_close(int pi, unsigned user_gpio) + {return pigpio_command(pi, PI_CMD_SLRC, user_gpio, 0, 1);} + +int bb_serial_invert(int pi, unsigned user_gpio, unsigned invert) + {return pigpio_command(pi, PI_CMD_SLRI, user_gpio, invert, 1);} + +int i2c_open(int pi, unsigned i2c_bus, unsigned i2c_addr, uint32_t i2c_flags) +{ + gpioExtent_t ext[1]; + + /* + p1=i2c_bus + p2=i2c_addr + p3=4 + ## extension ## + uint32_t i2c_flags + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &i2c_flags; + + return pigpio_command_ext + (pi, PI_CMD_I2CO, i2c_bus, i2c_addr, 4, 1, ext, 1); +} + +int i2c_close(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_I2CC, handle, 0, 1);} + +int i2c_write_quick(int pi, unsigned handle, unsigned bit) + {return pigpio_command(pi, PI_CMD_I2CWQ, handle, bit, 1);} + +int i2c_write_byte(int pi, unsigned handle, unsigned val) + {return pigpio_command(pi, PI_CMD_I2CWS, handle, val, 1);} + +int i2c_read_byte(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_I2CRS, handle, 0, 1);} + +int i2c_write_byte_data(int pi, unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (pi, PI_CMD_I2CWB, handle, reg, 4, 1, ext, 1); +} + +int i2c_write_word_data(int pi, unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (pi, PI_CMD_I2CWW, handle, reg, 4, 1, ext, 1); +} + +int i2c_read_byte_data(int pi, unsigned handle, unsigned reg) + {return pigpio_command(pi, PI_CMD_I2CRB, handle, reg, 1);} + +int i2c_read_word_data(int pi, unsigned handle, unsigned reg) + {return pigpio_command(pi, PI_CMD_I2CRW, handle, reg, 1);} + +int i2c_process_call(int pi, unsigned handle, unsigned reg, uint32_t val) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t val + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &val; + + return pigpio_command_ext + (pi, PI_CMD_I2CPC, handle, reg, 4, 1, ext, 1); +} + +int i2c_write_block_data( + int pi, unsigned handle, unsigned reg, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_I2CWK, handle, reg, count, 1, ext, 1); +} + +int i2c_read_block_data(int pi, unsigned handle, unsigned reg, char *buf) +{ + int bytes; + + bytes = pigpio_command(pi, PI_CMD_I2CRK, handle, reg, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, 32, bytes); + } + + _pmu(pi); + + return bytes; +} + +int i2c_block_process_call( + int pi, unsigned handle, unsigned reg, char *buf, unsigned count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + bytes = pigpio_command_ext + (pi, PI_CMD_I2CPK, handle, reg, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, 32, bytes); + } + + _pmu(pi); + + return bytes; +} + +int i2c_read_i2c_block_data( + int pi, unsigned handle, unsigned reg, char *buf, uint32_t count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=4 + ## extension ## + uint32_t count + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &count; + + bytes = pigpio_command_ext + (pi, PI_CMD_I2CRI, handle, reg, 4, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + + +int i2c_write_i2c_block_data( + int pi, unsigned handle, unsigned reg, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=reg + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_I2CWI, handle, reg, count, 1, ext, 1); +} + +int i2c_read_device(int pi, unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command(pi, PI_CMD_I2CRD, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int i2c_write_device(int pi, unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_I2CWD, handle, 0, count, 1, ext, 1); +} + +int i2c_zip( + int pi, + unsigned handle, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=inLen + ## extension ## + char inBuf[inLen] + */ + + ext[0].size = inLen; + ext[0].ptr = inBuf; + + bytes = pigpio_command_ext + (pi, PI_CMD_I2CZ, handle, 0, inLen, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, outBuf, outLen, bytes); + } + + _pmu(pi); + + return bytes; +} + +int bb_i2c_open(int pi, unsigned SDA, unsigned SCL, unsigned baud) +{ + gpioExtent_t ext[1]; + + /* + p1=SDA + p2=SCL + p3=4 + ## extension ## + uint32_t baud + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &baud; + + return pigpio_command_ext + (pi, PI_CMD_BI2CO, SDA, SCL, 4, 1, ext, 1); +} + +int bb_i2c_close(int pi, unsigned SDA) + {return pigpio_command(pi, PI_CMD_BI2CC, SDA, 0, 1);} + +int bb_i2c_zip( + int pi, + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=SDA + p2=0 + p3=inLen + ## extension ## + char inBuf[inLen] + */ + + ext[0].size = inLen; + ext[0].ptr = inBuf; + + bytes = pigpio_command_ext + (pi, PI_CMD_BI2CZ, SDA, 0, inLen, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, outBuf, outLen, bytes); + } + + _pmu(pi); + + return bytes; +} + +int bb_spi_open( + int pi, + unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, + unsigned baud, unsigned spiFlags) +{ + uint8_t buf[20]; + gpioExtent_t ext[1]; + + /* + p1=CS + p2=0 + p3=20 + ## extension ## + uint32_t MISO + uint32_t MOSI + uint32_t SCLK + uint32_t baud + uint32_t spiFlags + */ + + ext[0].size = 20; + ext[0].ptr = &buf; + + memcpy(buf + 0, &MISO, 4); + memcpy(buf + 4, &MOSI, 4); + memcpy(buf + 8, &SCLK, 4); + memcpy(buf + 12, &baud, 4); + memcpy(buf + 16, &spiFlags, 4); + + return pigpio_command_ext + (pi, PI_CMD_BSPIO, CS, 0, 20, 1, ext, 1); +} + +int bb_spi_close(int pi, unsigned CS) + {return pigpio_command(pi, PI_CMD_BSPIC, CS, 0, 1);} + +int bb_spi_xfer( + int pi, + unsigned CS, + char *txBuf, + char *rxBuf, + unsigned count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=CS + p2=0 + p3=count + ## extension ## + char txBuf[count] + */ + + ext[0].size = count; + ext[0].ptr = txBuf; + + bytes = pigpio_command_ext + (pi, PI_CMD_BSPIX, CS, 0, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, rxBuf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int spi_open(int pi, unsigned channel, unsigned speed, uint32_t flags) +{ + gpioExtent_t ext[1]; + + /* + p1=channel + p2=speed + p3=4 + ## extension ## + uint32_t flags + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &flags; + + return pigpio_command_ext + (pi, PI_CMD_SPIO, channel, speed, 4, 1, ext, 1); +} + +int spi_close(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_SPIC, handle, 0, 1);} + +int spi_read(int pi, unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command + (pi, PI_CMD_SPIR, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int spi_write(int pi, unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_SPIW, handle, 0, count, 1, ext, 1); +} + +int spi_xfer(int pi, unsigned handle, char *txBuf, char *rxBuf, unsigned count) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = txBuf; + + bytes = pigpio_command_ext + (pi, PI_CMD_SPIX, handle, 0, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, rxBuf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int serial_open(int pi, char *dev, unsigned baud, unsigned flags) +{ + int len; + gpioExtent_t ext[1]; + + len = strlen(dev); + + /* + p1=baud + p2=flags + p3=len + ## extension ## + char dev[len] + */ + + ext[0].size = len; + ext[0].ptr = dev; + + return pigpio_command_ext + (pi, PI_CMD_SERO, baud, flags, len, 1, ext, 1); +} + +int serial_close(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_SERC, handle, 0, 1);} + +int serial_write_byte(int pi, unsigned handle, unsigned val) + {return pigpio_command(pi, PI_CMD_SERWB, handle, val, 1);} + +int serial_read_byte(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_SERRB, handle, 0, 1);} + +int serial_write(int pi, unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_SERW, handle, 0, count, 1, ext, 1); +} + +int serial_read(int pi, unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command + (pi, PI_CMD_SERR, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int serial_data_available(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_SERDA, handle, 0, 1);} + +int custom_1(int pi, unsigned arg1, unsigned arg2, char *argx, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=arg1 + p2=arg2 + p3=count + ## extension ## + char argx[count] + */ + + ext[0].size = count; + ext[0].ptr = argx; + + return pigpio_command_ext( + pi, PI_CMD_CF1, arg1, arg2, count, 1, ext, 1); +} + + +int custom_2(int pi, unsigned arg1, char *argx, unsigned count, + char *retBuf, uint32_t retMax) +{ + int bytes; + gpioExtent_t ext[1]; + + /* + p1=arg1 + p2=retMax + p3=count + ## extension ## + char argx[count] + */ + + ext[0].size = count; + ext[0].ptr = argx; + + bytes = pigpio_command_ext + (pi, PI_CMD_CF2, arg1, retMax, count, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, retBuf, retMax, bytes); + } + + _pmu(pi); + + return bytes; +} + +int get_pad_strength(int pi, unsigned pad) + {return pigpio_command(pi, PI_CMD_PADG, pad, 0, 1);} + +int set_pad_strength(int pi, unsigned pad, unsigned padStrength) + {return pigpio_command(pi, PI_CMD_PADS, pad, padStrength, 1);} + +int shell_(int pi, char *scriptName, char *scriptString) +{ + int ln, ls; + gpioExtent_t ext[2]; + + ln = strlen(scriptName); + ls = strlen(scriptString); + /* + p1=len(scriptName) + p2=0 + p3=len(scriptName) + len(scriptString) + 1 + ## extension ## + char[] + */ + + ext[0].size = ln + 1; /* include null byte */ + ext[0].ptr = scriptName; + + ext[1].size = ls; + ext[1].ptr = scriptString; + + return pigpio_command_ext + (pi, PI_CMD_SHELL, ln, 0, ln+ls+1, 2, ext, 1); +} + +int file_open(int pi, char *file, unsigned mode) +{ + int len; + gpioExtent_t ext[1]; + + len = strlen(file); + + /* + p1=mode + p2=0 + p3=len + ## extension ## + char file[len] + */ + + ext[0].size = len; + ext[0].ptr = file; + + return pigpio_command_ext + (pi, PI_CMD_FO, mode, 0, len, 1, ext, 1); +} + +int file_close(int pi, unsigned handle) + {return pigpio_command(pi, PI_CMD_FC, handle, 0, 1);} + +int file_write(int pi, unsigned handle, char *buf, unsigned count) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=0 + p3=count + ## extension ## + char buf[count] + */ + + ext[0].size = count; + ext[0].ptr = buf; + + return pigpio_command_ext + (pi, PI_CMD_FW, handle, 0, count, 1, ext, 1); +} + +int file_read(int pi, unsigned handle, char *buf, unsigned count) +{ + int bytes; + + bytes = pigpio_command + (pi, PI_CMD_FR, handle, count, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int file_seek(int pi, unsigned handle, int32_t seekOffset, int seekFrom) +{ + gpioExtent_t ext[1]; + + /* + p1=handle + p2=seekOffset + p3=4 + ## extension ## + uint32_t seekFrom + */ + + ext[0].size = sizeof(uint32_t); + ext[0].ptr = &seekFrom; + + return pigpio_command_ext + (pi, PI_CMD_FS, handle, seekOffset, 4, 1, ext, 1); +} + +int file_list(int pi, char *fpat, char *buf, unsigned count) +{ + int len; + int bytes; + gpioExtent_t ext[1]; + + len = strlen(fpat); + + /* + p1=60000 + p2=0 + p3=len + ## extension ## + char fpat[len] + */ + + ext[0].size = len; + ext[0].ptr = fpat; + + bytes = pigpio_command_ext(pi, PI_CMD_FL, 60000, 0, len, 1, ext, 0); + + if (bytes > 0) + { + bytes = recvMax(pi, buf, count, bytes); + } + + _pmu(pi); + + return bytes; +} + +int callback(int pi, unsigned user_gpio, unsigned edge, CBFunc_t f) + {return intCallback(pi, user_gpio, edge, f, 0, 0);} + +int callback_ex( + int pi, unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *user) + {return intCallback(pi, user_gpio, edge, f, user, 1);} + +int callback_cancel(unsigned id) +{ + callback_t *p; + int pi; + + p = gCallBackFirst; + + while (p) + { + if (p->id == id) + { + pi = p->pi; + + if (p->prev) {p->prev->next = p->next;} + else {gCallBackFirst = p->next;} + + if (p->next) {p->next->prev = p->prev;} + else {gCallBackLast = p->prev;} + + free(p); + + findNotifyBits(pi); + + return 0; + } + p = p->next; + } + return pigif_callback_not_found; +} + +int wait_for_edge(int pi, unsigned user_gpio, unsigned edge, double timeout) +{ + int triggered = 0; + int id; + double due; + + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) + return pigif_unconnected_pi; + + if (timeout <= 0.0) return 0; + + due = time_time() + timeout; + + id = callback_ex(pi, user_gpio, edge, _wfe, &triggered); + + while (!triggered && (time_time() < due)) time_sleep(0.05); + + callback_cancel(id); + + return triggered; +} + +int bsc_xfer(int pi, bsc_xfer_t *bscxfer) +{ + int bytes; + int status; + gpioExtent_t ext[1]; + + /* + p1=control + p2=0 + p3=len + ## extension ## + char buf[len] + */ + + ext[0].size = bscxfer->txCnt; + ext[0].ptr = bscxfer->txBuf; + + bytes = pigpio_command_ext + (pi, PI_CMD_BSCX, bscxfer->control, 0, bscxfer->txCnt, 1, ext, 0); + + if (bytes > 0) + { + recvMax(pi, &status, 4, 4); + status = ntohl(status); + bytes -= 4; + bytes = recvMax(pi, bscxfer->rxBuf, sizeof(bscxfer->rxBuf), bytes); + bscxfer->rxCnt = bytes; + } + else + { + status = bytes; + } + + _pmu(pi); + + return status; +} + + +int bsc_i2c(int pi, int i2c_addr, bsc_xfer_t *bscxfer) +{ + int control = 0; + + if (i2c_addr) control = (i2c_addr<<16) | 0x305; + bscxfer->control = control; + return bsc_xfer(pi, bscxfer); +} + + +int event_callback(int pi, unsigned event, evtCBFunc_t f) + {return intEventCallback(pi, event, f, 0, 0);} + +int event_callback_ex( + int pi, unsigned event, evtCBFuncEx_t f, void *user) + {return intEventCallback(pi, event, f, user, 1);} + +int event_callback_cancel(unsigned id) +{ + evtCallback_t *ep; + int pi; + + ep = geCallBackFirst; + + while (ep) + { + if (ep->id == id) + { + pi = ep->pi; + + if (ep->prev) {ep->prev->next = ep->next;} + else {geCallBackFirst = ep->next;} + + if (ep->next) {ep->next->prev = ep->prev;} + else {geCallBackLast = ep->prev;} + + free(ep); + + findEventBits(pi); + + return 0; + } + ep = ep->next; + } + return pigif_callback_not_found; +} + +int wait_for_event(int pi, unsigned event, double timeout) +{ + int triggered = 0; + int id; + double due; + + if ((pi < 0) || (pi >= MAX_PI) || !gPiInUse[pi]) + return pigif_unconnected_pi; + + if (timeout <= 0.0) return 0; + + due = time_time() + timeout; + + id = event_callback_ex(pi, event, _ewfe, &triggered); + + while (!triggered && (time_time() < due)) time_sleep(0.05); + + event_callback_cancel(id); + + return triggered; +} + +int event_trigger(int pi, unsigned event) + {return pigpio_command(pi, PI_CMD_EVT, event, 0, 1);} + diff --git a/pigpio-master/pigpiod_if2.h b/pigpio-master/pigpiod_if2.h new file mode 100644 index 0000000..b6aa648 --- /dev/null +++ b/pigpio-master/pigpiod_if2.h @@ -0,0 +1,4388 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +#ifndef PIGPIOD_IF2_H +#define PIGPIOD_IF2_H + +#include "pigpio.h" + +#define PIGPIOD_IF2_VERSION 17 + +/*TEXT + +pigpiod_if2 is a C library for the Raspberry which allows control +of the GPIO via the socket interface to the pigpio daemon. + +*Features* + +o hardware timed PWM on any of GPIO 0-31 + +o hardware timed servo pulses on any of GPIO 0-31 + +o callbacks when any of GPIO 0-31 change state + +o callbacks at timed intervals + +o reading/writing all of the GPIO in a bank as one operation + +o individually setting GPIO modes, reading and writing + +o notifications when any of GPIO 0-31 change state + +o the construction of output waveforms with microsecond timing + +o rudimentary permission control over GPIO + +o a simple interface to start and stop new threads + +o I2C, SPI, and serial link wrappers + +o creating and running scripts on the pigpio daemon + +*GPIO* + +ALL GPIO are identified by their Broadcom number. + +*Notes* + +The PWM and servo pulses are timed using the DMA and PWM/PCM peripherals. + +*Usage* + +Include in your source files. + +Assuming your source is in prog.c use the following command to build + +. . +gcc -Wall -pthread -o prog prog.c -lpigpiod_if2 -lrt +. . + +to run make sure the pigpio daemon is running + +. . +sudo pigpiod + + ./prog # sudo is not required to run programs linked to pigpiod_if2 +. . + +For examples see x_pigpiod_if2.c within the pigpio archive file. + +*Notes* + +All the functions which return an int return < 0 on error + +TEXT*/ + +/*OVERVIEW + +ESSENTIAL + +pigpio_start Connects to a pigpio daemon +pigpio_stop Disconnects from a pigpio daemon + +BASIC + +set_mode Set a GPIO mode +get_mode Get a GPIO mode + +set_pull_up_down Set/clear GPIO pull up/down resistor + +gpio_read Read a GPIO +gpio_write Write a GPIO + +PWM_(overrides_servo_commands_on_same_GPIO) + +set_PWM_dutycycle Start/stop PWM pulses on a GPIO +set_PWM_frequency Configure PWM frequency for a GPIO +set_PWM_range Configure PWM range for a GPIO + +get_PWM_dutycycle Get the PWM dutycycle in use on a GPIO +get_PWM_frequency Get configured PWM frequency for a GPIO +get_PWM_range Get configured PWM range for a GPIO + +get_PWM_real_range Get underlying PWM range for a GPIO + +Servo_(overrides_PWM_commands_on_same_GPIO) + +set_servo_pulsewidth Start/stop servo pulses on a GPIO + +get_servo_pulsewidth Get the servo pulsewidth in use on a GPIO + +INTERMEDIATE + +gpio_trigger Send a trigger pulse to a GPIO. + +set_watchdog Set a watchdog on a GPIO. + +read_bank_1 Read all GPIO in bank 1 +read_bank_2 Read all GPIO in bank 2 + +clear_bank_1 Clear selected GPIO in bank 1 +clear_bank_2 Clear selected GPIO in bank 2 + +set_bank_1 Set selected GPIO in bank 1 +set_bank_2 Set selected GPIO in bank 2 + +callback Create GPIO level change callback +callback_ex Create GPIO level change callback, extended + +callback_cancel Cancel a callback + +wait_for_edge Wait for GPIO level change + +start_thread Start a new thread +stop_thread Stop a previously started thread + +ADVANCED + +notify_open Request a notification handle +notify_begin Start notifications for selected GPIO +notify_pause Pause notifications +notify_close Close a notification + +hardware_clock Start hardware clock on supported GPIO + +hardware_PWM Start hardware PWM on supported GPIO + +set_glitch_filter Set a glitch filter on a GPIO +set_noise_filter Set a noise filter on a GPIO + +set_pad_strength Sets a pads drive strength +get_pad_strength Gets a pads drive strength + +shell_ Executes a shell command + +Custom + +custom_1 User custom function 1 +custom_2 User custom function 2 + +Events + +event_callback Sets a callback for an event +event_callback_ex Sets a callback for an event, extended + +event_callback_cancel Cancel an event callback + +event_trigger Triggers an event + +wait_for_event Wait for an event + +Scripts + +store_script Store a script +run_script Run a stored script +update_script Set a scripts parameters +script_status Get script status and parameters +stop_script Stop a running script +delete_script Delete a stored script + +I2C + +i2c_open Opens an I2C device +i2c_close Closes an I2C device + +i2c_write_quick smbus write quick + +i2c_read_byte smbus read byte +i2c_write_byte smbus write byte + +i2c_read_byte_data smbus read byte data +i2c_write_byte_data smbus write byte data + +i2c_read_word_data smbus read word data +i2c_write_word_data smbus write word data + +i2c_read_block_data smbus read block data +i2c_write_block_data smbus write block data + +i2c_read_i2c_block_data smbus read I2C block data +i2c_write_i2c_block_data smbus write I2C block data + +i2c_read_device Reads the raw I2C device +i2c_write_device Writes the raw I2C device + +i2c_process_call smbus process call +i2c_block_process_call smbus block process call + +i2c_zip Performs multiple I2C transactions + +I2C_BIT_BANG + +bb_i2c_open Opens GPIO for bit banging I2C +bb_i2c_close Closes GPIO for bit banging I2C + +bb_i2c_zip Performs bit banged I2C transactions + +I2C/SPI_SLAVE + +bsc_xfer I2C/SPI as slave transfer +bsc_i2c I2C as slave transfer + +SERIAL + +serial_open Opens a serial device +serial_close Closes a serial device + +serial_read_byte Reads a byte from a serial device +serial_write_byte Writes a byte to a serial device + +serial_read Reads bytes from a serial device +serial_write Writes bytes to a serial device + +serial_data_available Returns number of bytes ready to be read + +SERIAL_BIT_BANG_(read_only) + +bb_serial_read_open Opens a GPIO for bit bang serial reads +bb_serial_read_close Closes a GPIO for bit bang serial reads + +bb_serial_invert Invert serial logic (1 invert, 0 normal) + +bb_serial_read Reads bit bang serial data from a GPIO + +SPI + +spi_open Opens a SPI device +spi_close Closes a SPI device + +spi_read Reads bytes from a SPI device +spi_write Writes bytes to a SPI device +spi_xfer Transfers bytes with a SPI device + +SPI_BIT_BANG + +bb_spi_open Opens GPIO for bit banging SPI +bb_spi_close Closes GPIO for bit banging SPI + +bb_spi_xfer Transfers bytes with bit banging SPI + +FILES + +file_open Opens a file +file_close Closes a file + +file_read Reads bytes from a file +file_write Writes bytes to a file + +file_seek Seeks to a position within a file + +file_list List files which match a pattern + +WAVES + +wave_clear Deletes all waveforms + +wave_add_new Starts a new waveform +wave_add_generic Adds a series of pulses to the waveform +wave_add_serial Adds serial data to the waveform + +wave_create Creates a waveform from added data +wave_create_and_pad Creates a waveform of fixed size from added data +wave_delete Deletes one or more waveforms + +wave_send_once Transmits a waveform once +wave_send_repeat Transmits a waveform repeatedly +wave_send_using_mode Transmits a waveform in the chosen mode + +wave_chain Transmits a chain of waveforms + +wave_tx_at Returns the current transmitting waveform + +wave_tx_busy Checks to see if the waveform has ended + +wave_tx_stop Aborts the current waveform + +wave_get_cbs Length in cbs of the current waveform +wave_get_high_cbs Length of longest waveform so far +wave_get_max_cbs Absolute maximum allowed cbs + +wave_get_micros Length in micros of the current waveform +wave_get_high_micros Length of longest waveform so far +wave_get_max_micros Absolute maximum allowed micros + +wave_get_pulses Length in pulses of the current waveform +wave_get_high_pulses Length of longest waveform so far +wave_get_max_pulses Absolute maximum allowed pulses + +UTILITIES + +get_current_tick Get current tick (microseconds) + +get_hardware_revision Get hardware revision +get_pigpio_version Get the pigpio version +pigpiod_if_version Get the pigpiod_if2 version + +pigpio_error Get a text description of an error code. + +time_sleep Sleeps for a float number of seconds +time_time Float number of seconds since the epoch + +OVERVIEW*/ + +#ifdef __cplusplus +extern "C" { +#endif + +typedef void (*CBFunc_t) + (int pi, unsigned user_gpio, unsigned level, uint32_t tick); + +typedef void (*CBFuncEx_t) + (int pi, unsigned user_gpio, unsigned level, uint32_t tick, void *userdata); + +typedef struct callback_s callback_t; + +typedef void (*evtCBFunc_t) + (int pi, unsigned event, uint32_t tick); + +typedef void (*evtCBFuncEx_t) + (int pi, unsigned event, uint32_t tick, void *userdata); + +typedef struct evtCallback_s evtCallback_t; + +/*F*/ +double time_time(void); +/*D +Return the current time in seconds since the Epoch. +D*/ + +/*F*/ +void time_sleep(double seconds); +/*D +Delay execution for a given number of seconds. + +. . +seconds: the number of seconds to delay. +. . +D*/ + +/*F*/ +char *pigpio_error(int errnum); +/*D +Return a text description for an error code. + +. . +errnum: the error code. +. . +D*/ + +/*F*/ +unsigned pigpiod_if_version(void); +/*D +Return the pigpiod_if2 version. +D*/ + +/*F*/ +pthread_t *start_thread(gpioThreadFunc_t thread_func, void *userdata); +/*D +Starts a new thread of execution with thread_func as the main routine. + +. . +thread_func: the main function for the new thread. + userdata: a pointer to an arbitrary argument. +. . + +Returns a pointer to pthread_t if OK, otherwise NULL. + +The function is passed the single argument userdata. + +The thread can be cancelled by passing the pointer to pthread_t to +[*stop_thread*]. +D*/ + +/*F*/ +void stop_thread(pthread_t *pth); +/*D +Cancels the thread pointed at by pth. + +. . +pth: the thread to be stopped. +. . + +No value is returned. + +The thread to be stopped should have been started with [*start_thread*]. +D*/ + +/*F*/ +int pigpio_start(const char *addrStr, const char *portStr); +/*D +Connect to the pigpio daemon. Reserving command and +notification streams. + +. . +addrStr: specifies the host or IP address of the Pi running the + pigpio daemon. It may be NULL in which case localhost + is used unless overridden by the PIGPIO_ADDR environment + variable. + +portStr: specifies the port address used by the Pi running the + pigpio daemon. It may be NULL in which case "8888" + is used unless overridden by the PIGPIO_PORT environment + variable. +. . + +Returns an integer value greater than or equal to zero if OK. + +This value is passed to the GPIO routines to specify the Pi +to be operated on. +D*/ + +/*F*/ +void pigpio_stop(int pi); +/*D +Terminates the connection to a pigpio daemon and releases +resources used by the library. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int set_mode(int pi, unsigned gpio, unsigned mode); +/*D +Set the GPIO mode. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +gpio: 0-53. +mode: PI_INPUT, PI_OUTPUT, PI_ALT0, PI_ALT1, + PI_ALT2, PI_ALT3, PI_ALT4, PI_ALT5. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_MODE, +or PI_NOT_PERMITTED. +D*/ + +/*F*/ +int get_mode(int pi, unsigned gpio); +/*D +Get the GPIO mode. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +gpio: 0-53. +. . + +Returns the GPIO mode if OK, otherwise PI_BAD_GPIO. +D*/ + +/*F*/ +int set_pull_up_down(int pi, unsigned gpio, unsigned pud); +/*D +Set or clear the GPIO pull-up/down resistor. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +gpio: 0-53. + pud: PI_PUD_UP, PI_PUD_DOWN, PI_PUD_OFF. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_PUD, +or PI_NOT_PERMITTED. +D*/ + +/*F*/ +int gpio_read(int pi, unsigned gpio); +/*D +Read the GPIO level. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +gpio:0-53. +. . + +Returns the GPIO level if OK, otherwise PI_BAD_GPIO. +D*/ + +/*F*/ +int gpio_write(int pi, unsigned gpio, unsigned level); +/*D +Write the GPIO level. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + gpio: 0-53. +level: 0, 1. +. . + +Returns 0 if OK, otherwise PI_BAD_GPIO, PI_BAD_LEVEL, +or PI_NOT_PERMITTED. + +Notes + +If PWM or servo pulses are active on the GPIO they are switched off. +D*/ + +/*F*/ +int set_PWM_dutycycle(int pi, unsigned user_gpio, unsigned dutycycle); +/*D +Start (non-zero dutycycle) or stop (0) PWM pulses on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +dutycycle: 0-range (range defaults to 255). +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYCYCLE, +or PI_NOT_PERMITTED. +Notes + +The [*set_PWM_range*] function may be used to change the +default range of 255. +D*/ + +/*F*/ +int get_PWM_dutycycle(int pi, unsigned user_gpio); +/*D +Return the PWM dutycycle in use on a GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +. . + +Returns current PWM dutycycle if OK, +otherwise PI_BAD_USER_GPIO or PI_NOT_PWM_GPIO. + +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see [*get_PWM_range*]). + +If a hardware clock is active on the GPIO the reported dutycycle +will be 500000 (500k) out of 1000000 (1M). + +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). +D*/ + +/*F*/ +int set_PWM_range(int pi, unsigned user_gpio, unsigned range); +/*D +Set the range of PWM values to be used on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + range: 25-40000. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_DUTYRANGE, +or PI_NOT_PERMITTED. + +Notes + +If PWM is currently active on the GPIO its dutycycle will be +scaled to reflect the new range. + +The real range, the number of steps between fully off and fully on +for each of the 18 available GPIO frequencies is + +. . + 25(#1), 50(#2), 100(#3), 125(#4), 200(#5), 250(#6), + 400(#7), 500(#8), 625(#9), 800(#10), 1000(#11), 1250(#12), +2000(#13), 2500(#14), 4000(#15), 5000(#16), 10000(#17), 20000(#18) +. . + +The real value set by set_PWM_range is (dutycycle * real range) / range. +D*/ + +/*F*/ +int get_PWM_range(int pi, unsigned user_gpio); +/*D +Get the range of PWM values being used on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +. . + +Returns the dutycycle range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +If a hardware clock or hardware PWM is active on the GPIO the +reported range will be 1000000 (1M). +D*/ + +/*F*/ +int get_PWM_real_range(int pi, unsigned user_gpio); +/*D +Get the real underlying range of PWM values being used on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +. . + +Returns the real range used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. + +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +D*/ + +/*F*/ +int set_PWM_frequency(int pi, unsigned user_gpio, unsigned frequency); +/*D +Set the frequency (in Hz) of the PWM to be used on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +frequency: >=0 (Hz). +. . + +Returns the numerically closest frequency if OK, otherwise +PI_BAD_USER_GPIO or PI_NOT_PERMITTED. + +If PWM is currently active on the GPIO it will be switched +off and then back on at the new frequency. + +Each GPIO can be independently set to one of 18 different +PWM frequencies. + +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +The frequencies for each sample rate are: + +. . + Hertz + + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 + 1250 1000 800 500 400 250 200 100 50 + + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 + 625 500 400 250 200 125 100 50 25 + + 4: 10000 5000 2500 2000 1250 1000 625 500 400 + 313 250 200 125 100 63 50 25 13 +sample + rate + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 + 250 200 160 100 80 50 40 20 10 + + 8: 5000 2500 1250 1000 625 500 313 250 200 + 156 125 100 63 50 31 25 13 6 + + 10: 4000 2000 1000 800 500 400 250 200 160 + 125 100 80 50 40 25 20 10 5 +. . +D*/ + +/*F*/ +int get_PWM_frequency(int pi, unsigned user_gpio); +/*D +Get the frequency of PWM being used on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +. . + +For normal PWM the frequency will be that defined for the GPIO by +[*set_PWM_frequency*]. + +If a hardware clock is active on the GPIO the reported frequency +will be that set by [*hardware_clock*]. + +If hardware PWM is active on the GPIO the reported frequency +will be that set by [*hardware_PWM*]. + +Returns the frequency (in hertz) used for the GPIO if OK, +otherwise PI_BAD_USER_GPIO. +D*/ + +/*F*/ +int set_servo_pulsewidth(int pi, unsigned user_gpio, unsigned pulsewidth); +/*D +Start (500-2500) or stop (0) servo pulses on the GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + user_gpio: 0-31. +pulsewidth: 0 (off), 500 (anti-clockwise) - 2500 (clockwise). +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_PULSEWIDTH or +PI_NOT_PERMITTED. + +The selected pulsewidth will continue to be transmitted until +changed by a subsequent call to set_servo_pulsewidth. + +The pulsewidths supported by servos varies and should probably be +determined by experiment. A value of 1500 should always be safe and +represents the mid-point of rotation. + +You can DAMAGE a servo if you command it to move beyond its limits. + +OTHER UPDATE RATES: + +This function updates servos at 50Hz. If you wish to use a different +update frequency you will have to use the PWM functions. + +. . +Update Rate (Hz) 50 100 200 400 500 +1E6/Hz 20000 10000 5000 2500 2000 +. . + +Firstly set the desired PWM frequency using [*set_PWM_frequency*]. + +Then set the PWM range using [*set_PWM_range*] to 1E6/Hz. +Doing this allows you to use units of microseconds when setting +the servo pulsewidth. + +E.g. If you want to update a servo connected to GPIO 25 at 400Hz + +. . +set_PWM_frequency(25, 400); +set_PWM_range(25, 2500); +. . + +Thereafter use the [*set_PWM_dutycycle*] function to move the servo, +e.g. set_PWM_dutycycle(25, 1500) will set a 1500 us pulse. +D*/ + +/*F*/ +int get_servo_pulsewidth(int pi, unsigned user_gpio); +/*D +Return the servo pulsewidth in use on a GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO or PI_NOT_SERVO_GPIO. +D*/ + +/*F*/ +int notify_open(int pi); +/*D +Get a free notification handle. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Returns a handle greater than or equal to zero if OK, +otherwise PI_NO_HANDLE. + +A notification is a method for being notified of GPIO state +changes via a pipe. + +Pipes are only accessible from the local machine so this function +serves no purpose if you are using the library from a remote machine. +The in-built (socket) notifications provided by [*callback*] +should be used instead. + +Notifications for handle x will be available at the pipe +named /dev/pigpiox (where x is the handle number). +E.g. if the function returns 15 then the notifications must be +read from /dev/pigpio15. +D*/ + +/*F*/ +int notify_begin(int pi, unsigned handle, uint32_t bits); +/*D +Start notifications on a previously opened handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: 0-31 (as returned by [*notify_open*]) + bits: a mask indicating the GPIO to be notified. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +The notification sends state changes for each GPIO whose +corresponding bit in bits is set. + +Each notification occupies 12 bytes in the fifo as follows: + +. . +typedef struct +{ + uint16_t seqno; + uint16_t flags; + uint32_t tick; + uint32_t level; +} gpioReport_t; +. . + +seqno: starts at 0 each time the handle is opened and then increments +by one for each report. + +flags: three flags are defined, PI_NTFY_FLAGS_WDOG, +PI_NTFY_FLAGS_ALIVE, and PI_NTFY_FLAGS_EVENT. + +If bit 5 is set (PI_NTFY_FLAGS_WDOG) then bits 0-4 of the flags +indicate a GPIO which has had a watchdog timeout. + +If bit 6 is set (PI_NTFY_FLAGS_ALIVE) this indicates a keep alive +signal on the pipe/socket and is sent once a minute in the absence +of other notification activity. + +If bit 7 is set (PI_NTFY_FLAGS_EVENT) then bits 0-4 of the flags +indicate an event which has been triggered. + +tick: the number of microseconds since system boot. It wraps around +after 1h12m. + +level: indicates the level of each GPIO. If bit 1<=0 (as returned by [*pigpio_start*]). +handle: 0-31 (as returned by [*notify_open*]) +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +Notifications for the handle are suspended until +[*notify_begin*] is called again. +D*/ + +/*F*/ +int notify_close(int pi, unsigned handle); +/*D +Stop notifications on a previously opened handle and +release the handle for reuse. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: 0-31 (as returned by [*notify_open*]) +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int set_watchdog(int pi, unsigned user_gpio, unsigned timeout); +/*D +Sets a watchdog for a GPIO. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + timeout: 0-60000. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO +or PI_BAD_WDOG_TIMEOUT. + +The watchdog is nominally in milliseconds. + +Only one watchdog may be registered per GPIO. + +The watchdog may be cancelled by setting timeout to 0. + +Once a watchdog has been started callbacks for the GPIO will be +triggered every timeout interval after the last GPIO activity. + +The callback will receive the special level PI_TIMEOUT. +D*/ + +/*F*/ +int set_glitch_filter(int pi, unsigned user_gpio, unsigned steady); +/*D +Sets a glitch filter on a GPIO. + +Level changes on the GPIO are not reported unless the level +has been stable for at least [*steady*] microseconds. The +level is then reported. Level changes of less than +[*steady*] microseconds are ignored. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31 + steady: 0-300000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +This filter affects the GPIO samples returned to callbacks set up +with [*callback*], [*callback_ex*] and [*wait_for_edge*]. + +It does not affect levels read by [*gpio_read*], +[*read_bank_1*], or [*read_bank_2*]. + +Each (stable) edge will be timestamped [*steady*] microseconds +after it was first detected. +D*/ + +/*F*/ +int set_noise_filter( + int pi, unsigned user_gpio, unsigned steady, unsigned active); +/*D +Sets a noise filter on a GPIO. + +Level changes on the GPIO are ignored until a level which has +been stable for [*steady*] microseconds is detected. Level changes +on the GPIO are then reported for [*active*] microseconds after +which the process repeats. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31 + steady: 0-300000 + active: 0-1000000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_BAD_FILTER. + +This filter affects the GPIO samples returned to callbacks set up +with [*callback*], [*callback_ex*] and [*wait_for_edge*]. + +It does not affect levels read by [*gpio_read*], +[*read_bank_1*], or [*read_bank_2*]. + +Level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. +D*/ + +/*F*/ +uint32_t read_bank_1(int pi); +/*D +Read the levels of the bank 1 GPIO (GPIO 0-31). + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +The returned 32 bit integer has a bit set if the corresponding +GPIO is logic 1. GPIO n has bit value (1<=0 (as returned by [*pigpio_start*]). +. . + +The returned 32 bit integer has a bit set if the corresponding +GPIO is logic 1. GPIO n has bit value (1<<(n-32)). +D*/ + +/*F*/ +int clear_bank_1(int pi, uint32_t bits); +/*D +Clears GPIO 0-31 if the corresponding bit in bits is set. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +bits: a bit mask with 1 set if the corresponding GPIO is + to be cleared. +. . + +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. +D*/ + +/*F*/ +int clear_bank_2(int pi, uint32_t bits); +/*D +Clears GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +bits: a bit mask with 1 set if the corresponding GPIO is + to be cleared. +. . + +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. +D*/ + +/*F*/ +int set_bank_1(int pi, uint32_t bits); +/*D +Sets GPIO 0-31 if the corresponding bit in bits is set. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +bits: a bit mask with 1 set if the corresponding GPIO is + to be set. +. . + +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. +D*/ + +/*F*/ +int set_bank_2(int pi, uint32_t bits); +/*D +Sets GPIO 32-53 if the corresponding bit (0-21) in bits is set. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +bits: a bit mask with 1 set if the corresponding GPIO is + to be set. +. . + +Returns 0 if OK, otherwise PI_SOME_PERMITTED. + +A status of PI_SOME_PERMITTED indicates that the user is not +allowed to write to one or more of the GPIO. +D*/ + + +/*F*/ +int hardware_clock(int pi, unsigned gpio, unsigned clkfreq); +/*D +Starts a hardware clock on a GPIO at the specified frequency. +Frequencies above 30MHz are unlikely to work. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + gpio: see description +frequency: 0 (off) or 4689-250M (13184-375M for the BCM2711) +. . + +Returns 0 if OK, otherwise PI_NOT_PERMITTED, PI_BAD_GPIO, +PI_NOT_HCLK_GPIO, PI_BAD_HCLK_FREQ,or PI_BAD_HCLK_PASS. + +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +The GPIO must be one of the following. + +. . +4 clock 0 All models +5 clock 1 All models but A and B (reserved for system use) +6 clock 2 All models but A and B +20 clock 0 All models but A and B +21 clock 1 All models but A and Rev.2 B (reserved for system use) + +32 clock 0 Compute module only +34 clock 0 Compute module only +42 clock 1 Compute module only (reserved for system use) +43 clock 2 Compute module only +44 clock 1 Compute module only (reserved for system use) +. . + +Access to clock 1 is protected by a password as its use will likely +crash the Pi. The password is given by or'ing 0x5A000000 with the +GPIO number. +D*/ + + +/*F*/ +int hardware_PWM(int pi, unsigned gpio, unsigned PWMfreq, uint32_t PWMduty); +/*D +Starts hardware PWM on a GPIO at the specified frequency and dutycycle. +Frequencies above 30MHz are unlikely to work. + +NOTE: Any waveform started by [*wave_send_**] or [*wave_chain*] +will be cancelled. + +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden when the pigpio +daemon is started (option -t). + +. . + pi: >=0 (as returned by [*pigpio_start*]). + gpio: see descripton +PWMfreq: 0 (off) or 1-125M (1-187.5M for the BCM2711) +PWMduty: 0 (off) to 1000000 (1M)(fully on) +. . + +Returns 0 if OK, otherwise PI_NOT_PERMITTED, PI_BAD_GPIO, +PI_NOT_HPWM_GPIO, PI_BAD_HPWM_DUTY, PI_BAD_HPWM_FREQ, +or PI_HPWM_ILLEGAL. + +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +The GPIO must be one of the following. + +. . +12 PWM channel 0 All models but A and B +13 PWM channel 1 All models but A and B +18 PWM channel 0 All models +19 PWM channel 1 All models but A and B + +40 PWM channel 0 Compute module only +41 PWM channel 1 Compute module only +45 PWM channel 1 Compute module only +52 PWM channel 0 Compute module only +53 PWM channel 1 Compute module only +. . + +The actual number of steps beween off and fully on is the +integral part of 250M/PWMfreq (375M/PWMfreq for the BCM2711). + +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +There will only be a million steps for a PWMfreq of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. PWMduty is +automatically scaled to take this into account. +D*/ + + +/*F*/ +uint32_t get_current_tick(int pi); +/*D +Gets the current system tick. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Tick is the number of microseconds since system boot. + +As tick is an unsigned 32 bit quantity it wraps around after +2**32 microseconds, which is approximately 1 hour 12 minutes. + +D*/ + +/*F*/ +uint32_t get_hardware_revision(int pi); +/*D +Get the Pi's hardware revision number. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +The hardware revision is the last few characters on the Revision line +of /proc/cpuinfo. + +If the hardware revision can not be found or is not a valid +hexadecimal number the function returns 0. + +The revision number can be used to determine the assignment of GPIO +to pins (see [*gpio*]). + +There are at least three types of board. + +Type 1 boards have hardware revision numbers of 2 and 3. + +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +Type 3 boards have hardware revision numbers of 16 or greater. +D*/ + +/*F*/ +uint32_t get_pigpio_version(int pi); +/*D +Returns the pigpio version. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + + +/*F*/ +int wave_clear(int pi); +/*D +This function clears all waveforms and any data added by calls to the +[*wave_add_**] functions. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Returns 0 if OK. +D*/ + +/*F*/ +int wave_add_new(int pi); +/*D +This function starts a new empty waveform. You wouldn't normally need +to call this function as it is automatically called after a waveform is +created with the [*wave_create*] function. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Returns 0 if OK. +D*/ + +/*F*/ +int wave_add_generic(int pi, unsigned numPulses, gpioPulse_t *pulses); +/*D +This function adds a number of pulses to the current waveform. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +numPulses: the number of pulses. + pulses: an array of pulses. +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_TOO_MANY_PULSES. + +The pulses are interleaved in time order within the existing waveform +(if any). + +Merging allows the waveform to be built in parts, that is the settings +for GPIO#1 can be added, and then GPIO#2 etc. + +If the added waveform is intended to start after or within the existing +waveform then the first pulse should consist solely of a delay. +D*/ + +/*F*/ +int wave_add_serial + (int pi, unsigned user_gpio, unsigned baud, unsigned data_bits, + unsigned stop_bits, unsigned offset, unsigned numBytes, char *str); +/*D +This function adds a waveform representing serial data to the +existing waveform (if any). The serial data starts offset +microseconds from the start of the waveform. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + baud: 50-1000000 +data_bits: number of data bits (1-32) +stop_bits: number of stop half bits (2-8) + offset: >=0 + numBytes: >=1 + str: an array of chars. +. . + +Returns the new total number of pulses in the current waveform if OK, +otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, PI_BAD_DATABITS, +PI_BAD_STOP_BITS, PI_TOO_MANY_CHARS, PI_BAD_SER_OFFSET, +or PI_TOO_MANY_PULSES. + +NOTES: + +The serial data is formatted as one start bit, [*data_bits*] data bits, +and [*stop_bits*]/2 stop bits. + +It is legal to add serial data streams with different baud rates to +the same waveform. + +[*numBytes*] is the number of bytes of data in str. + +The bytes required for each character depend upon [*data_bits*]. + +For [*data_bits*] 1-8 there will be one byte per character. +For [*data_bits*] 9-16 there will be two bytes per character. +For [*data_bits*] 17-32 there will be four bytes per character. +D*/ + +/*F*/ +int wave_create(int pi); +/*D +This function creates a waveform from the data provided by the prior +calls to the [*wave_add_**] functions. Upon success a wave id +greater than or equal to 0 is returned, otherwise PI_EMPTY_WAVEFORM, +PI_TOO_MANY_CBS, PI_TOO_MANY_OOL, or PI_NO_WAVEFORM_ID. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +The data provided by the [*wave_add_**] functions is consumed by this +function. + +As many waveforms may be created as there is space available. The +wave id is passed to [*wave_send_**] to specify the waveform to transmit. + +Normal usage would be + +Step 1. [*wave_clear*] to clear all waveforms and added data. + +Step 2. [*wave_add_**] calls to supply the waveform data. + +Step 3. [*wave_create*] to create the waveform and get a unique id + +Repeat steps 2 and 3 as needed. + +Step 4. [*wave_send_**] with the id of the waveform to transmit. + +A waveform comprises one or more pulses. Each pulse consists of a +[*gpioPulse_t*] structure. + +. . +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; +} gpioPulse_t; +. . + +The fields specify + +1) the GPIO to be switched on at the start of the pulse. +2) the GPIO to be switched off at the start of the pulse. +3) the delay in microseconds before the next pulse. + +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +When a waveform is started each pulse is executed in order with the +specified delay between the pulse and the next. + +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. +D*/ + + +/*F*/ +int wave_create_and_pad(int pi, int percent); +/*D +This function creates a waveform like [*wave_create*] but pads the consumed +resources. Where percent gives the percentage of the resources to use (in terms +of the theoretical maximum, not the current amount free). This allows the reuse +of deleted waves while a transmission is active. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +percent: 0-100, size of waveform as percentage of maximum available. +. . + +The data provided by the [*wave_add_**] functions are consumed by this +function. + +As many waveforms may be created as there is space available. The +wave id is passed to [*wave_send_**] to specify the waveform to transmit. + +A usage would be the creation of two waves where one is filled while the other +is being transmitted. Each wave is assigned 50% of the resources. +This buffer structure allows the transmission of infinite wave sequences. + +Normal usage: + +Step 1. [*wave_clear*] to clear all waveforms and added data. + +Step 2. [*wave_add_**] calls to supply the waveform data. + +Step 3. [*wave_create_and_pad*] to create a waveform of uniform size. + +Step 4. [*wave_send_**] with the id of the waveform to transmit. + +Repeat steps 2-4 as needed. + +Step 5. Any wave id can now be deleted and another wave of the same size + can be created in its place. + +Returns the new waveform id if OK, otherwise PI_EMPTY_WAVEFORM, +PI_NO_WAVEFORM_ID, PI_TOO_MANY_CBS, or PI_TOO_MANY_OOL. +D*/ + + +/*F*/ +int wave_delete(int pi, unsigned wave_id); +/*D +This function deletes the waveform with id wave_id. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +wave_id: >=0, as returned by [*wave_create*]. +. . + +Wave ids are allocated in order, 0, 1, 2, etc. + +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +Returns 0 if OK, otherwise PI_BAD_WAVE_ID. +D*/ + + +/*F*/ +int wave_send_once(int pi, unsigned wave_id); +/*D +This function transmits the waveform with id wave_id. The waveform +is sent once. + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +wave_id: >=0, as returned by [*wave_create*]. +. . + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + + +/*F*/ +int wave_send_repeat(int pi, unsigned wave_id); +/*D +This function transmits the waveform with id wave_id. The waveform +cycles until cancelled (either by the sending of a new waveform or +by [*wave_tx_stop*]). + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +wave_id: >=0, as returned by [*wave_create*]. +. . + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + + +/*F*/ +int wave_send_using_mode(int pi, unsigned wave_id, unsigned mode); +/*D +Transmits the waveform with id wave_id using mode mode. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +wave_id: >=0, as returned by [*wave_create*]. + mode: PI_WAVE_MODE_ONE_SHOT, PI_WAVE_MODE_REPEAT, + PI_WAVE_MODE_ONE_SHOT_SYNC, or PI_WAVE_MODE_REPEAT_SYNC. +. . + +PI_WAVE_MODE_ONE_SHOT: same as [*wave_send_once*]. + +PI_WAVE_MODE_REPEAT same as [*wave_send_repeat*]. + +PI_WAVE_MODE_ONE_SHOT_SYNC same as [*wave_send_once*] but tries +to sync with the previous waveform. + +PI_WAVE_MODE_REPEAT_SYNC same as [*wave_send_repeat*] but tries +to sync with the previous waveform. + +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +Returns the number of DMA control blocks in the waveform if OK, +otherwise PI_BAD_WAVE_ID, or PI_BAD_WAVE_MODE. +D*/ + +/*F*/ +int wave_chain(int pi, char *buf, unsigned bufSize); +/*D +This function transmits a chain of waveforms. + +NOTE: Any hardware PWM started by [*hardware_PWM*] will be cancelled. + +The waves to be transmitted are specified by the contents of buf +which contains an ordered list of [*wave_id*]s and optional command +codes and related data. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + buf: pointer to the wave_ids and optional command codes +bufSize: the number of bytes in buf +. . + +Returns 0 if OK, otherwise PI_CHAIN_NESTING, PI_CHAIN_LOOP_CNT, PI_BAD_CHAIN_LOOP, PI_BAD_CHAIN_CMD, PI_CHAIN_COUNTER, +PI_BAD_CHAIN_DELAY, PI_CHAIN_TOO_BIG, or PI_BAD_WAVE_ID. + +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +Delays between waves may be added with the delay command. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +Loop Start @ 255 0 @ Identify start of a wave block +Loop Repeat @ 255 1 x y @ loop x + y*256 times +Delay @ 255 2 x y @ delay x + y*256 microseconds +Loop Forever @ 255 3 @ loop forever + +If present Loop Forever must be the last entry in the chain. + +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +... +#include +#include + +#define WAVES 5 +#define GPIO 4 + +int main(int argc, char *argv[]) +{ + int i, pi, wid[WAVES]; + + pi = pigpio_start(0, 0); + if (pi<0) return -1; + + set_mode(pi, GPIO, PI_OUTPUT); + + for (i=0; i=0 (as returned by [*pigpio_start*]). +. . + +Returns the waveform id or one of the following special values: + +PI_WAVE_NOT_FOUND (9998) - transmitted wave not found. +PI_NO_TX_WAVE (9999) - no wave being transmitted. +D*/ + +/*F*/ +int wave_tx_busy(int pi); +/*D +This function checks to see if a waveform is currently being +transmitted. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Returns 1 if a waveform is currently being transmitted, otherwise 0. +D*/ + +/*F*/ +int wave_tx_stop(int pi); +/*D +This function stops the transmission of the current waveform. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . + +Returns 0 if OK. + +This function is intended to stop a waveform started with the repeat mode. +D*/ + +/*F*/ +int wave_get_micros(int pi); +/*D +This function returns the length in microseconds of the current +waveform. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_high_micros(int pi); +/*D +This function returns the length in microseconds of the longest waveform +created since the pigpio daemon was started. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_max_micros(int pi); +/*D +This function returns the maximum possible size of a waveform in +microseconds. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_pulses(int pi); +/*D +This function returns the length in pulses of the current waveform. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_high_pulses(int pi); +/*D +This function returns the length in pulses of the longest waveform +created since the pigpio daemon was started. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_max_pulses(int pi); +/*D +This function returns the maximum possible size of a waveform in pulses. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_cbs(int pi); +/*D +This function returns the length in DMA control blocks of the current +waveform. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_high_cbs(int pi); +/*D +This function returns the length in DMA control blocks of the longest +waveform created since the pigpio daemon was started. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int wave_get_max_cbs(int pi); +/*D +This function returns the maximum possible size of a waveform in DMA +control blocks. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +. . +D*/ + +/*F*/ +int gpio_trigger(int pi, unsigned user_gpio, unsigned pulseLen, unsigned level); +/*D +This function sends a trigger pulse to a GPIO. The GPIO is set to +level for pulseLen microseconds and then reset to not level. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + pulseLen: 1-100. + level: 0,1. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_LEVEL, +PI_BAD_PULSELEN, or PI_NOT_PERMITTED. +D*/ + +/*F*/ +int store_script(int pi, char *script); +/*D +This function stores a script for later execution. + +See [[http://abyz.me.uk/rpi/pigpio/pigs.html#Scripts]] for details. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script: the text of the script. +. . + +The function returns a script id if the script is valid, +otherwise PI_BAD_SCRIPT. +D*/ + +/*F*/ +int run_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param); +/*D +This function runs a stored script. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script_id: >=0, as returned by [*store_script*]. + numPar: 0-10, the number of parameters. + param: an array of parameters. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM + +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. +D*/ + +/*F*/ +int update_script(int pi, unsigned script_id, unsigned numPar, uint32_t *param); +/*D +This function sets the parameters of a script. The script may or +may not be running. The first numPar parameters of the script are +overwritten with the new values. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script_id: >=0, as returned by [*store_script*]. + numPar: 0-10, the number of parameters. + param: an array of parameters. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID, or +PI_TOO_MANY_PARAM. + +param is an array of up to 10 parameters which may be referenced in +the script as p0 to p9. +D*/ + +/*F*/ +int script_status(int pi, unsigned script_id, uint32_t *param); +/*D +This function returns the run status of a stored script as well +as the current values of parameters 0 to 9. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script_id: >=0, as returned by [*store_script*]. + param: an array to hold the returned 10 parameters. +. . + +The function returns greater than or equal to 0 if OK, +otherwise PI_BAD_SCRIPT_ID. + +The run status may be + +. . +PI_SCRIPT_INITING +PI_SCRIPT_HALTED +PI_SCRIPT_RUNNING +PI_SCRIPT_WAITING +PI_SCRIPT_FAILED +. . + +The current value of script parameters 0 to 9 are returned in param. +D*/ + +/*F*/ +int stop_script(int pi, unsigned script_id); +/*D +This function stops a running script. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script_id: >=0, as returned by [*store_script*]. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + +/*F*/ +int delete_script(int pi, unsigned script_id); +/*D +This function deletes a stored script. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +script_id: >=0, as returned by [*store_script*]. +. . + +The function returns 0 if OK, otherwise PI_BAD_SCRIPT_ID. +D*/ + +/*F*/ +int bb_serial_read_open(int pi, unsigned user_gpio, unsigned baud, unsigned data_bits); +/*D +This function opens a GPIO for bit bang reading of serial data. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + baud: 50-250000 +data_bits: 1-32 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_WAVE_BAUD, +or PI_GPIO_IN_USE. + +The serial data is returned in a cyclic buffer and is read using +bb_serial_read. + +It is the caller's responsibility to read data from the cyclic buffer +in a timely fashion. +D*/ + +/*F*/ +int bb_serial_read(int pi, unsigned user_gpio, void *buf, size_t bufSize); +/*D +This function copies up to bufSize bytes of data read from the +bit bang serial cyclic buffer to the buffer starting at buf. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. + buf: an array to receive the read bytes. + bufSize: >=0 +. . + +Returns the number of bytes copied if OK, otherwise PI_BAD_USER_GPIO +or PI_NOT_SERIAL_GPIO. + +The bytes returned for each character depend upon the number of +data bits [*data_bits*] specified in the [*bb_serial_read_open*] command. + +For [*data_bits*] 1-8 there will be one byte per character. +For [*data_bits*] 9-16 there will be two bytes per character. +For [*data_bits*] 17-32 there will be four bytes per character. +D*/ + +/*F*/ +int bb_serial_read_close(int pi, unsigned user_gpio); +/*D +This function closes a GPIO for bit bang reading of serial data. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SERIAL_GPIO. +D*/ + +/*F*/ +int bb_serial_invert(int pi, unsigned user_gpio, unsigned invert); +/*D +This function inverts serial logic for big bang serial reads. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31, previously opened with [*bb_serial_read_open*]. + invert: 0-1, 1 invert, 0 normal. +. . + +Returns 0 if OK, otherwise PI_NOT_SERIAL_GPIO or PI_BAD_SER_INVERT. +D*/ + +/*F*/ +int i2c_open(int pi, unsigned i2c_bus, unsigned i2c_addr, unsigned i2c_flags); +/*D +This returns a handle for the device at address i2c_addr on bus i2c_bus. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + i2c_bus: >=0. + i2c_addr: 0-0x7F. +i2c_flags: 0. +. . + +No flags are currently defined. This parameter should be set to zero. + +Physically buses 0 and 1 are available on the Pi. Higher numbered buses +will be available if a kernel supported bus multiplexor is being used. + +The GPIO used are given in the following table. + + @ SDA @ SCL +I2C 0 @ 0 @ 1 +I2C 1 @ 2 @ 3 + +Returns a handle (>=0) if OK, otherwise PI_BAD_I2C_BUS, PI_BAD_I2C_ADDR, +PI_BAD_FLAGS, PI_NO_HANDLE, or PI_I2C_OPEN_FAILED. + +For the SMBus commands the low level transactions are shown at the end +of the function description. The following abbreviations are used. + +. . +S (1 bit) : Start bit +P (1 bit) : Stop bit +Rd/Wr (1 bit) : Read/Write bit. Rd equals 1, Wr equals 0. +A, NA (1 bit) : Accept and not accept bit. +Addr (7 bits): I2C 7 bit address. +i2c_reg (8 bits): A byte which often selects a register. +Data (8 bits): A data byte. +Count (8 bits): A byte defining the length of a block operation. + +[..]: Data sent by the device. +. . +D*/ + +/*F*/ +int i2c_close(int pi, unsigned handle); +/*D +This closes the I2C device associated with the handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int i2c_write_quick(int pi, unsigned handle, unsigned bit); +/*D +This sends a single bit (in the Rd/Wr bit) to the device associated +with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. + bit: 0-1, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Quick command. SMBus 2.0 5.5.1 +. . +S Addr bit [A] P +. . +D*/ + +/*F*/ +int i2c_write_byte(int pi, unsigned handle, unsigned bVal); +/*D +This sends a single byte to the device associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. + bVal: 0-0xFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Send byte. SMBus 2.0 5.5.2 +. . +S Addr Wr [A] bVal [A] P +. . +D*/ + +/*F*/ +int i2c_read_byte(int pi, unsigned handle); +/*D +This reads a single byte from the device associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +or PI_I2C_READ_FAILED. + +Receive byte. SMBus 2.0 5.5.3 +. . +S Addr Rd [A] [Data] NA P +. . +D*/ + +/*F*/ +int i2c_write_byte_data( + int pi, unsigned handle, unsigned i2c_reg, unsigned bVal); +/*D +This writes a single byte to the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + bVal: 0-0xFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write byte. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] i2c_reg [A] bVal [A] P +. . +D*/ + +/*F*/ +int i2c_write_word_data( + int pi, unsigned handle, unsigned i2c_reg, unsigned wVal); +/*D +This writes a single 16 bit word to the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + wVal: 0-0xFFFF, the value to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Write word. SMBus 2.0 5.5.4 +. . +S Addr Wr [A] i2c_reg [A] wval_Low [A] wVal_High [A] P +. . +D*/ + +/*F*/ +int i2c_read_byte_data(int pi, unsigned handle, unsigned i2c_reg); +/*D +This reads a single byte from the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. +. . + +Returns the byte read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read byte. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] i2c_reg [A] S Addr Rd [A] [Data] NA P +. . +D*/ + +/*F*/ +int i2c_read_word_data(int pi, unsigned handle, unsigned i2c_reg); +/*D +This reads a single 16 bit word from the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Read word. SMBus 2.0 5.5.5 +. . +S Addr Wr [A] i2c_reg [A] + S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + +/*F*/ +int i2c_process_call(int pi, unsigned handle, unsigned i2c_reg, unsigned wVal); +/*D +This writes 16 bits of data to the specified register of the device +associated with handle and and reads 16 bits of data in return. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write/read. + wVal: 0-0xFFFF, the value to write. +. . + +Returns the word read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Process call. SMBus 2.0 5.5.6 +. . +S Addr Wr [A] i2c_reg [A] wVal_Low [A] wVal_High [A] + S Addr Rd [A] [DataLow] A [DataHigh] NA P +. . +D*/ + +/*F*/ +int i2c_write_block_data( + int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes up to 32 bytes to the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + buf: an array with the data to send. + count: 1-32, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +Block write. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] i2c_reg [A] count [A] buf0 [A] buf1 [A] ... + [A] bufn [A] P +. . +D*/ + +/*F*/ +int i2c_read_block_data(int pi, unsigned handle, unsigned i2c_reg, char *buf); +/*D +This reads a block of up to 32 bytes from the specified register of +the device associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. + buf: an array to receive the read data. +. . + +The amount of returned data is set by the device. + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +Block read. SMBus 2.0 5.5.7 +. . +S Addr Wr [A] i2c_reg [A] + S Addr Rd [A] [Count] A [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + +/*F*/ +int i2c_block_process_call( + int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes data bytes to the specified register of the device +associated with handle and reads a device specified number +of bytes of data in return. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write/read. + buf: an array with the data to send and to receive the read data. + count: 1-32, the number of bytes to write. +. . + + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +The smbus 2.0 documentation states that a minimum of 1 byte may be +sent and a minimum of 1 byte may be received. The total number of +bytes sent/received must be 32 or less. + +Block write-block read. SMBus 2.0 5.5.8 +. . +S Addr Wr [A] i2c_reg [A] count [A] buf0 [A] ... + S Addr Rd [A] [Count] A [Data] ... A P +. . +D*/ + +/*F*/ +int i2c_read_i2c_block_data( + int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This reads count bytes from the specified register of the device +associated with handle . The count may be 1-32. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to read. + buf: an array to receive the read data. + count: 1-32, the number of bytes to read. +. . + +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, or PI_I2C_READ_FAILED. + +. . +S Addr Wr [A] i2c_reg [A] + S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + + +/*F*/ +int i2c_write_i2c_block_data( + int pi, unsigned handle, unsigned i2c_reg, char *buf, unsigned count); +/*D +This writes 1 to 32 bytes to the specified register of the device +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0, as returned by a call to [*i2c_open*]. +i2c_reg: 0-255, the register to write. + buf: the data to write. + count: 1-32, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +. . +S Addr Wr [A] i2c_reg [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +. . +D*/ + +/*F*/ +int i2c_read_device(int pi, unsigned handle, char *buf, unsigned count); +/*D +This reads count bytes from the raw device into buf. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. + buf: an array to receive the read data bytes. + count: >0, the number of bytes to read. +. . + +Returns count (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_READ_FAILED. + +. . +S Addr Rd [A] [buf0] A [buf1] A ... A [bufn] NA P +. . +D*/ + +/*F*/ +int i2c_write_device(int pi, unsigned handle, char *buf, unsigned count); +/*D +This writes count bytes from buf to the raw device. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2c_open*]. + buf: an array containing the data bytes to write. + count: >0, the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_I2C_WRITE_FAILED. + +. . +S Addr Wr [A] buf0 [A] buf1 [A] ... [A] bufn [A] P +. . +D*/ + +/*F*/ +int i2c_zip( + int pi, + unsigned handle, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*i2cOpen*] + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_HANDLE, PI_BAD_POINTER, PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN. +PI_BAD_I2C_WLEN, or PI_BAD_I2C_SEG. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +On @ 2 @ Switch combined flag on +Off @ 3 @ Switch combined flag off +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address defaults to that associated with the handle. +The flags default to 0. The address and flags maintain their +previous value until updated. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53, write 0x32, read 6 bytes +Set address 0x1E, write 0x03, read 6 bytes +Set address 0x68, write 0x1B, read 8 bytes +End + +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +0x00 +... + +D*/ + +/*F*/ +int bb_i2c_open(int pi, unsigned SDA, unsigned SCL, unsigned baud); +/*D +This function selects a pair of GPIO for bit banging I2C at a +specified baud rate. + +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +o baud rates as low as 50 +o repeated starts +o clock stretching +o I2C on any pair of spare GPIO + +. . + pi: >=0 (as returned by [*pigpio_start*]). + SDA: 0-31 + SCL: 0-31 +baud: 50-500000 +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_I2C_BAUD, or +PI_GPIO_IN_USE. + +NOTE: + +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. +D*/ + +/*F*/ +int bb_i2c_close(int pi, unsigned SDA); +/*D +This function stops bit banging I2C on a pair of GPIO previously +opened with [*bb_i2c_open*]. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +SDA: 0-31, the SDA GPIO used in a prior call to [*bb_i2c_open*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_I2C_GPIO. +D*/ + +/*F*/ +int bb_i2c_zip( + int pi, + unsigned SDA, + char *inBuf, + unsigned inLen, + char *outBuf, + unsigned outLen); +/*D +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of inBuf +which contains the concatenated command codes and associated data. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + SDA: 0-31 (as used in a prior call to [*bb_i2c_open*]) + inBuf: pointer to the concatenated I2C commands, see below + inLen: size of command buffer +outBuf: pointer to buffer to hold returned data +outLen: size of output buffer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_I2C_GPIO, PI_BAD_POINTER, +PI_BAD_I2C_CMD, PI_BAD_I2C_RLEN, PI_BAD_I2C_WLEN, +PI_I2C_READ_FAILED, or PI_I2C_WRITE_FAILED. + +The following command codes are supported: + +Name @ Cmd & Data @ Meaning +End @ 0 @ No more commands +Escape @ 1 @ Next P is two bytes +Start @ 2 @ Start condition +Stop @ 3 @ Stop condition +Address @ 4 P @ Set I2C address to P +Flags @ 5 lsb msb @ Set I2C flags to lsb + (msb << 8) +Read @ 6 P @ Read P bytes of data +Write @ 7 P ... @ Write P bytes of data + +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +No flags are currently defined. + +The returned I2C data is stored in consecutive locations of outBuf. + +... +Set address 0x53 +start, write 0x32, (re)start, read 6 bytes, stop +Set address 0x1E +start, write 0x03, (re)start, read 6 bytes, stop +Set address 0x68 +start, write 0x1B, (re)start, read 8 bytes, stop +End + +0x04 0x53 +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 + +0x04 0x1E +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 + +0x04 0x68 +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 + +0x00 +... +D*/ + +/*F*/ +int bb_spi_open( + int pi, + unsigned CS, unsigned MISO, unsigned MOSI, unsigned SCLK, + unsigned baud, unsigned spi_flags); +/*D +This function selects a set of GPIO for bit banging SPI at a +specified baud rate. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + CS: 0-31 + MISO: 0-31 + MOSI: 0-31 + SCLK: 0-31 + baud: 50-250000 +spi_flags: see below +. . + +spi_flags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +. . + +mm defines the SPI mode, defaults to 0 + +. . +Mode CPOL CPHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +p is 0 if CS is active low (default) and 1 for active high. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +The other bits in flags should be set to zero. + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, PI_BAD_SPI_BAUD, or +PI_GPIO_IN_USE. + +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +... +bb_spi_open(pi,10, MISO, MOSI, SCLK, 10000, 0); // device 1 +bb_spi_open(pi,11, MISO, MOSI, SCLK, 20000, 3); // device 2 +... +D*/ + +/*F*/ +int bb_spi_close(int pi, unsigned CS); +/*D +This function stops bit banging SPI on a set of GPIO +opened with [*bbSPIOpen*]. + +. . +pi: >=0 (as returned by [*pigpio_start*]). +CS: 0-31, the CS GPIO used in a prior call to [*bb_spi_open*] +. . + +Returns 0 if OK, otherwise PI_BAD_USER_GPIO, or PI_NOT_SPI_GPIO. +D*/ + +/*F*/ +int bb_spi_xfer( + int pi, + unsigned CS, + char *txBuf, + char *rxBuf, + unsigned count); +/*D +This function executes a bit banged SPI transfer. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + CS: 0-31 (as used in a prior call to [*bb_spi_open*]) +txBuf: pointer to buffer to hold data to be sent +rxBuf: pointer to buffer to hold returned data +count: size of data transfer +. . + +Returns >= 0 if OK (the number of bytes read), otherwise +PI_BAD_USER_GPIO, PI_NOT_SPI_GPIO or PI_BAD_POINTER. + +... +// gcc -Wall -pthread -o bb_spi_x_test bb_spi_x_test.c -lpigpiod_if2 +// ./bb_spi_x_test + +#include + +#include "pigpiod_if2.h" + +#define CE0 5 +#define CE1 6 +#define MISO 13 +#define MOSI 19 +#define SCLK 12 + +int main(int argc, char *argv[]) +{ + int i, pi, count, set_val, read_val; + unsigned char inBuf[3]; + char cmd1[] = {0, 0}; + char cmd2[] = {12, 0}; + char cmd3[] = {1, 128, 0}; + + if ((pi = pigpio_start(0, 0)) < 0) + { + fprintf(stderr, "pigpio initialisation failed (%d).\n", pi); + return 1; + } + + bb_spi_open(pi, CE0, MISO, MOSI, SCLK, 10000, 0); // MCP4251 DAC + bb_spi_open(pi, CE1, MISO, MOSI, SCLK, 20000, 3); // MCP3008 ADC + + for (i=0; i<256; i++) + { + cmd1[1] = i; + + count = bb_spi_xfer(pi, CE0, cmd1, (char *)inBuf, 2); // > DAC + + if (count == 2) + { + count = bb_spi_xfer(pi, CE0, cmd2, (char *)inBuf, 2); // < DAC + + if (count == 2) + { + set_val = inBuf[1]; + + count = bb_spi_xfer(pi, CE1, cmd3, (char *)inBuf, 3); // < ADC + + if (count == 3) + { + read_val = ((inBuf[1]&3)<<8) | inBuf[2]; + printf("%d %d\n", set_val, read_val); + } + } + } + } + + bb_spi_close(pi, CE0); + bb_spi_close(pi, CE1); + + pigpio_stop(pi); +} +... +D*/ + +/*F*/ +int spi_open(int pi, unsigned spi_channel, unsigned baud, unsigned spi_flags); +/*D +This function returns a handle for the SPI device on the channel. +Data will be transferred at baud bits per second. The flags may +be used to modify the default behaviour of 4-wire operation, mode 0, +active low chip select. + +The Pi has two SPI peripherals: main and auxiliary. + +The main SPI has two chip selects (channels), the auxiliary has +three. + +The auxiliary SPI is available on all models but the A and B. + +The GPIO used are given in the following table. + + @ MISO @ MOSI @ SCLK @ CE0 @ CE1 @ CE2 +Main SPI @ 9 @ 10 @ 11 @ 8 @ 7 @ - +Aux SPI @ 19 @ 20 @ 21 @ 18 @ 17 @ 16 + +. . + pi: >=0 (as returned by [*pigpio_start*]). +spi_channel: 0-1 (0-2 for the auxiliary SPI). + baud: 32K-125M (values above 30M are unlikely to work). + spi_flags: see below. +. . + +Returns a handle (>=0) if OK, otherwise PI_BAD_SPI_CHANNEL, +PI_BAD_SPI_SPEED, PI_BAD_FLAGS, PI_NO_AUX_SPI, or PI_SPI_OPEN_FAILED. + +spi_flags consists of the least significant 22 bits. + +. . +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +. . + +mm defines the SPI mode. + +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +. . +Mode POL PHA + 0 0 0 + 1 0 1 + 2 1 0 + 3 1 1 +. . + +px is 0 if CEx is active low (default) and 1 for active high. + +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +A is 0 for the main SPI, 1 for the auxiliary SPI. + +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +The [*spi_read*], [*spi_write*], and [*spi_xfer*] functions +transfer data packed into 1, 2, or 4 bytes according to +the word size in bits. + +For bits 1-8 there will be one byte per character. +For bits 9-16 there will be two bytes per character. +For bits 17-32 there will be four bytes per character. + +Multi-byte transfers are made in least significant byte first order. + +E.g. to transfer 32 11-bit words buf should contain 64 bytes +and count should be 64. + +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +The other bits in flags should be set to zero. +D*/ + +/*F*/ +int spi_close(int pi, unsigned handle); +/*D +This functions closes the SPI device identified by the handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*spi_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int spi_read(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function reads count bytes of data from the SPI +device associated with the handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*spi_open*]. + buf: an array to receive the read data bytes. + count: the number of bytes to read. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int spi_write(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes of data from buf to the SPI +device associated with the handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*spi_open*]. + buf: the data bytes to write. + count: the number of bytes to write. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int spi_xfer( + int pi, unsigned handle, char *txBuf, char *rxBuf, unsigned count); +/*D +This function transfers count bytes of data from txBuf to the SPI +device associated with the handle. Simultaneously count bytes of +data are read from the device and placed in rxBuf. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*spi_open*]. + txBuf: the data bytes to write. + rxBuf: the received data bytes. + count: the number of bytes to transfer. +. . + +Returns the number of bytes transferred if OK, otherwise +PI_BAD_HANDLE, PI_BAD_SPI_COUNT, or PI_SPI_XFER_FAILED. +D*/ + +/*F*/ +int serial_open(int pi, char *ser_tty, unsigned baud, unsigned ser_flags); +/*D +This function opens a serial device at a specified baud rate +with specified flags. The device name must start with +/dev/tty or /dev/serial. + + +. . + pi: >=0 (as returned by [*pigpio_start*]). + ser_tty: the serial device to open. + baud: the baud rate in bits per second, see below. +ser_flags: 0. +. . + +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, or +PI_SER_OPEN_FAILED. + +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +No flags are currently defined. This parameter should be set to zero. +D*/ + +/*F*/ +int serial_close(int pi, unsigned handle); +/*D +This function closes the serial device associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int serial_write_byte(int pi, unsigned handle, unsigned bVal); +/*D +This function writes bVal to the serial port associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + +/*F*/ +int serial_read_byte(int pi, unsigned handle); +/*D +This function reads a byte from the serial port associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns the read byte (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_SER_READ_NO_DATA, or PI_SER_READ_FAILED. + +If no data is ready PI_SER_READ_NO_DATA is returned. +D*/ + +/*F*/ +int serial_write(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes from buf to the the serial port +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. + buf: the array of bytes to write. + count: the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, or +PI_SER_WRITE_FAILED. +D*/ + +/*F*/ +int serial_read(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function reads up to count bytes from the the serial port +associated with handle and writes them to buf. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. + buf: an array to receive the read data. + count: the maximum number of bytes to read. +. . + +Returns the number of bytes read (>=0) if OK, otherwise PI_BAD_HANDLE, +PI_BAD_PARAM, PI_SER_READ_NO_DATA, or PI_SER_WRITE_FAILED. + +If no data is ready zero is returned. +D*/ + +/*F*/ +int serial_data_available(int pi, unsigned handle); +/*D +Returns the number of bytes available to be read from the +device associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0, as returned by a call to [*serial_open*]. +. . + +Returns the number of bytes of data available (>=0) if OK, +otherwise PI_BAD_HANDLE. +D*/ + +/*F*/ +int custom_1(int pi, unsigned arg1, unsigned arg2, char *argx, unsigned argc); +/*D +This function is available for user customisation. + +It returns a single integer value. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +arg1: >=0 +arg2: >=0 +argx: extra (byte) arguments +argc: number of extra arguments +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. +D*/ + + +/*F*/ +int custom_2(int pi, unsigned arg1, char *argx, unsigned argc, + char *retBuf, unsigned retMax); +/*D +This function is available for user customisation. + +It differs from custom_1 in that it returns an array of bytes +rather than just an integer. + +The return value is an integer indicating the number of returned bytes. +. . + pi: >=0 (as returned by [*pigpio_start*]). + arg1: >=0 + argc: extra (byte) arguments + count: number of extra arguments +retBuf: buffer for returned data +retMax: maximum number of bytes to return +. . + +Returns >= 0 if OK, less than 0 indicates a user defined error. + +Note, the number of returned bytes will be retMax or less. +D*/ + +/*F*/ +int get_pad_strength(int pi, unsigned pad); +/*D +This function returns the pad drive strength in mA. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +pad: 0-2, the pad to get. +. . + +Returns the pad drive strength if OK, otherwise PI_BAD_PAD. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +strength = get_pad_strength(pi, 0); // get pad 0 strength +... +D*/ + + +/*F*/ +int set_pad_strength(int pi, unsigned pad, unsigned padStrength); +/*D +This function sets the pad drive strength in mA. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + pad: 0-2, the pad to set. +padStrength: 1-16 mA. +. . + +Returns 0 if OK, otherwise PI_BAD_PAD, or PI_BAD_STRENGTH. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +... +set_pad_strength(pi, 0, 10); // set pad 0 strength to 10 mA +... +D*/ + + +/*F*/ +int shell_(int pi, char *scriptName, char *scriptString); +/*D +This function uses the system call to execute a shell script +with the given string as its parameter. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + scriptName: the name of the script, only alphanumeric characters, + '-' and '_' are allowed in the name. +scriptString: the string to pass to the script. +. . + +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +scriptName must exist in /opt/pigpio/cgi and must be executable. + +The returned exit status is normally 256 times that set by the +shell script exit function. If the script can't be found 32512 will +be returned. + +The following table gives some example returned statuses. + +Script exit status @ Returned system call status +1 @ 256 +5 @ 1280 +10 @ 2560 +200 @ 51200 +script not found @ 32512 + +... +// pass two parameters, hello and world +status = shell_(pi, "scr1", "hello world"); + +// pass three parameters, hello, string with spaces, and world +status = shell_(pi, "scr1", "hello 'string with spaces' world"); + +// pass one parameter, hello string with spaces world +status = shell_(pi, "scr1", "\"hello string with spaces world\""); +... +D*/ + +#pragma GCC diagnostic push + +#pragma GCC diagnostic ignored "-Wcomment" + +/*F*/ +int file_open(int pi, char *file, unsigned mode); +/*D +This function returns a handle to a file opened in a specified mode. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +file: the file to open. +mode: the file open mode. +. . + +Returns a handle (>=0) if OK, otherwise PI_NO_HANDLE, PI_NO_FILE_ACCESS, +PI_BAD_FILE_MODE, PI_FILE_OPEN_FAILED, or PI_FILE_IS_A_DIR. + +File + +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +Suppose /opt/pigpio/access contains the following entries + +. . +/home/* n +/home/pi/shared/dir_1/* w +/home/pi/shared/dir_2/* r +/home/pi/shared/dir_3/* u +/home/pi/shared/dir_1/file.txt n +. . + +Files may be written in directory dir_1 with the exception +of file.txt. + +Files may be read in directory dir_2. + +Files may be read and written in directory dir_3. + +If a directory allows read, write, or read/write access then files may +be created in that directory. + +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +. . +a path containing .. +a path containing only wildcards (*?) +a path containing less than two non-wildcard parts +. . + +Mode + +The mode may have the following values. + +Macro @ Value @ Meaning +PI_FILE_READ @ 1 @ open file for reading +PI_FILE_WRITE @ 2 @ open file for writing +PI_FILE_RW @ 3 @ open file for reading and writing + +The following values may be or'd into the mode. + +Macro @ Value @ Meaning +PI_FILE_APPEND @ 4 @ Writes append data to the end of the file +PI_FILE_CREATE @ 8 @ The file is created if it doesn't exist +PI_FILE_TRUNC @ 16 @ The file is truncated + +Newly created files are owned by root with permissions owner read and write. + +... +#include +#include + +int main(int argc, char *argv[]) +{ + int pi, handle, c; + char buf[60000]; + + pi = pigpio_start(NULL, NULL); + + if (pi < 0) return 1; + + // assumes /opt/pigpio/access contains the following line + // /ram/*.c r + + handle = file_open(pi, "/ram/pigpio.c", PI_FILE_READ); + + if (handle >= 0) + { + while ((c=file_read(pi, handle, buf, sizeof(buf)-1))) + { + buf[c] = 0; + printf("%s", buf); + } + + file_close(pi, handle); + } + + pigpio_stop(pi); +} +... +D*/ + +#pragma GCC diagnostic pop + +/*F*/ +int file_close(int pi, unsigned handle); +/*D +This function closes the file associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0 (as returned by [*file_open*]). +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE. + +... +file_close(pi, handle); +... +D*/ + + +/*F*/ +int file_write(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function writes count bytes from buf to the the file +associated with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0 (as returned by [*file_open*]). + buf: the array of bytes to write. + count: the number of bytes to write. +. . + +Returns 0 if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, +PI_FILE_NOT_WOPEN, or PI_BAD_FILE_WRITE. + +... +if (file_write(pi, handle, buf, 100) == 0) +{ + // file written okay +} +else +{ + // error +} +... +D*/ + + +/*F*/ +int file_read(int pi, unsigned handle, char *buf, unsigned count); +/*D +This function reads up to count bytes from the the file +associated with handle and writes them to buf. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +handle: >=0 (as returned by [*file_open*]). + buf: an array to receive the read data. + count: the maximum number of bytes to read. +. . + +Returns the number of bytes read (>0) if OK, otherwise PI_BAD_HANDLE, PI_BAD_PARAM, PI_FILE_NOT_ROPEN, or PI_BAD_FILE_WRITE. + +... + bytes = file_read(pi, handle, buf, sizeof(buf)); + + if (bytes >= 0) + { + // process read data + } +... +D*/ + + +/*F*/ +int file_seek(int pi, unsigned handle, int32_t seekOffset, int seekFrom); +/*D +This function seeks to a position within the file associated +with handle. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + handle: >=0 (as returned by [*file_open*]). +seekOffset: the number of bytes to move. Positive offsets + move forward, negative offsets backwards. + seekFrom: one of PI_FROM_START (0), PI_FROM_CURRENT (1), + or PI_FROM_END (2). +. . + +Returns the new byte position within the file (>=0) if OK, otherwise PI_BAD_HANDLE, or PI_BAD_FILE_SEEK. + +... +file_seek(pi, handle, 123, PI_FROM_START); // Start plus 123 + +size = file_seek(pi, handle, 0, PI_FROM_END); // End, return size + +pos = file_seek(pi, handle, 0, PI_FROM_CURRENT); // Current position +... +D*/ + +#pragma GCC diagnostic push + +#pragma GCC diagnostic ignored "-Wcomment" + +/*F*/ +int file_list(int pi, char *fpat, char *buf, unsigned count); +/*D +This function returns a list of files which match a pattern. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + fpat: file pattern to match. + buf: an array to receive the matching file names. +count: the maximum number of bytes to read. +. . + +Returns the number of returned bytes if OK, otherwise PI_NO_FILE_ACCESS, +or PI_NO_FILE_MATCH. + +The pattern must match an entry in /opt/pigpio/access. The pattern +may contain wildcards. See [*file_open*]. + +NOTE + +The returned value is not the number of files, it is the number +of bytes in the buffer. The file names are separated by newline +characters. + +... +#include +#include + +int main(int argc, char *argv[]) +{ + int pi, handle, c; + char buf[60000]; + + pi = pigpio_start(NULL, NULL); + + if (pi < 0) return 1; + + // assumes /opt/pigpio/access contains the following line + // /ram/*.c r + + c = file_list(pi, "/ram/p*.c", buf, sizeof(buf)); + + if (c >= 0) + { + buf[c] = 0; + printf("%s", buf); + } + + pigpio_stop(pi); +} +... +D*/ + +#pragma GCC diagnostic pop + + +/*F*/ +int callback(int pi, unsigned user_gpio, unsigned edge, CBFunc_t f); +/*D +This function initialises a new callback. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + f: the callback function. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the GPIO, edge, and tick, whenever the +GPIO has the identified edge. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +edge 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes +. . + +The GPIO are sampled at a rate set when the pigpio daemon +is started (default 5 us). + +The number of samples per second is given in the following table. + +. . + samples + per sec + + 1 1,000,000 + 2 500,000 +sample 4 250,000 +rate 5 200,000 +(us) 8 125,000 + 10 100,000 +. . + +GPIO level changes shorter than the sample rate may be missed. + +The daemon software which generates the callbacks is triggered +1000 times per second. The callbacks will be called once per +level change since the last time they were called. +i.e. The callbacks will get all level changes but there will +be a latency. + +If you want to track the level of more than one GPIO do so by +maintaining the state in the callback. Do not use [*gpio_read*]. +Remember the event that triggered the callback may have +happened several milliseconds before and the GPIO may have +changed level many times since then. +D*/ + +/*F*/ +int callback_ex + (int pi, unsigned user_gpio, unsigned edge, CBFuncEx_t f, void *userdata); +/*D +This function initialises a new callback. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + f: the callback function. + userdata: a pointer to arbitrary user data. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the GPIO, edge, tick, and the userdata +pointer, whenever the GPIO has the identified edge. + +. . +Parameter Value Meaning + +GPIO 0-31 The GPIO which has changed state + +edge 0-2 0 = change to low (a falling edge) + 1 = change to high (a rising edge) + 2 = no level change (a watchdog timeout) + +tick 32 bit The number of microseconds since boot + WARNING: this wraps around from + 4294967295 to 0 roughly every 72 minutes + +userdata pointer Pointer to an arbitrary object +. . +D*/ + +/*F*/ +int callback_cancel(unsigned callback_id); +/*D +This function cancels a callback identified by its id. + +. . +callback_id: >=0, as returned by a call to [*callback*] or [*callback_ex*]. +. . + +The function returns 0 if OK, otherwise pigif_callback_not_found. +D*/ + +/*F*/ +int wait_for_edge(int pi, unsigned user_gpio, unsigned edge, double timeout); +/*D +This function waits for an edge on the GPIO for up to timeout +seconds. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +user_gpio: 0-31. + edge: RISING_EDGE, FALLING_EDGE, or EITHER_EDGE. + timeout: >=0. +. . + +The function returns when the edge occurs or after the timeout. + +Do not use this function for precise timing purposes, +the edge is only checked 20 times a second. Whenever +you need to know the accurate time of GPIO events use +a [*callback*] function. + +The function returns 1 if the edge occurred, otherwise 0. +D*/ + +/*F*/ +int bsc_xfer(int pi, bsc_xfer_t *bscxfer); +/*D +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +The function sets the BSC mode, writes any data in +the transmit buffer to the BSC transmit FIFO, and +copies any data in the BSC receive FIFO to the +receive buffer. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +bscxfer: a structure defining the transfer. + +typedef struct +{ + uint32_t control; // Write + int rxCnt; // Read only + char rxBuf[BSC_FIFO_SIZE]; // Read only + int txCnt; // Write + char txBuf[BSC_FIFO_SIZE]; // Write +} bsc_xfer_t; +. . + +To start a transfer set control (see below), copy the bytes to +be added to the transmit FIFO (if any) to txBuf and set txCnt to +the number of copied bytes. + +Upon return rxCnt will be set to the number of received bytes placed +in rxBuf. + +The returned function value is the status of the transfer (see below). + +If there was an error the status will be less than zero +(and will contain the error code). + +The most significant word of the returned status contains the number +of bytes actually copied from txBuf to the BSC transmit FIFO (may be +less than requested if the FIFO already contained untransmitted data). + +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +GPIO used for models other than those based on the BCM2711. + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 18 @ 19 @ - @ - @ - @ - +SPI @ - @ - @ 20 @ 19 @ 18 @ 21 + +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + + @ SDA @ SCL @ MOSI @ SCLK @ MISO @ CE +I2C @ 10 @ 11 @ - @ - @ - @ - +SPI @ - @ - @ 9 @ 11 @ 10 @ 8 + +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +control consists of the following bits. + +. . +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +. . + +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +aaaaaaa @ defines the I2C slave address (only relevant in I2C mode) +IT @ invert transmit status flags +HC @ enable host control +TF @ enable test FIFO +IR @ invert receive status flags +RE @ enable receive +TE @ enable transmit +BK @ abort operation and clear FIFOs +EC @ send control register as first I2C byte +ES @ send status register as first I2C byte +PL @ set SPI polarity high +PH @ set SPI phase high +I2 @ enable I2C mode +SP @ enable SPI mode +EN @ enable BSC peripheral + +The returned status has the following format + +. . +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 + S S S S S R R R R R T T T T T RB TE RF TF RE TB +. . + +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +SSSSS @ number of bytes successfully copied to transmit FIFO +RRRRR @ number of bytes in receive FIFO +TTTTT @ number of bytes in transmit FIFO +RB @ receive busy +TE @ transmit FIFO empty +RF @ receive FIFO full +TF @ transmit FIFO full +RE @ receive FIFO empty +TB @ transmit busy + +The following example shows how to configure the BSC peripheral as +an I2C slave with address 0x13 and send four bytes. + +... +bsc_xfer_t xfer; + +xfer.control = (0x13<<16) | 0x305; + +memcpy(xfer.txBuf, "ABCD", 4); +xfer.txCnt = 4; + +status = bsc_xfer(pi, &xfer); + +if (status >= 0) +{ + // process transfer +} +... + +The BSC slave in SPI mode deserializes data from the MOSI pin into its +receiver/FIFO when the LSB of the first byte is a 0. No data is output on +the MISO pin. When the LSB of the first byte on MOSI is a 1, the +transmitter/FIFO data is serialized onto the MISO pin while all other data +on the MOSI pin is ignored. + +The BK bit of the BSC control register is non-functional when in the SPI +mode. The transmitter along with its FIFO can be dequeued by successively +disabling and re-enabling the TE bit on the BSC control register while in +SPI mode. +D*/ + +/*F*/ +int bsc_i2c(int pi, int i2c_addr, bsc_xfer_t *bscxfer); +/*D +This function allows the Pi to act as a slave I2C device. + +This function is not available on the BCM2711 (e.g.as +used in the Pi4B). + +The data bytes (if any) are written to the BSC transmit +FIFO and the bytes in the BSC receive FIFO are returned. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +i2c_addr: 0-0x7F. + bscxfer: a structure defining the transfer. + +typedef struct +{ + uint32_t control; // N/A + int rxCnt; // Read only + char rxBuf[BSC_FIFO_SIZE]; // Read only + int txCnt; // Write + char txBuf[BSC_FIFO_SIZE]; // Write +} bsc_xfer_t; +. . + +txCnt is set to the number of bytes to be transmitted, possibly +zero. The data itself should be copied to txBuf. + +Any received data will be written to rxBuf with rxCnt set. + +See [*bsc_xfer*] for details of the returned status value. + +If there was an error the status will be less than zero +(and will contain the error code). + +Note that an i2c_address of 0 may be used to close +the BSC device and reassign the used GPIO as inputs. +D*/ + +/*F*/ +int event_callback(int pi, unsigned event, evtCBFunc_t f); +/*D +This function initialises an event callback. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +event: 0-31. + f: the callback function. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the event id, and tick, whenever the +event occurs. +D*/ + +/*F*/ +int event_callback_ex(int pi, unsigned event, evtCBFuncEx_t f, void *userdata); +/*D +This function initialises an event callback. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + event: 0-31. + f: the callback function. +userdata: a pointer to arbitrary user data. +. . + +The function returns a callback id if OK, otherwise pigif_bad_malloc, +pigif_duplicate_callback, or pigif_bad_callback. + +The callback is called with the event id, the tick, and the userdata +pointer whenever the event occurs. +D*/ + +/*F*/ +int event_callback_cancel(unsigned callback_id); +/*D +This function cancels an event callback identified by its id. + +. . +callback_id: >=0, as returned by a call to [*event_callback*] or +[*event_callback_ex*]. +. . + +The function returns 0 if OK, otherwise pigif_callback_not_found. +D*/ + +/*F*/ +int wait_for_event(int pi, unsigned event, double timeout); +/*D +This function waits for an event for up to timeout seconds. + +. . + pi: >=0 (as returned by [*pigpio_start*]). + event: 0-31. +timeout: >=0. +. . + +The function returns when the event occurs or after the timeout. + +The function returns 1 if the event occurred, otherwise 0. +D*/ + +/*F*/ +int event_trigger(int pi, unsigned event); +/*D +This function signals the occurrence of an event. + +. . + pi: >=0 (as returned by [*pigpio_start*]). +event: 0-31. +. . + +Returns 0 if OK, otherwise PI_BAD_EVENT_ID. + +An event is a signal used to inform one or more consumers +to start an action. Each consumer which has registered an interest +in the event (e.g. by calling [*event_callback*]) will be informed by +a callback. + +One event, PI_EVENT_BSC (31) is predefined. This event is +auto generated on BSC slave activity. + +The meaning of other events is arbitrary. + +Note that other than its id and its tick there is no data associated +with an event. +D*/ + +/*PARAMS + +active :: 0-1000000 + +The number of microseconds level changes are reported for once +a noise filter has been triggered (by [*steady*] microseconds of +a stable level). + +*addrStr:: +A string specifying the host or IP address of the Pi running +the pigpio daemon. It may be NULL in which case localhost +is used unless overridden by the PIGPIO_ADDR environment +variable. + +arg1:: +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +arg2:: +An unsigned argument passed to a user customised function. Its +meaning is defined by the customiser. + +argc:: +The count of bytes passed to a user customised function. + +*argx:: +A pointer to an array of bytes passed to a user customised function. +Its meaning and content is defined by the customiser. + +baud:: +The speed of serial communication (I2C, SPI, serial link, waves) in +bits per second. + +bit:: +A value of 0 or 1. + +bits:: +A value used to select GPIO. If bit n of bits is set then GPIO n is +selected. + +A convenient way to set bit n is to or in (1<=0, as returned by a call to a callback function, one of + +[*callback*] +[*callback_ex*] +[*event_callback*] +[*event_callback_ex*] + +The id is passed to [*callback_cancel*] or [*event_callback_cancel*] +to cancel the callback. + +CBFunc_t:: +. . +typedef void (*CBFunc_t) + (int pi, unsigned user_gpio, unsigned level, uint32_t tick); +. . + +CBFuncEx_t:: +. . +typedef void (*CBFuncEx_t) + (int pi, unsigned user_gpio, unsigned level, uint32_t tick, void * userdata); +. . + +char:: +A single character, an 8 bit quantity able to store 0-255. + +clkfreq::4689-250M (13184-375M for the BCM2711) +The hardware clock frequency. + +count:: +The number of bytes to be transferred in a file, I2C, SPI, or serial +command. + +CS:: +The GPIO used for the slave select signal when bit banging SPI. + +data_bits::1-32 +The number of data bits in each character of serial data. + +. . +#define PI_MIN_WAVE_DATABITS 1 +#define PI_MAX_WAVE_DATABITS 32 +. . + +double:: +A floating point number. + +dutycycle::0-range +A number representing the ratio of on time to off time for PWM. + +The number may vary between 0 and range (default 255) where +0 is off and range is fully on. + +edge:: +Used to identify a GPIO level transition of interest. A rising edge is +a level change from 0 to 1. A falling edge is a level change from 1 to 0. + +. . +RISING_EDGE 0 +FALLING_EDGE 1 +EITHER_EDGE. 2 +. . + +errnum:: +A negative number indicating a function call failed and the nature +of the error. + +event::0-31 +An event is a signal used to inform one or more consumers +to start an action. + +evtCBFunc_t:: + +. . +typedef void (*evtCBFunc_t) + (int pi, unsigned event, uint32_t tick); +. . + +evtCBFuncEx_t:: + +. . +typedef void (*evtCBFuncEx_t) + (int pi, unsigned event, uint32_t tick, void *userdata); +. . + +f:: +A function. + +*file:: +A full file path. To be accessible the path must match an entry in +/opt/pigpio/access. + +*fpat:: +A file path which may contain wildcards. To be accessible the path +must match an entry in /opt/pigpio/access. + +frequency::>=0 +The number of times a GPIO is swiched on and off per second. This +can be set per GPIO and may be as little as 5Hz or as much as +40KHz. The GPIO will be on for a proportion of the time as defined +by its dutycycle. + +gpio:: +A Broadcom numbered GPIO, in the range 0-53. + +There are 54 General Purpose Input Outputs (GPIO) named GPIO0 through +GPIO53. + +They are split into two banks. Bank 1 consists of GPIO0 through +GPIO31. Bank 2 consists of GPIO32 through GPIO53. + +All the GPIO which are safe for the user to read and write are in +bank 1. Not all GPIO in bank 1 are safe though. Type 1 boards +have 17 safe GPIO. Type 2 boards have 21. Type 3 boards have 26. + +See [*get_hardware_revision*]. + +The user GPIO are marked with an X in the following table. + +. . + 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 +Type 1 X X - - X - - X X X X X - - X X +Type 2 - - X X X - - X X X X X - - X X +Type 3 X X X X X X X X X X X X X X + + 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 +Type 1 - X X - - X X X X X - - - - - - +Type 2 - X X - - - X X X X - X X X X X +Type 3 X X X X X X X X X X X X - - - - +. . + +gpioPulse_t:: +. . +typedef struct +{ + uint32_t gpioOn; + uint32_t gpioOff; + uint32_t usDelay; +} gpioPulse_t; +. . + +gpioThreadFunc_t:: +. . +typedef void *(gpioThreadFunc_t) (void *); +. . + +handle::>=0 +A number referencing an object opened by one of + +[*file_open*] +[*i2c_open*] +[*notify_open*] +[*serial_open*] +[*spi_open*] + +i2c_addr::0-0x7F +The address of a device on the I2C bus. + +i2c_bus::>=0 +An I2C bus number. + +i2c_flags::0 +Flags which modify an I2C open command. None are currently defined. + +i2c_reg:: 0-255 +A register of an I2C device. + +*inBuf:: +A buffer used to pass data to a function. + +inLen:: +The number of bytes of data in a buffer. + +int:: +A whole number, negative or positive. + +int32_t:: +A 32-bit signed value. + +invert:: +A flag used to set normal or inverted bit bang serial data level logic. + +level:: +The level of a GPIO. Low or High. + +. . +PI_OFF 0 +PI_ON 1 + +PI_CLEAR 0 +PI_SET 1 + +PI_LOW 0 +PI_HIGH 1 +. . + +There is one exception. If a watchdog expires on a GPIO the level will be +reported as PI_TIMEOUT. See [*set_watchdog*]. + +. . +PI_TIMEOUT 2 +. . + +MISO:: +The GPIO used for the MISO signal when bit banging SPI. + +mode:: +1. The operational mode of a GPIO, normally INPUT or OUTPUT. + +. . +PI_INPUT 0 +PI_OUTPUT 1 +PI_ALT0 4 +PI_ALT1 5 +PI_ALT2 6 +PI_ALT3 7 +PI_ALT4 3 +PI_ALT5 2 +. . + +2. The mode of waveform transmission. + +. . +PI_WAVE_MODE_ONE_SHOT 0 +PI_WAVE_MODE_REPEAT 1 +PI_WAVE_MODE_ONE_SHOT_SYNC 2 +PI_WAVE_MODE_REPEAT_SYNC 3 +. . + +3. A file open mode. + +. . +PI_FILE_READ 1 +PI_FILE_WRITE 2 +PI_FILE_RW 3 +. . + +The following values can be or'd into the mode. + +. . +PI_FILE_APPEND 4 +PI_FILE_CREATE 8 +PI_FILE_TRUNC 16 +. . + +MOSI:: +The GPIO used for the MOSI signal when bit banging SPI. + +numBytes:: +The number of bytes used to store characters in a string. Depending +on the number of bits per character there may be 1, 2, or 4 bytes +per character. + +numPar:: 0-10 +The number of parameters passed to a script. + +numPulses:: +The number of pulses to be added to a waveform. + +offset:: +The associated data starts this number of microseconds from the start of +the waveform. + +*outBuf:: +A buffer used to return data from a function. + +outLen:: +The size in bytes of an output buffer. + +pad:: 0-2 +A set of GPIO which share common drivers. + +Pad @ GPIO +0 @ 0-27 +1 @ 28-45 +2 @ 46-53 + +padStrength:: 1-16 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +*param:: +An array of script parameters. + +percent:: 0-100 +The size of waveform as percentage of maximum available. + +pi:: +An integer defining a connected Pi. The value is returned by +[*pigpio_start*] upon success. + +*portStr:: +A string specifying the port address used by the Pi running +the pigpio daemon. It may be NULL in which case "8888" +is used unless overridden by the PIGPIO_PORT environment +variable. + +*pth:: +A thread identifier, returned by [*start_thread*]. + + +pthread_t:: +A thread identifier. + +pud::0-2 +The setting of the pull up/down resistor for a GPIO, which may be off, +pull-up, or pull-down. +. . +PI_PUD_OFF 0 +PI_PUD_DOWN 1 +PI_PUD_UP 2 +. . + +pulseLen:: +1-100, the length of a trigger pulse in microseconds. + +*pulses:: +An array of pulses to be added to a waveform. + +pulsewidth::0, 500-2500 +. . +PI_SERVO_OFF 0 +PI_MIN_SERVO_PULSEWIDTH 500 +PI_MAX_SERVO_PULSEWIDTH 2500 +. . + +PWMduty::0-1000000 (1M) +The hardware PWM dutycycle. + +. . +#define PI_HW_PWM_RANGE 1000000 +. . + +PWMfreq::1-125M (1-187.5M for the BCM2711) +The hardware PWM frequency. + +. . +#define PI_HW_PWM_MIN_FREQ 1 +#define PI_HW_PWM_MAX_FREQ 125000000 +#define PI_HW_PWM_MAX_FREQ_2711 187500000 +. . + +range::25-40000 +The permissible dutycycle values are 0-range. + +. . +PI_MIN_DUTYCYCLE_RANGE 25 +PI_MAX_DUTYCYCLE_RANGE 40000 +. . + +*retBuf:: +A buffer to hold a number of bytes returned to a used customised function, + +retMax:: +The maximum number of bytes a user customised function should return. + + +*rxBuf:: +A pointer to a buffer to receive data. + +SCL:: +The user GPIO to use for the clock when bit banging I2C. + +SCLK:: +The GPIO used for the SCLK signal when bit banging SPI. + +*script:: +A pointer to the text of a script. + +script_id:: +An id of a stored script as returned by [*store_script*]. + +*scriptName:: +The name of a [*shell_*] script to be executed. The script must be present in +/opt/pigpio/cgi and must have execute permission. + +*scriptString:: +The string to be passed to a [*shell_*] script to be executed. + +SDA:: +The user GPIO to use for data when bit banging I2C. + +seconds:: +The number of seconds. + +seekFrom:: + +. . +PI_FROM_START 0 +PI_FROM_CURRENT 1 +PI_FROM_END 2 +. . + +seekOffset:: +The number of bytes to move forward (positive) or backwards (negative) +from the seek position (start, current, or end of file). + +ser_flags:: +Flags which modify a serial open command. None are currently defined. + +*ser_tty:: +The name of a serial tty device, e.g. /dev/ttyAMA0, /dev/ttyUSB0, /dev/tty1. + +size_t:: +A standard type used to indicate the size of an object in bytes. + +spi_channel:: +A SPI channel, 0-2. + +spi_flags:: +See [*spi_open*] and [*bb_spi_open*]. + +steady:: 0-300000 + +The number of microseconds level changes must be stable for +before reporting the level changed ([*set_glitch_filter*]) or triggering +the active part of a noise filter ([*set_noise_filter*]). + +stop_bits::2-8 +The number of (half) stop bits to be used when adding serial data +to a waveform. + +. . +#define PI_MIN_WAVE_HALFSTOPBITS 2 +#define PI_MAX_WAVE_HALFSTOPBITS 8 +. . + +*str:: + An array of characters. + +thread_func:: +A function of type gpioThreadFunc_t used as the main function of a +thread. + +timeout:: +A GPIO watchdog timeout in milliseconds. + +. . +PI_MIN_WDOG_TIMEOUT 0 +PI_MAX_WDOG_TIMEOUT 60000 +. . + +*txBuf:: +An array of bytes to transmit. + +uint32_t::0-0-4,294,967,295 (Hex 0x0-0xFFFFFFFF) +A 32-bit unsigned value. + +unsigned:: +A whole number >= 0. + +user_gpio:: +0-31, a Broadcom numbered GPIO. + +See [*gpio*]. + +*userdata:: + +A pointer to arbitrary user data. This may be used to identify the instance. + +You must ensure that the pointer is in scope at the time it is processed. If +it is a pointer to a global this is automatic. Do not pass the address of a +local variable. If you want to pass a transient object then use the +following technique. + +In the calling function: + +. . +user_type *userdata; +user_type my_userdata; + +userdata = malloc(sizeof(user_type)); +*userdata = my_userdata; +. . + +In the receiving function: + +. . +user_type my_userdata = *(user_type*)userdata; + +free(userdata); +. . + +void:: +Denoting no parameter is required + +wave_add_*:: +One of + +[*wave_add_new*] +[*wave_add_generic*] +[*wave_add_serial*] + +wave_id:: +A number representing a waveform created by [*wave_create*]. + +wave_send_*:: +One of + +[*wave_send_once*] +[*wave_send_repeat*] + +wVal::0-65535 (Hex 0x0-0xFFFF, Octal 0-0177777) +A 16-bit word value. + +PARAMS*/ + +/*DEF_S pigpiod_if2 Error Codes*/ + +typedef enum +{ + pigif_bad_send = -2000, + pigif_bad_recv = -2001, + pigif_bad_getaddrinfo = -2002, + pigif_bad_connect = -2003, + pigif_bad_socket = -2004, + pigif_bad_noib = -2005, + pigif_duplicate_callback = -2006, + pigif_bad_malloc = -2007, + pigif_bad_callback = -2008, + pigif_notify_failed = -2009, + pigif_callback_not_found = -2010, + pigif_unconnected_pi = -2011, + pigif_too_many_pis = -2012, +} pigifError_t; + +/*DEF_E*/ + +#ifdef __cplusplus +} +#endif + +#endif + diff --git a/pigpio-master/pigs.1 b/pigpio-master/pigs.1 new file mode 100644 index 0000000..1d9bf6f --- /dev/null +++ b/pigpio-master/pigs.1 @@ -0,0 +1,6380 @@ + +." Process this file with +." groff -man -Tascii foo.1 +." +.TH pigs 1 2012-2020 Linux "pigpio archive" +.SH NAME +pigs - command line socket access to the pigpio daemon. + +/dev/pigpio - command line pipe access to the pigpio daemon. + +.SH SYNOPSIS + +.B sudo pigpiod + +then + +.B pigs {command}+ + +or + +.B "echo {command}+ >/dev/pigpio" + +.SH DESCRIPTION + +.ad l + +.nh + + +.br +The socket and pipe interfaces allow control of the Pi's GPIO by +passing messages to the running pigpio library. + +.br +The normal way to start the pigpio library would be as a daemon during boot. + +.br + +.EX +sudo pigpiod +.br + +.EE + +.br +.SS Features +.br +o hardware timed PWM on any of GPIO 0-31 + +.br +o hardware timed servo pulses on any of GPIO 0-31 + +.br +o reading/writing all of the GPIO in a bank as one operation + +.br +o individually setting GPIO modes, reading and writing + +.br +o notifications when any of GPIO 0-31 change state + +.br +o the construction of output waveforms with microsecond timing + +.br +o I2C, SPI, and serial link wrappers + +.br +o creating and running scripts on the pigpio daemon + +.br +.SS GPIO +.br +ALL GPIO are identified by their Broadcom number. + +.br +.SS Usage +.br +pigs is a program and internally uses the socket interface to pigpio +whereas /dev/pigpio uses the pipe interface. + +.br +pigs and the pipe interface share the same commands and are invoked in +a similar fashion from the command line. + +.br +The pigpio library must be running, either by running a program linked +with the library or starting the pigpio daemon (sudo pigpiod). + +.br +pigs {command}+ + +.br +echo "{command}+" >/dev/pigpio + +.br +pigs will show the result of the command on screen. + +.br +The pigs process returns an exit status (which can be displayed with +the command echo $?). + +.br + +.EX +PIGS_OK 0 +.br +PIGS_CONNECT_ERR 255 +.br +PIGS_OPTION_ERR 254 +.br +PIGS_SCRIPT_ERR 253 +.br +.br +.br + +.EE + +.br +The results of /dev/pigpio commands need to be read from /dev/pigout, +e.g. cat /dev/pigout (try cat /dev/pigout& so that all subsequent +results are shown on screen). + +.br +In both cases if an error was detected a message will have been written +to /dev/pigerr (try cat /dev/pigerr&). This is likely to be more +informative than the message returned by pigs or the error code +returned by the pipe interface. + +.br +Several commands may be entered on a line. If present PROC and PARSE must +be the last command on a line. + +.br +E.g. + +.br + +.EX +pigs w 22 1 mils 1000 w 22 0 +.br + +.EE + +.br +is equivalent to + +.br + +.EX +pigs w 22 1 +.br +pigs mils 1000 +.br +pigs w 22 0 +.br + +.EE + +.br +and + +.br + +.EX +echo "m 4 w w 4 0 mils 250 m 4 r r 4" >/dev/pigpio +.br + +.EE + +.br +is equivalent to + +.br + +.EX +echo "m 4 w" >/dev/pigpio +.br +echo "w 4 0" >/dev/pigpio +.br +echo "mils 250" >/dev/pigpio +.br +echo "m 4 r" >/dev/pigpio +.br +echo "r 4" >/dev/pigpio +.br + +.EE + +.br +.SS Notes +.br +The examples from now on will show the pigs interface but the same +commands will also work on the pipe interface. + +.br +pigs does not show the status of successful commands unless the +command itself returns data. The status (0) will be returned to +pigs but will be discarded. + +.br +The status/data of each command sent to the pipe interface should +be read from /dev/pigout. + +.br +When a command takes a number as a parameter it may be entered as hex +(precede by 0x), octal (precede by 0), or decimal. + +.br +E.g. 23 is 23 decimal, 0x100 is 256 decimal, 070 is 56 decimal. + +.br +Some commands can return a variable number of data bytes. By +default this data is displayed as decimal. The pigs -a option +can be used to force the display as ASCII and the pigs -x +option can be used to force the display as hex. + +.br +E.g. assuming the transmitted serial data is the letters ABCDEONM + +.br + +.EX +$ pigs slr 4 100 +.br +8 65 66 67 68 69 79 78 77 +.br + +.br +$ pigs -a slr 4 100 +.br +8 ABCDEONM +.br + +.br +$ pigs -x slr 4 100 +.br +8 41 42 43 44 45 4f 4e 4d +.br + +.EE + +.br + +.SH OVERVIEW +.SS BASIC +.B M/MODES g m +Set GPIO mode +.P +.B MG/MODEG g +Get GPIO mode +.P +.B PUD g p +Set GPIO pull up/down +.P +.B R/READ g +Read GPIO level +.P +.B W/WRITE g L +Write GPIO level +.P +.SS PWM (overrides servo commands on same GPIO) +.B P/PWM u v +Set GPIO PWM value +.P +.B PFS u v +Set GPIO PWM frequency +.P +.B PRS u v +Set GPIO PWM range +.P +.B GDC u +Get GPIO PWM dutycycle +.P +.B PFG u +Get GPIO PWM frequency +.P +.B PRG u +Get GPIO PWM range +.P +.B PRRG u +Get GPIO PWM real range +.P +.SS Servo (overrides PWM commands on same GPIO) +.B S/SERVO u v +Set GPIO servo pulsewidth +.P +.B GPW u +Get GPIO servo pulsewidth +.P +.SS INTERMEDIATE +.B TRIG u pl L +Send a trigger pulse +.P +.B WDOG u v +Set GPIO watchdog +.P +.B BR1 +Read bank 1 GPIO +.P +.B BR2 +Read bank 2 GPIO +.P +.B BC1 bits +Clear specified GPIO in bank 1 +.P +.B BC2 bits +Clear specified GPIO in bank 2 +.P +.B BS1 bits +Set specified GPIO in bank 1 +.P +.B BS2 bits +Set specified GPIO in bank 2 +.P +.SS ADVANCED +.B NO +Request a notification +.P +.B NC h +Close notification +.P +.B NB h bits +Start notification +.P +.B NP h +Pause notification +.P +.B HC g cf +Set hardware clock frequency +.P +.B HP g pf pdc +Set hardware PWM frequency and dutycycle +.P +.B FG u stdy +Set a glitch filter on a GPIO +.P +.B FN u stdy actv +Set a noise filter on a GPIO +.P +.B PADS pad padma +Set pad drive strength +.P +.B PADG pad +Get pad drive strength +.P +.B SHELL name str +Execute a shell command +.P +.SS Custom +.B CF1 uvs +Custom function 1 +.P +.B CF2 uvs +Custom function 2 +.P +.SS Events +.B EVM h bits +Set events to monitor +.P +.B EVT event +Trigger event +.P +.SS Scripts +.B PROC t +Store script +.P +.B PROCR sid pars +Run script +.P +.B PROCU sid pars +Set script parameters +.P +.B PROCP sid +Get script status and parameters +.P +.B PROCS sid +Stop script +.P +.B PROCD sid +Delete script +.P +.B PARSE t +Validate script +.P +.SS I2C +.B I2CO ib id if +Open I2C bus and device with flags +.P +.B I2CC h +Close I2C handle +.P +.B I2CWQ h bit +smb Write Quick: write bit +.P +.B I2CRS h +smb Read Byte: read byte +.P +.B I2CWS h bv +smb Write Byte: write byte +.P +.B I2CRB h r +smb Read Byte Data: read byte from register +.P +.B I2CWB h r bv +smb Write Byte Data: write byte to register +.P +.B I2CRW h r +smb Read Word Data: read word from register +.P +.B I2CWW h r wv +smb Write Word Data: write word to register +.P +.B I2CRK h r +smb Read Block Data: read data from register +.P +.B I2CWK h r bvs +smb Write Block Data: write data to register +.P +.B I2CWI h r bvs +smb Write I2C Block Data +.P +.B I2CRI h r num +smb Read I2C Block Data: read bytes from register +.P +.B I2CRD h num +i2c Read device +.P +.B I2CWD h bvs +i2c Write device +.P +.B I2CPC h r wv +smb Process Call: exchange register with word +.P +.B I2CPK h r bvs +smb Block Process Call: exchange data bytes with register +.P +.B I2CZ h bvs +Performs multiple I2C transactions +.P +.SS I2C BIT BANG +.B BI2CO sda scl b +Open bit bang I2C +.P +.B BI2CC sda +Close bit bang I2C +.P +.B BI2CZ sda bvs +I2C bit bang multiple transactions +.P +.SS I2C/SPI SLAVE +.B BSCX bctl bvs +BSC I2C/SPI transfer +.P +.SS SERIAL +.B SERO dev b sef +Open serial device dev at baud b with flags +.P +.B SERC h +Close serial handle +.P +.B SERRB +Read byte from serial handle +.P +.B SERWB h bv +Write byte to serial handle +.P +.B SERR h num +Read bytes from serial handle +.P +.B SERW h bvs +Write bytes to serial handle +.P +.B SERDA h +Check for serial data ready to read +.P +.SS SERIAL BIT BANG (read only) +.B SLRO u b db +Open GPIO for bit bang serial data +.P +.B SLRC u +Close GPIO for bit bang serial data +.P +.B SLRI u v +Sets bit bang serial data logic levels +.P +.B SLR u num +Read bit bang serial data from GPIO +.P +.SS SPI +.B SPIO c b spf +SPI open channel at baud b with flags +.P +.B SPIC h +SPI close handle +.P +.B SPIR h num +SPI read bytes from handle +.P +.B SPIW h bvs +SPI write bytes to handle +.P +.B SPIX h bvs +SPI transfer bytes to handle +.P +.SS SPI BIT BANG +.B BSPIO cs miso mosi sclk b spf +Open bit bang SPI +.P +.B BSPIC cs +Close bit bang SPI +.P +.B BSPIX cs bvs +SPI bit bang transfer +.P +.SS FILES +.B FO file mode +Open a file in mode +.P +.B FC h +Close file handle +.P +.B FR h num +Read bytes from file handle +.P +.B FW h bvs +Write bytes to file handle +.P +.B FS h num from +Seek to file handle position +.P +.B FL pat num +List files which match pattern +.P +.SS WAVES +.B WVCLR +Clear all waveforms +.P +.B WVNEW +Initialise a new waveform +.P +.B WVAG trips +Add generic pulses to waveform +.P +.B WVAS u b db sb o bvs +Add serial data to waveform +.P +.B WVCRE +Create a waveform +.P +.B WVCAP percent +Create a waveform of fixed size +.P +.B WVDEL wid +Delete selected waveform +.P +.B WVTX wid +Transmits waveform once +.P +.B WVTXM wid wmde +Transmits waveform using mode +.P +.B WVTXR wid +Transmits waveform repeatedly +.P +.B WVCHA bvs +Transmits a chain of waveforms +.P +.B WVTAT +Returns the current transmitting waveform +.P +.B WVBSY +Check if waveform is being transmitted +.P +.B WVHLT +Stop waveform +.P +.B WVSC ws +Get waveform DMA CB stats +.P +.B WVSM ws +Get waveform time stats +.P +.B WVSP ws +Get waveform pulse stats +.P +.SS UTILITIES +.B H/HELP +Display command help +.P +.B HWVER +Get hardware version +.P +.B MICS v +Microseconds delay +.P +.B MILS v +Milliseconds delay +.P +.B PIGPV +Get pigpio library version +.P +.B T/TICK +Get current tick +.P +.SS CONFIGURATION +.B CGI +Configuration get internals +.P +.B CSI v +Configuration set internals +.P + +.SH COMMANDS + +.br + +.IP "\fBBC1 bits\fP - Clear specified GPIO in bank 1" +.IP "" 4 +This command clears (sets low) the GPIO specified by \fBbits\fP in bank 1. +Bank 1 consists of GPIO 0-31. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bc1 0x400010 # clear GPIO 4 (1<<4) and 22 (1<<22) +.br + +.br +$ pigs bc1 32 # clear GPIO 5 (1<<5) +.br +-42 +.br +ERROR: no permission to update one or more GPIO +.br + +.EE + +.br + +.IP "\fBBC2 bits\fP - Clear specified GPIO in bank 2" +.IP "" 4 +This command clears (sets low) the GPIO specified by \fBbits\fP in bank 2. +Bank 2 consists of GPIO 32-53. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bc2 0x8000 # clear GPIO 47 (activity LED on A+/B+/Pi2/Pi3) +.br + +.br +$ pigs bc2 1 # clear GPIO 32 (first in bank 2) +.br +-42 +.br +ERROR: no permission to update one or more GPIO +.br + +.EE + +.br + +.IP "\fBBI2CC sda\fP - Close bit bang I2C" +.IP "" 4 +This command signals that bit banging I2C on \fBsda\fP (and \fBscl\fP) is no +longer required. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bi2cc 5 +.br + +.EE + +.br + +.IP "\fBBI2CO sda scl b\fP - Open bit bang I2C" +.IP "" 4 +This command signals that GPIO \fBsda\fP and \fBscl\fP are to be used +for bit banging I2C at \fBb\fP baud. + +.br +Bit banging I2C allows for certain operations which are not possible +with the standard I2C driver. + +.br +o baud rates as low as 50 +.br +o repeated starts +.br +o clock stretching +.br +o I2C on any pair of spare GPIO + +.br +The baud rate may be between 50 and 500000 bits per second. + +.br +The GPIO used for SDA and SCL must have pull-ups to 3V3 connected. As +a guide the hardware pull-ups on pins 3 and 5 are 1k8 in value. + +.br + +.IP "\fBBI2CZ sda bvs\fP - I2C bit bang multiple transactions" +.IP "" 4 +This function executes a sequence of bit banged I2C operations. The +operations to be performed are specified by the contents of \fBbvs\fP +which contains the concatenated command codes and associated data. + +.br +The following command codes are supported: + +.br + +.EX +Name Cmd & Data Meaning +End 0 No more commands +Escape 1 Next P is two bytes +Start 2 Start condition +Stop 3 Stop condition +Address 4 P Set I2C address to P +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +Read 6 P Read P bytes of data +Write 7 P ... Write P bytes of data + +.EE + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br +The address and flags default to 0. The address and flags maintain +their previous value until updated. + +.br +No flags are currently defined. + +.br + +\fBExample\fP +.br + +.EX +Set address 0x53 +.br +start, write 0x32, (re)start, read 6 bytes, stop +.br +Set address 0x1E +.br +start, write 0x03, (re)start, read 6 bytes, stop +.br +Set address 0x68 +.br +start, write 0x1B, (re)start, read 8 bytes, stop +.br +End +.br + +.br +0x04 0x53 +.br +0x02 0x07 0x01 0x32 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x1E +.br +0x02 0x07 0x01 0x03 0x02 0x06 0x06 0x03 +.br + +.br +0x04 0x68 +.br +0x02 0x07 0x01 0x1B 0x02 0x06 0x08 0x03 +.br + +.br +0x00 +.br + +.EE + +.br + +.IP "\fBBR1 \fP - Read bank 1 GPIO" +.IP "" 4 +This command read GPIO 0-31 (bank 1) and returns the levels as a +32-bit hexadecimal value. + +.br + +\fBExample\fP +.br + +.EX +$ pigs br1 +.br +1001C1CF +.br + +.EE + +.br + +.IP "\fBBR2 \fP - Read bank 2 GPIO" +.IP "" 4 +This command read GPIO 32-53 (bank 2) and returns the levels as a +32-bit hexadecimal value. + +.br + +\fBExample\fP +.br + +.EX +$ pigs br2 +.br +003F0000 +.br + +.EE + +.br + +.IP "\fBBS1 bits\fP - Set specified GPIO in bank 1" +.IP "" 4 +This command sets (sets high) the GPIO specified by \fBbits\fP in bank 1. +Bank 1 consists of GPIO 0-31. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bs1 16 # set GPIO 4 (1<<4) +.br + +.br +$ pigs bs1 1 # set GPIO 1 (1<<0) +.br +-42 +.br +ERROR: no permission to update one or more GPIO +.br + +.EE + +.br + +.IP "\fBBS2 bits\fP - Set specified GPIO in bank 2" +.IP "" 4 +This command sets (sets high) the GPIO specified by \fBbits\fP in bank 2. +Bank 2 consists of GPIO 32-53. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bs2 0x40 # set GPIO 38 (enable high current mode A+/B+/Pi2/Pi3) +.br + +.br +$ pigs bs2 1 # set GPIO 32 (first in bank 2) +.br +-42 +.br +ERROR: no permission to update one or more GPIO +.br + +.EE + +.br + +.IP "\fBBSCX bctl bvs\fP - BSC I2C/SPI transfer" +.IP "" 4 + +.br +This command performs a BSC I2C/SPI slave transfer as defined by +\fBbctl\fP with data \fBbvs\fP. + +.br +This function provides a low-level interface to the SPI/I2C Slave +peripheral on the BCM chip. + +.br +This peripheral allows the Pi to act as a hardware slave device +on an I2C or SPI bus. + +.br +This is not a bit bang version and as such is OS timing +independent. The bus timing is handled directly by the chip. + +.br +The output process is simple. You simply append data to the FIFO +buffer on the chip. This works like a queue, you add data to the +queue and the master removes it. + +.br +The command sets the BSC mode and writes any data \fBbvs\fP +to the BSC transmit FIFO. It returns the data count (at least 1 +for the status word), the status word, followed by any data bytes +read from the BSC receive FIFO. + +.br +Note that the control word sets the BSC mode. The BSC will stay in +that mode until a different control word is sent. + +.br +For I2C use a control word of (I2C address << 16) + 0x305. + +.br +E.g. to talk as I2C slave with address 0x13 use 0x130305. + +.br +GPIO used for models other than those based on the BCM2711. + +.br + +.EX + SDA SCL MOSI SCLK MISO CE +I2C 18 19 - - - - +SPI - - 20 19 18 21 + +.EE + +.br +GPIO used for models based on the BCM2711 (e.g. the Pi4B). + +.br + +.EX + SDA SCL MOSI SCLK MISO CE +I2C 10 11 - - - - +SPI - - 9 11 10 8 + +.EE + +.br +When a zero control word is received the used GPIO will be reset +to INPUT mode. + +.br +The control word consists of the following bits. + +.br + +.EX +22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + a a a a a a a - - IT HC TF IR RE TE BK EC ES PL PH I2 SP EN +.br + +.EE + +.br +Bits 0-13 are copied unchanged to the BSC CR register. See +pages 163-165 of the Broadcom peripherals document for full +details. + +.br + +.EX +aaaaaaa defines the I2C slave address (only relevant in I2C mode) +IT invert transmit status flags +HC enable host control +TF enable test FIFO +IR invert receive status flags +RE enable receive +TE enable transmit +BK abort operation and clear FIFOs +EC send control register as first I2C byte +ES send status register as first I2C byte +PL set SPI polarity high +PH set SPI phase high +I2 enable I2C mode +SP enable SPI mode +EN enable BSC peripheral + +.EE + +.br +The returned status has the following format + +.br + +.EX +20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + S S S S S R R R R R T T T T T RB TE RF TF RE TB +.br + +.EE + +.br +Bits 0-15 are copied unchanged from the BSC FR register. See +pages 165-166 of the Broadcom peripherals document for full +details. + +.br + +.EX +SSSSS number of bytes successfully copied to transmit FIFO +RRRRR number of bytes in receieve FIFO +TTTTT number of bytes in transmit FIFO +RB receive busy +TE transmit FIFO empty +RF receive FIFO full +TF transmit FIFO full +RE receive FIFO empty +TB transmit busy + +.EE + +.br +This example assumes that GPIO 2/3 are connected to GPIO 18/19 +(GPIO 10/11 on the BCM2711). + +.br + +\fBExample\fP +.br + +.EX +$ pigs bscx 0x130305 # start BSC as I2C slave 0x13 +.br +1 18 +.br + +.br +$ i2cdetect -y 1 +.br + 0 1 2 3 4 5 6 7 8 9 a b c d e f +.br +00: -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +10: -- -- -- 13 -- -- -- -- -- -- -- -- -- -- -- -- +.br +20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- +.br +70: -- -- -- -- -- -- -- -- +.br + +.br +$ pigs i2co 1 0x13 0 # get handle for device 0x13 on bus 1 +.br +0 +.br + +.br +$ pigs i2cwd 0 90 87 51 9 23 # write 5 bytes +.br + +.br +$ pigs bscx 0x130305 # check for data +.br +6 18 90 87 51 9 23 +.br + +.br +$ pigs bscx 0x130305 11 13 15 17 # check for data and send 4 bytes +.br +1 262338 +.br + +.br +$ pigs i2crd 0 4 # read 4 bytes +.br +4 11 13 15 17 +.br + +.br +$ pigs i2cwd 0 90 87 51 9 23 # write 5 bytes +.br +$ pigs bscx 0x130305 11 13 15 17 # check for data and send 4 bytes +.br +6 262338 90 87 51 9 23 +.br + +.br +$ pigs i2crd 0 4 +.br +4 11 13 15 17 +.br + +.br +$ pigs bscx 0x130305 22 33 44 55 66 +.br +1 327938 +.br +$ pigs i2crd 0 5 +.br +5 22 33 44 55 66 +.br + +.EE + +.br +The BSC slave in SPI mode deserializes data from the MOSI pin into its receiver/ +FIFO when the LSB of the first byte is a 0. No data is output on the MISO pin. +When the LSB of the first byte on MOSI is a 1, the transmitter/FIFO data is +serialized onto the MISO pin while all other data on the MOSI pin is ignored. + +.br +The BK bit of the BSC control register is non-functional when in the SPI mode. +The transmitter along with its FIFO can be dequeued by successively disabling +and re-enabling the TE bit on the BSC control register while in SPI mode. + +.br +This example demonstrates a SPI master talking to the BSC as SPI slave: +Requires SPI master SCLK / MOSI / MISO / CE GPIO are connected to +BSC peripheral GPIO 11 / 9 / 10 / 8 respectively, on a Pi4B (BCM2711). + +.br + +\fBExample\fP +.br + +.EX +$ pigs bspio 15 26 13 14 10000 0 # open bit-bang spi master on random gpio +.br + +.br +$ pigs bscx 0x303 # start BSC as SPI slave, both rx and tx enabled +.br +1 18 +.br + +.br +$ pigs bspix 15 0 0xd 0xe 0xa 0xd # write 0xdead to BSC +.br +5 0 0 0 0 0 +.br + +.br +$ pigs bscx 0x303 0xb 0xe 0xe 0xf # place 0xbeef in BSC tx FIFO, read rx FIFO +.br +5 262338 13 14 10 13 +.br + +.br +$ pigs bspix 15 1 0 0 0 0 # read four bytes from BSC +.br +5 0 11 14 14 15 +.br + +.EE + +.br + +.IP "\fBBSPIC cs\fP - Close bit bang SPI" +.IP "" 4 + +.br +This command stops bit banging SPI on a set of GPIO +opened with \fBBSPIO\fP. + +.br +The set of GPIO is specifed by \fBcs\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bspic 10 +.br + +.br +$ pigs bspic 10 +.br +-142 +.br +ERROR: no bit bang SPI in progress on GPIO +.br + +.EE + +.br + +.IP "\fBBSPIO cs miso mosi sclk b spf\fP - Open bit bang SPI" +.IP "" 4 + +.br +This command starts bit banging SPI on a group of GPIO with slave +select \fBcs\fP, MISO \fBmiso\fP, MOSI \fBmosi\fP, and clock \fBsclk\fP. + +.br +Data will be transferred at baud \fBb\fP bits per second (which may +be set in the range 50-250000). + +.br +The flags \fBspf\fP may be used to modify the default behaviour of +mode 0, active low chip select. + +.br +The flags consists of the least significant 22 bits. + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + 0 0 0 0 0 0 R T 0 0 0 0 0 0 0 0 0 0 0 p m m +.br + +.EE + +.br +mm defines the SPI mode. + +.br + +.EX +Mode POL PHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br +p is 0 if CS is active low (default) and 1 for active high. + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. + +.br +The other bits in flags should be set to zero. + +.br +Upon success 0 is returned. On error a negative status code +will be returned. + +.br +If more than one device is connected to the SPI bus (defined by +SCLK, MOSI, and MISO) each must have its own CS. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bspio 9 11 12 13 50000 0 +.br + +.br +$ pigs bspio 10 11 12 13 50000 0 +.br + +.br +$ pigs bspio 29 19 20 21 50000 0 # GPIO 29 not avaialble on this Pi +.br +-41 +.br +ERROR: no permission to update GPIO +.br + +.EE + +.br + +.IP "\fBBSPIX cs bvs\fP - SPI bit bang transfer" +.IP "" 4 + +.br +This command writes bytes \fBbvs\fP to the bit bang SPI device +associated with slave select \fBcs\fP. It returns the same +number of bytes read from the device. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs bspio 5 13 19 12 10000 0 # MCP4251 DAC +.br +$ pigs bspio 6 13 19 12 20000 3 # MCP3008 ADC +.br + +.br +$ pigs bspix 5 0 16 # set DAC to 16 +.br +2 255 255 +.br + +.br +$ pigs bspix 5 12 0 # read back DAC +.br +2 254 16 +.br + +.br +$ pigs bspix 6 1 128 0 # read ADC input 0 +.br +3 0 3 184 # 952 +.br + +.br +$ pigs bspix 5 0 240 # set DAC to 240 +.br +2 255 255 +.br + +.br +$ pigs bspix 5 12 0 # read back DAC +.br +2 254 240 +.br + +.br +$ pigs bspix 6 1 128 0 # read ADC input 0 +.br +3 0 0 63 # 63 +.br + +.br +$ pigs bspix 5 0 128 # set DAC to 128 +.br +2 255 255 +.br + +.br +$ pigs bspix 5 12 0 # read back DAC +.br +2 254 128 +.br + +.br +$ pigs bspix 6 1 128 0 # read ADC input 0 +.br +3 0 1 255 # 511 +.br + +.br +$ pigs bspic 5 # close SPI CS 5 +.br +$ pigs bspic 6 # close SPI CS 6 +.br + +.br +$ pigs bspic 5 # try to close SPI CS 5 again +.br +-142 +.br +ERROR: no bit bang SPI in progress on GPIO +.br + +.EE + +.br + +.br + +.IP "\fBCF1 uvs\fP - Custom function 1" +.IP "" 4 + +.br +This command calls a user customised function. The meaning of +any paramaters and the returned value is defined by the +customiser. + +.br + +.IP "\fBCF2 uvs\fP - Custom function 2" +.IP "" 4 + +.br +This command calls a user customised function. The meaning of +any paramaters and the returned value is defined by the +customiser. + +.br + +.IP "\fBCGI \fP - Configuration get internals" +.IP "" 4 +This command returns the value of the internal library +configuration settings. + +.br + +.IP "\fBCSI v\fP - Configuration set internals" +.IP "" 4 +This command sets the value of the internal library +configuration settings to \fBv\fP. + +.br + +.IP "\fBEVM h bits\fP - Set events to monitor" +.IP "" 4 +This command starts event reporting on handle \fBh\fP (returned by +a prior call to \fBNO\fP). + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The notification gets reports for each event specified by \fBbits\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs evm 0 -1 # Shorthand for events 0-31. +.br +$ pigs evm 0 0xf0 # Get notifications for events 4-7. +.br + +.br +$ pigs evm 1 0xf +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBEVT event\fP - Trigger event" +.IP "" 4 +This command triggers event \fBevent\fP. + +.br +One event, number 31, is predefined. This event is +auto generated on BSC slave activity. + +.br + +\fBExample\fP +.br + +.EX +$ pigs evt 12 +.br +$ pigs evt 5 +.br + +.br +$ pigs evt 32 +.br +-143 +.br +ERROR: bad event id +.br + +.EE + +.br + +.IP "\fBFC h\fP - Close file handle" +.IP "" 4 +This command closes a file handle \fBh\fP previously opened with \fBFO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fc 0 # First close okay. +.br + +.br +$ pigs fc 0 # Second fails. +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBFG u stdy\fP - Set a glitch filter on a GPIO" +.IP "" 4 + +.br +Level changes on the GPIO \fBu\fP are not reported unless the level +has been stable for at least \fBstdy\fP microseconds. The +level is then reported. Level changes of less than \fBstdy\fP +microseconds are ignored. + +.br +The filter only affects callbacks (including pipe notifications). + +.br +The \fBR/READ\fP, \fBBR1\fP, and \fBBR2\fP commands are not affected. + +.br +Note, each (stable) edge will be timestamped \fBstdy\fP microseconds +after it was first detected. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fg 4 250 +.br + +.br +$ pigs fg 4 1000000 +.br +-125 +.br +ERROR: bad filter parameter +.br + +.EE + +.br + +.IP "\fBFL pat num\fP - List files which match pattern" +.IP "" 4 +This command returns a list of the files matching \fBpat\fP. Up +to \fBnum\fP bytes may be returned. + +.br +Upon success the count of returned bytes followed by the matching +files is returned. On error a negative status code will be returned. + +.br +A newline (0x0a) character separates each file name. + +.br +Only files which have a matching entry in /opt/pigpio/access may +be listed. + +.br +Suppose /opt/pigpio/access contains + +.br +/sys/bus/w1/devices/28*/w1_slave r + +.br + +\fBExample\fP +.br + +.EX +$ pigs -a fl "/sys/bus/w1/devices/28*/w1_slave" 5000 +.br +90 /sys/bus/w1/devices/28-000005d34cd2/w1_slave +.br +/sys/bus/w1/devices/28-001414abbeff/w1_slave +.br + +.br +$ pigs -a fl "/sys/bus/*" 5000 +.br +ERROR: no permission to access file +.br +-137 +.br + +.EE + +.br + +.IP "\fBFN u stdy actv\fP - Set a noise filter on a GPIO" +.IP "" 4 + +.br +Level changes on the GPIO \fBu\fP are ignored until a level which has +been stable for \fBstdy\fP microseconds is detected. Level +changes on the GPIO are then reported for \fBactv\fP microseconds +after which the process repeats. + +.br +The filter only affects callbacks (including pipe notifications). + +.br +The \fBR/READ\fP, \fBBR1\fP, and \fBBR2\fP commands are not affected. + +.br +Note, level changes before and after the active period may +be reported. Your software must be designed to cope with +such reports. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fn 7 250 1000 +.br + +.br +$ pigs fn 7 2500000 1000 +.br +-125 +.br +ERROR: bad filter parameter +.br + +.EE + +.br + +.IP "\fBFO file mode\fP - Open a file in mode" +.IP "" 4 +This function returns a handle to a file \fBfile\fP opened +in a specified mode \fBmode\fP. + +.br +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +.br +File + +.br +A file may only be opened if permission is granted by an entry in +/opt/pigpio/access. This is intended to allow remote access to files +in a more or less controlled manner. + +.br +Each entry in /opt/pigpio/access takes the form of a file path +which may contain wildcards followed by a single letter permission. +The permission may be R for read, W for write, U for read/write, +and N for no access. + +.br +Where more than one entry matches a file the most specific rule +applies. If no entry matches a file then access is denied. + +.br +Suppose /opt/pigpio/access contains the following entries + +.br + +.EX +/home/* n +.br +/home/pi/shared/dir_1/* w +.br +/home/pi/shared/dir_2/* r +.br +/home/pi/shared/dir_3/* u +.br +/home/pi/shared/dir_1/file.txt n +.br + +.EE + +.br +Files may be written in directory dir_1 with the exception +of file.txt. + +.br +Files may be read in directory dir_2. + +.br +Files may be read and written in directory dir_3. + +.br +If a directory allows read, write, or read/write access then files may +be created in that directory. + +.br +In an attempt to prevent risky permissions the following paths are +ignored in /opt/pigpio/access. + +.br + +.EX +a path containing .. +.br +a path containing only wildcards (*?) +.br +a path containing less than two non-wildcard parts +.br + +.EE + +.br +Mode + +.br +The mode may have the following values. + +.br + +.EX + Value Meaning +READ 1 open file for reading +WRITE 2 open file for writing +RW 3 open file for reading and writing + +.EE + +.br +The following values may be or'd into the mode. + +.br + +.EX + Value Meaning +APPEND 4 All writes append data to the end of the file +CREATE 8 The file is created if it doesn't exist +TRUNC 16 The file is truncated + +.EE + +.br +Newly created files are owned by root with permissions owner read and write. + +.br + +\fBExample\fP +.br + +.EX +$ ls /ram/*.c +.br +/ram/command.c /ram/pigpiod.c /ram/pigs.c +.br +/ram/x_pigpiod_if.c /ram/pig2vcd.c /ram/pigpiod_if2.c +.br +/ram/x_pigpio.c /ram/x_repeat.c /ram/pigpio.c +.br +/ram/pigpiod_if.c /ram/x_pigpiod_if2.c +.br + +.br +# assumes /opt/pigpio/access contains the following line +.br +# /ram/*.c r +.br + +.br +$ pigs fo /ram/pigpio.c 1 +.br +0 +.br + +.br +$ pigs fo /ram/new.c 1 +.br +-128 +.br +ERROR: file open failed +.br + +.br +$ pigs fo /ram/new.c 9 +.br +1 +.br + +.br +$ ls /ram/*.c -l +.br +-rw-r--r-- 1 joan joan 42923 Jul 10 11:22 /ram/command.c +.br +-rw------- 1 root root 0 Jul 10 16:54 /ram/new.c +.br +-rw-r--r-- 1 joan joan 2971 Jul 10 11:22 /ram/pig2vcd.c +.br +-rw------- 1 joan joan 296235 Jul 10 11:22 /ram/pigpio.c +.br +-rw-r--r-- 1 joan joan 9266 Jul 10 11:22 /ram/pigpiod.c +.br +-rw-r--r-- 1 joan joan 37331 Jul 10 11:22 /ram/pigpiod_if2.c +.br +-rw-r--r-- 1 joan joan 33088 Jul 10 11:22 /ram/pigpiod_if.c +.br +-rw-r--r-- 1 joan joan 7990 Jul 10 11:22 /ram/pigs.c +.br +-rw-r--r-- 1 joan joan 19970 Jul 10 11:22 /ram/x_pigpio.c +.br +-rw-r--r-- 1 joan joan 20804 Jul 10 11:22 /ram/x_pigpiod_if2.c +.br +-rw-r--r-- 1 joan joan 19844 Jul 10 11:22 /ram/x_pigpiod_if.c +.br +-rw-r--r-- 1 joan joan 19907 Jul 10 11:22 /ram/x_repeat.c +.br + +.EE + +.br + +.IP "\fBFR h num\fP - Read bytes from file handle" +.IP "" 4 +This command returns up to \fBnum\fP bytes of data read from the +file associated with handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fr 0 10 +.br +5 48 49 128 144 255 +.br + +.br +$ pigs fr 0 10 +.br +0 +.br + +.EE + +.br + +.IP "\fBFS h num from\fP - Seek to file handle position" +.IP "" 4 +This command seeks to a position within the file associated +with handle \fBh\fP. + +.br +The number of bytes to move is \fBnum\fP. Positive offsets +move forward, negative offsets backwards. The move start +position is determined by \fBfrom\fP as follows. + +.br + +.EX + From +0 start +1 current position +2 end + +.EE + +.br +Upon success the new byte position within the file (>=0) is +returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fs 0 200 0 # Seek to start of file plus 200 +.br +200 +.br + +.br +$ pigs fs 0 0 1 # Return current position +.br +200 +.br + +.br +$ pigs fs 0 0 2 # Seek to end of file, return size +.br +296235 +.br + +.EE + +.br + +.IP "\fBFW h bvs\fP - Write bytes to file handle" +.IP "" 4 +This command writes bytes \fBbvs\fP to the file +associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs fw 0 23 45 67 89 +.br + +.EE + +.br + +.IP "\fBGDC u\fP - Get GPIO PWM dutycycle" +.IP "" 4 + +.br +This command returns the PWM dutycycle in use on GPIO \fBu\fP. + +.br +Upon success the dutycycle is returned. On error a negative +status code will be returned. + +.br +For normal PWM the dutycycle will be out of the defined range +for the GPIO (see \fBPRG\fP). + +.br +If a hardware clock is active on the GPIO the reported +dutycycle will be 500000 (500k) out of 1000000 (1M). + +.br +If hardware PWM is active on the GPIO the reported dutycycle +will be out of a 1000000 (1M). + +.br + +\fBExample\fP +.br + +.EX +$ pigs p 4 129 +.br +$ pigs gdc 4 +.br +129 +.br + +.br +pigs gdc 5 +.br +-92 +.br +ERROR: GPIO is not in use for PWM +.br + +.EE + +.br + +.IP "\fBGPW u\fP - Get GPIO servo pulsewidth" +.IP "" 4 + +.br +This command returns the servo pulsewidth in use on GPIO \fBu\fP. + +.br +Upon success the servo pulsewidth is returned. On error a negative +status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs s 4 1235 +.br +$ pigs gpw 4 +.br +1235 +.br + +.br +$ pigs gpw 9 +.br +-93 +.br +ERROR: GPIO is not in use for servo pulses +.br + +.EE + +.br + +.IP "\fBH/HELP \fP - Display command help" +.IP "" 4 +This command displays a brief list of the commands and their parameters. + +.br + +\fBExample\fP +.br + +.EX +$ pigs h +.br + +.br +$ pigs help +.br + +.EE + +.br + +.IP "\fBHC g cf\fP - Set hardware clock frequency" +.IP "" 4 +This command sets the hardware clock associated with GPIO \fBg\fP to +frequency \fBcf\fP. Frequencies above 30MHz are unlikely to work. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs hc 4 5000 # start a 5 KHz clock on GPIO 4 (clock 0) +.br + +.br +$ pigs hc 5 5000000 # start a 5 MHz clcok on GPIO 5 (clock 1) +.br +-99 +.br +ERROR: need password to use hardware clock 1 +.br + +.EE + +.br +The same clock is available on multiple GPIO. The latest +frequency setting will be used by all GPIO which share a clock. + +.br +The GPIO must be one of the following. + +.br + +.EX +4 clock 0 All models +5 clock 1 All models but A and B (reserved for system use) +6 clock 2 All models but A and B +20 clock 0 All models but A and B +21 clock 1 All models but A and B Rev.2 (reserved for system use) + +.EE + +.br + +.EX +32 clock 0 Compute module only +34 clock 0 Compute module only +42 clock 1 Compute module only (reserved for system use) +43 clock 2 Compute module only +44 clock 1 Compute module only (reserved for system use) + +.EE + +.br +Access to clock 1 is protected by a password as its use will +likely crash the Pi. The password is given by or'ing 0x5A000000 +with the GPIO number. + +.br + +.IP "\fBHP g pf pdc\fP - Set hardware PWM frequency and dutycycle" +.IP "" 4 +This command sets the hardware PWM associated with GPIO \fBg\fP to +frequency \fBpf\fP with dutycycle \fBpdc\fP. Frequencies above 30MHz +are unlikely to work. + +.br +NOTE: Any waveform started by \fBWVTX\fP, \fBWVTXR\fP, or \fBWVCHA\fP +will be cancelled. + +.br +This function is only valid if the pigpio main clock is PCM. The +main clock defaults to PCM but may be overridden when the pigpio +daemon is started (option -t). + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +.EX +$ pigs hp 18 100 800000 # 80% dutycycle +.br + +.br +$ pigs hp 19 100 200000 # 20% dutycycle +.br + +.br +$ pigs hp 19 400000000 100000 +.br +-96 +.br +ERROR: invalid hardware PWM frequency +.br + +.EE + +.br +The same PWM channel is available on multiple GPIO. The latest +frequency and dutycycle setting will be used by all GPIO which +share a PWM channel. + +.br +The GPIO must be one of the following. + +.br + +.EX +12 PWM channel 0 All models but A and B +13 PWM channel 1 All models but A and B +18 PWM channel 0 All models +19 PWM channel 1 All models but A and B + +.EE + +.br + +.EX +40 PWM channel 0 Compute module only +41 PWM channel 1 Compute module only +45 PWM channel 1 Compute module only +52 PWM channel 0 Compute module only +53 PWM channel 1 Compute module only + +.EE + +.br +The actual number of steps beween off and fully on is the +integral part of 250M/\fBpf\fP (375M/\fBpf\fP for the BCM2711). + +.br +The actual frequency set is 250M/steps (375M/steps for the BCM2711). + +.br +There will only be a million steps for a \fBpf\fP of 250 (375 for +the BCM2711). Lower frequencies will have more steps and higher +frequencies will have fewer steps. \fBpdc\fP is +automatically scaled to take this into account. + +.br + +.IP "\fBHWVER \fP - Get hardware version" +.IP "" 4 +This command returns the hardware revision of the Pi. + +.br +The hardware revision is found in the last 4 characters on the revision +line of /proc/cpuinfo. + +.br +If the hardware revision can not be found or is not a valid hexadecimal +number the command returns 0. + +.br +The revision number can be used to determine the assignment of GPIO +to pins (see \fBg\fP). + +.br +There are currently three types of board. + +.br +Type 1 boards have hardware revision numbers of 2 and 3. + +.br +Type 2 boards have hardware revision numbers of 4, 5, 6, and 15. + +.br +Type 3 boards have hardware revision numbers of 16 or greater. + +.br +for "Revision : 0002" the command returns 2. + +.br +for "Revision : 000f" the command returns 15. + +.br +for "Revision : 000g" the command returns 0. + +.br + +\fBExample\fP +.br + +.EX +$ pigs hwver # On a B+ +.br +16 +.br + +.EE + +.br + +.IP "\fBI2CC h\fP - Close I2C handle" +.IP "" 4 +This command closes an I2C handle \fBh\fP previously opened with \fBI2CO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cc 0 # First close okay. +.br + +.br +$ pigs i2cc 0 # Second fails. +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBI2CO ib id if\fP - Open I2C bus and device with flags" +.IP "" 4 +This command returns a handle to access device \fBid\fP on I2C bus \fBib\fP. +The device is opened with flags \fBif\fP. + +.br +Physically buses 0 and 1 are available on the Pi. Higher +numbered buses will be available if a kernel supported bus +multiplexor is being used. + +.br +The GPIO used are given in the following table. + +.br + +.EX + SDA SCL +I2C 0 0 1 +I2C 1 2 3 + +.EE + +.br +No flags are currently defined. The parameter \fBif\fP should be 0. + +.br +Upon success the next free handle (>=0) is returned. On error a +negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2co 1 0x70 0 # Bus 1, device 0x70, flags 0. +.br +0 +.br + +.br +$ pigs i2co 1 0x53 0 # Bus 1, device 0x53, flags 0. +.br +1 +.br + +.EE + +.br + +.IP "\fBI2CPC h r wv\fP - smb Process Call: exchange register with word" +.IP "" 4 +This command writes \fBwv\fP to register \fBr\fP of the I2C device +associated with handle \fBh\fP and returns a 16-bit word read from the +device. + +.br +Upon success a value between 0 and 65535 will be returned. On error +a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cpc 0 37 43210 +.br +39933 +.br + +.br +$ pigs i2cpc 0 256 43210 +.br +ERROR: bad i2c/spi/ser parameter +.br +-81 +.br + +.EE + +.br + +.IP "\fBI2CPK h r bvs\fP - smb Block Process Call: exchange data bytes with register" +.IP "" 4 + +.br +This command writes the data bytes \fBbvs\fP to register \fBr\fP of the I2C device +associated with handle \fBh\fP and returns a device specific number of bytes. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cpk 0 0 0x11 0x12 +.br +6 0 0 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBI2CRB h r\fP - smb Read Byte Data: read byte from register" +.IP "" 4 + +.br +This command returns a single byte read from register \fBr\fP of the I2C device +associated with handle \fBh\fP. + +.br +Upon success a value between 0 and 255 will be returned. On error +a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2crb 0 0 +.br +6 +.br + +.EE + +.br + +.IP "\fBI2CRD h num\fP - i2c Read device" +.IP "" 4 + +.br +This command returns \fBnum\fP bytes read from the I2C device associated with +handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br +This command operates on the raw I2C device. The maximum value of the +parameter \fBnum\fP is dependent on the I2C drivers and the device +itself. pigs imposes a limit of about 8000 bytes. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2crd 0 16 +.br +16 6 24 0 0 0 0 0 0 0 0 0 0 0 0 32 78 +.br + +.EE + +.br + +.IP "\fBI2CRI h r num\fP - smb Read I2C Block Data: read bytes from register" +.IP "" 4 + +.br +This command returns \fBnum\fP bytes from register \fBr\fP of the I2C device +associated with handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br +The parameter \fBnum\fP may be 1-32. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cri 0 0 16 +.br +16 237 155 155 155 155 155 155 155 155 155 155 155 155 155 155 155 +.br + +.EE + +.br + +.IP "\fBI2CRK h r\fP - smb Read Block Data: read data from register" +.IP "" 4 + +.br +This command returns between 1 and 32 bytes read from register \fBr\fP of +the I2C device associated with handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br +The number of bytes of returned data is specific to the device and +register. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2crk 0 0 +.br +6 0 0 0 0 0 0 +.br + +.br +$ pigs i2crk 0 1 +.br +24 0 0 0 0 0 0 0 0 0 0 0 0 120 222 105 215 128 87 195 217 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBI2CRS h\fP - smb Read Byte: read byte" +.IP "" 4 + +.br +This command returns a single byte read from the I2C device +associated with handle \fBh\fP. + +.br +Upon success a value between 0 and 255 will be returned. On error +a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2crs 0 +.br +0 +.br + +.EE + +.br + +.IP "\fBI2CRW h r\fP - smb Read Word Data: read word from register" +.IP "" 4 + +.br +This command returns a single 16 bit word read from register \fBr\fP of +the I2C device associated with handle \fBh\fP. + +.br +Upon success a value between 0 and 65535 will be returned. On error +a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2crw 0 0 +.br +6150 +.br + +.EE + +.br + +.IP "\fBI2CWB h r bv\fP - smb Write Byte Data: write byte to register" +.IP "" 4 + +.br +This command writes a single byte \fBbv\fP to register \fBr\fP of the +I2C device associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cwb 0 10 0x54 +.br + +.EE + +.br + +.IP "\fBI2CWD h bvs\fP - i2c Write device" +.IP "" 4 + +.br +This command writes a block of bytes \fBbvs\fP to the I2C device +associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The number of bytes which may be written in one transaction is +dependent on the I2C drivers and the device itself. pigs imposes +a limit of about 500 bytes. + +.br +This command operates on the raw I2C device. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cwd 0 0x01 0x02 0x03 0x04 +.br + +.EE + +.br + +.IP "\fBI2CWI h r bvs\fP - smb Write I2C Block Data" +.IP "" 4 + +.br +This command writes between 1 and 32 bytes \fBbvs\fP to register \fBr\fP of +the I2C device associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cwi 0 4 0x01 0x04 0xc0 +.br + +.EE + +.br + +.IP "\fBI2CWK h r bvs\fP - smb Write Block Data: write data to register" +.IP "" 4 + +.br +This command writes between 1 and 32 bytes \fBbvs\fP to register \fBr\fP of +the I2C device associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +pigs i2cwk 0 4 0x01 0x04 0xc0 +.br + +.EE + +.br + +.IP "\fBI2CWQ h bit\fP - smb Write Quick: write bit" +.IP "" 4 + +.br +This command writes a single \fBbit\fP to the I2C device associated +with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cwq 0 1 +.br + +.EE + +.br + +.IP "\fBI2CWS h bv\fP - smb Write Byte: write byte" +.IP "" 4 + +.br +This command writes a single byte \fBbv\fP to the I2C device associated +with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cws 0 0x12 +.br + +.br +$ pigs i2cws 0 0xff +.br +-82 +.br +ERROR: I2C write failed +.br + +.EE + +.br + +.IP "\fBI2CWW h r wv\fP - smb Write Word Data: write word to register" +.IP "" 4 + +.br +This command writes a single 16 bit word \fBwv\fP to register \fBr\fP of +the I2C device associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs i2cww 0 0 0xffff +.br + +.EE + +.br + +.IP "\fBI2CZ h bvs\fP - Performs multiple I2C transactions" +.IP "" 4 +This command executes a sequence of I2C operations. The +operations to be performed are specified by the contents of \fBbvs\fP +which contains the concatenated command codes and associated data. + +.br +The following command codes are supported: + +.br + +.EX +Name Cmd & Data Meaning +End 0 No more commands +Escape 1 Next P is two bytes +On 2 Switch combined flag on +Off 3 Switch combined flag off +Address 4 P Set I2C address to P +Flags 5 lsb msb Set I2C flags to lsb + (msb << 8) +Read 6 P Read P bytes of data +Write 7 P ... Write P bytes of data + +.EE + +.br +The address, read, and write commands take a parameter P. +Normally P is one byte (0-255). If the command is preceded by +the Escape command then P is two bytes (0-65535, least significant +byte first). + +.br +The address defaults to that associated with the handle \fBh\fP. +The flags default to 0. The address and flags maintain their +previous value until updated. + +.br + +\fBExample\fP +.br + +.EX +Set address 0x53, write 0x32, read 6 bytes +.br +Set address 0x1E, write 0x03, read 6 bytes +.br +Set address 0x68, write 0x1B, read 8 bytes +.br +End +.br + +.br +0x04 0x53 0x07 0x01 0x32 0x06 0x06 +.br +0x04 0x1E 0x07 0x01 0x03 0x06 0x06 +.br +0x04 0x68 0x07 0x01 0x1B 0x06 0x08 +.br +0x00 +.br + +.EE + +.br + +.br + +.IP "\fBM/MODES g m\fP - Set GPIO mode" +.IP "" 4 + +.br +This command sets GPIO \fBg\fP to mode \fBm\fP, typically input (read) +or output (write). + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +Each GPIO can be configured to be in one of 8 different modes. The modes +are named Input, Output, ALT0, ALT1, ALT2, ALT3, ALT4, and ALT5. + +.br +To set the mode use the code for the mode. + +.br + +.EX +Mode Input Output ALT0 ALT1 ALT2 ALT3 ALT4 ALT5 +Code R W 0 1 2 3 4 5 + +.EE + +.br + +\fBExample\fP +.br + +.EX +$ pigs m 4 r # Input (read) +.br +$ pigs m 4 w # Output (write) +.br +$ pigs m 4 0 # ALT 0 +.br +$ pigs m 4 5 # ALT 5 +.br + +.EE + +.br + +.IP "\fBMG/MODEG g\fP - Get GPIO mode" +.IP "" 4 + +.br +This command returns the current mode of GPIO \fBg\fP. + +.br +Upon success the value of the GPIO mode is returned. +On error a negative status code will be returned. + +.br + +.EX +Value 0 1 2 3 4 5 6 7 +Mode Input Output ALT5 ALT4 ALT0 ALT1 ALT2 ALT3 + +.EE + +.br + +\fBExample\fP +.br + +.EX +$ pigs mg 4 +.br +1 +.br + +.EE + +.br + +.IP "\fBMICS v\fP - Microseconds delay" +.IP "" 4 +This command delays execution for \fBv\fP microseconds. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The main use of this command is expected to be within \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs mics 20 # Delay 20 microseconds. +.br +$ pigs mics 1000000 # Delay 1 second. +.br + +.br +$ pigs mics 2000000 +.br +-64 +.br +ERROR: bad MICS delay (too large) +.br + +.EE + +.br + +.IP "\fBMILS v\fP - Milliseconds delay" +.IP "" 4 + +.br +This command delays execution for \fBv\fP milliseconds. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs mils 2000 # Delay 2 seconds. +.br + +.br +$ pigs mils 61000 +.br +-65 +.br +ERROR: bad MILS delay (too large) +.br + +.EE + +.br + +.IP "\fBNB h bits\fP - Start notification" +.IP "" 4 + +.br +This command starts notifications on handle \fBh\fP returned by +a prior call to \fBNO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The notification gets state changes for each GPIO specified by \fBbits\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs nb 0 -1 # Shorthand for GPIO 0-31. +.br +$ pigs nb 0 0xf0 # Get notifications for GPIO 4-7. +.br + +.br +$ pigs nb 1 0xf +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBNC h\fP - Close notification" +.IP "" 4 + +.br +This command stops notifications on handle \fBh\fP returned by +a prior call to \fBNO\fP and releases the handle for reuse. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs nc 0 # First call succeeds. +.br + +.br +$ pigs nc 1 # Second call fails. +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBNO \fP - Request a notification" +.IP "" 4 + +.br +This command requests a free notification handle. + +.br +A notification is a method for being notified of GPIO state changes via a pipe. + +.br +Upon success the command returns a handle greater than or equal to zero. +On error a negative status code will be returned. + +.br +Notifications for handle x will be available at the pipe named /dev/pigpiox +(where x is the handle number). + +.br +E.g. if the command returns 15 then the notifications must be read +from /dev/pigpio15. + +.br + +\fBExample\fP +.br + +.EX +$ pigs no +.br +0 +.br + +.EE + +.br + +.IP "\fBNP h\fP - Pause notification" +.IP "" 4 + +.br +This command pauses notifications on handle \fBh\fP returned by +a prior call to \fBNO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +Notifications for the handle are suspended until a new \fBNB\fP command +is given for the handle. + +.br + +\fBExample\fP +.br + +.EX +$ pigs np 0 +.br + +.EE + +.br + +.IP "\fBP/PWM u v\fP - Set GPIO PWM value" +.IP "" 4 + +.br +This command starts PWM on GPIO \fBu\fP with dutycycle \fBv\fP. The dutycycle +varies from 0 (off) to range (fully on). The range defaults to 255. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +This and the servo functionality use the DMA and PWM or PCM peripherals +to control and schedule the pulsewidths and dutycycles. + +.br +The \fBPRS\fP command may be used to change the default range of 255. + +.br + +\fBExample\fP +.br + +.EX +$ pigs p 4 64 # Start PWM on GPIO 4 with 25% dutycycle +.br +$ pigs p 4 128 # 50% +.br +$ pigs p 4 192 # 75% +.br +$ pigs p 4 255 # 100% +.br + +.EE + +.br + +.IP "\fBPADG pad\fP - Get pad drive strength" +.IP "" 4 + +.br +This command gets the \fBpad\fP drive strength \fBpadma\fP in mA. + +.br +Returns the pad drive strength if OK. On error a negative status code +will be returned. + +.br + +.EX +Pad GPIO +0 0-27 +1 28-45 +2 46-53 + +.EE + +.br + +\fBExample\fP +.br + +.EX +$ pigs padg 0 +.br +8 +.br +$ pigs pads 0 16 +.br +$ pigs padg 0 +.br +16 +.br +pigs padg 3 +.br +-126 +.br +ERROR: bad pad number +.br + +.EE + +.br + +.IP "\fBPADS pad padma\fP - Set pad drive strength" +.IP "" 4 + +.br +This command sets the \fBpad\fP drive strength \fBpadma\fP in mA. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +.EX +Pad GPIO +0 0-27 +1 28-45 +2 46-53 + +.EE + +.br + +\fBExample\fP +.br + +.EX +$ pigs pads 0 16 +.br +$ pigs padg 0 +.br +16 +.br +$ pigs pads 0 17 +.br +-127 +.br +ERROR: bad pad drive strength +.br + +.EE + +.br + +.IP "\fBPARSE t\fP - Validate script" +.IP "" 4 + +.br +Validates the text \fBt\fP of a script without storing the script. + +.br +Upon success nothing is returned. On error a list of detected +script errors will be given. + +.br +See \fBScripts\fP. + +.br +This command may be used to find script syntax faults. + +.br + +\fBExample\fP +.br + +.EX +$ pigs parse tag 100 w 22 1 mils 200 w 22 0 mils 800 jmp 100 +.br + +.br +$ pigs parse tag 0 w 22 1 mills 50 w 22 0 dcr p10 jp 99 +.br +Unknown command: mills +.br +Unknown command: 50 +.br +Bad parameter to dcr +.br +Can't resolve tag 99 +.br + +.EE + +.br + +.IP "\fBPFG u\fP - Get GPIO PWM frequency" +.IP "" 4 + +.br +This command returns the PWM frequency in Hz used for GPIO \fBu\fP. + +.br +Upon success the PWM frequency is returned. On error a negative +status code will be returned. + +.br +For normal PWM the frequency will be that defined for the GPIO +by \fBPFS\fP. + +.br +If a hardware clock is active on the GPIO the reported frequency +will be that set by \fBHC\fP. + +.br +If hardware PWM is active on the GPIO the reported frequency +will be that set by \fBHP\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs pfg 4 +.br +800 +.br + +.br +$ pigs pfg 34 +.br +ERROR: GPIO not 0-31 +.br +-2 +.br + +.EE + +.br + +.IP "\fBPFS u v\fP - Set GPIO PWM frequency" +.IP "" 4 +This command sets the PWM frequency \fBv\fP to be used for GPIO \fBu\fP. + +.br +The numerically closest frequency to \fBv\fP will be selected. + +.br +Upon success the new frequency is returned. On error a negative status code +will be returned. + +.br +If PWM is currently active on the GPIO it will be +switched off and then back on at the new frequency. + +.br +Each GPIO can be independently set to one of 18 different PWM +frequencies. + +.br +The selectable frequencies depend upon the sample rate which +may be 1, 2, 4, 5, 8, or 10 microseconds (default 5). The +sample rate is set when the pigpio daemon is started. + +.br +The frequencies for each sample rate are: + +.br + +.EX + Hertz +.br + +.br + 1: 40000 20000 10000 8000 5000 4000 2500 2000 1600 +.br + 1250 1000 800 500 400 250 200 100 50 +.br + +.br + 2: 20000 10000 5000 4000 2500 2000 1250 1000 800 +.br + 625 500 400 250 200 125 100 50 25 +.br + +.br + 4: 10000 5000 2500 2000 1250 1000 625 500 400 +.br + 313 250 200 125 100 63 50 25 13 +.br +sample +.br + rate +.br + (us) 5: 8000 4000 2000 1600 1000 800 500 400 320 +.br + 250 200 160 100 80 50 40 20 10 +.br + +.br + 8: 5000 2500 1250 1000 625 500 313 250 200 +.br + 156 125 100 63 50 31 25 13 6 +.br + +.br + 10: 4000 2000 1000 800 500 400 250 200 160 +.br + 125 100 80 50 40 25 20 10 5 +.br + +.EE + +.br + +\fBExample\fP +.br + +.EX +pigs pfs 4 0 # 0 selects the lowest frequency. +.br +10 +.br + +.br +$ pigs pfs 4 1000 # Set 1000Hz PWM. +.br +1000 +.br + +.br +$ pigs pfs 4 100000 # Very big number selects the highest frequency. +.br +8000 +.br + +.EE + +.br + +.IP "\fBPIGPV \fP - Get pigpio library version" +.IP "" 4 + +.br +This command returns the pigpio library version. + +.br + +\fBExample\fP +.br + +.EX +$ pigs pigpv +.br +17 +.br + +.EE + +.br + +.IP "\fBPRG u\fP - Get GPIO PWM range" +.IP "" 4 + +.br +This command returns the dutycycle range for GPIO \fBu\fP. + +.br +Upon success the range is returned. On error a negative status code +will be returned. + +.br +If a hardware clock or hardware PWM is active on the GPIO the reported +range will be 1000000 (1M). + +.br + +\fBExample\fP +.br + +.EX +$ pigs prg 4 +.br +255 +.br + +.EE + +.br + +.IP "\fBPROC t\fP - Store script" +.IP "" 4 + +.br +This command stores a script \fBt\fP for later execution. + +.br +If the script is valid a script id (>=0) is returned which is passed +to the other script commands. On error a negative status code +will be returned. + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs proc tag 123 w 4 0 mils 200 w 4 1 mils 300 dcr p0 jp 123 +.br +0 +.br + +.br +$ pigs proc tag 123 w 4 0 mils 5 w 4 1 mils 5 jmp 12 +.br +ERROR: script has unresolved tag +.br +-63 +.br + +.EE + +.br + +.IP "\fBPROCD sid\fP - Delete script" +.IP "" 4 + +.br +This command deletes script \fBsid\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs procd 1 +.br + +.br +$ pigs procd 1 +.br +ERROR: unknown script id +.br +-48 +.br + +.EE + +.br + +.IP "\fBPROCP sid\fP - Get script status and parameters" +.IP "" 4 + +.br +This command returns the status of script \fBsid\fP as well as the +current value of its 10 parameters. + +.br +Upon success the script status and parameters are returned. +On error a negative status code will be returned. + +.br +The script status may be one of + +.br + +.EX +0 being initialised +1 halted +2 running +3 waiting +4 failed + +.EE + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs procp 0 +.br +1 0 0 0 0 0 0 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBPROCR sid pars\fP - Run script" +.IP "" 4 + +.br +This command runs stored script \fBsid\fP passing it up to 10 optional +parameters. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs proc tag 123 w 4 0 mils 200 w 4 1 mils 300 dcr p0 jp 123 +.br +0 +.br + +.br +$ pigs procr 0 50 # Run script 0 with parameter 0 of 50. +.br + +.br +$ pigs procp 0 +.br +2 44 0 0 0 0 0 0 0 0 0 +.br +$ pigs procp 0 +.br +2 37 0 0 0 0 0 0 0 0 0 +.br +$ pigs procp 0 +.br +2 10 0 0 0 0 0 0 0 0 0 +.br +$ pigs procp 0 +.br +2 5 0 0 0 0 0 0 0 0 0 +.br +$ pigs procp 0 +.br +2 2 0 0 0 0 0 0 0 0 0 +.br +$ pigs procp 0 +.br +1 -1 0 0 0 0 0 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBPROCS sid\fP - Stop script" +.IP "" 4 + +.br +This command stops a running script \fBsid\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs procs 0 +.br + +.br +$ pigs procs 1 +.br +-48 +.br +ERROR: unknown script id +.br + +.EE + +.br + +.IP "\fBPROCU sid pars\fP - Set script parameters" +.IP "" 4 + +.br +This command sets the parameters of a stored script \fBsid\fP passing +it up to 10 parameters. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +See \fBScripts\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs proc tag 0 hp 18 p0 p1 mils 1000 jmp 0 +.br +0 +.br +$ pigs procu 0 50 500000 +.br +$ pigs procr 0 +.br +$ pigs procu 0 100 +.br +$ pigs procu 0 200 +.br +$ pigs procu 0 200 100000 +.br + +.EE + +.br + +.IP "\fBPRRG u\fP - Get GPIO PWM real range" +.IP "" 4 + +.br +This command returns the real underlying range used by GPIO \fBu\fP. + +.br +If a hardware clock is active on the GPIO the reported +real range will be 1000000 (1M). + +.br +If hardware PWM is active on the GPIO the reported real range +will be approximately 250M divided by the set PWM frequency. + +.br +On error a negative status code will be returned. + +.br +See \fBPRS\fP. + +.br + +\fBExample\fP +.br + +.EX +$ pigs prrg 17 +.br +250 +.br + +.br +$ pigs pfs 17 0 +.br +10 +.br +$ pigs prrg 17 +.br +20000 +.br + +.br +$ pigs pfs 17 100000 +.br +8000 +.br +$ pigs prrg 17 +.br +25 +.br + +.EE + +.br + +.IP "\fBPRS u v\fP - Set GPIO PWM range" +.IP "" 4 + +.br +This command sets the dutycycle range \fBv\fP to be used for GPIO \fBu\fP. +Subsequent uses of command \fBP/PWM\fP will use a dutycycle between 0 (off) +and \fBv\fP (fully on). + +.br +Upon success the real underlying range used by the GPIO is returned. +On error a negative status code will be returned. + +.br +If PWM is currently active on the GPIO its dutycycle will be scaled to +reflect the new range. + +.br +The real range, the number of steps between fully off and fully on +for each frequency, is given in the following table. + +.br + +.EX + #1 #2 #3 #4 #5 #6 #7 #8 #9 + 25 50 100 125 200 250 400 500 625 + +#10 #11 #12 #13 #14 #15 #16 #17 #18 +800 1000 1250 2000 2500 4000 5000 10000 20000 + +.EE + +.br +The real value set by \fBPRS\fP is (dutycycle * real range) / range. + +.br +See \fBPRRG\fP + +.br + +\fBExample\fP +.br + +.EX +$ pigs prs 18 1000 +.br +250 +.br + +.EE + +.br + +.IP "\fBPUD g p\fP - Set GPIO pull up/down" +.IP "" 4 + +.br +This command sets the internal pull/up down for GPIO \fBg\fP to mode \fBp\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The mode may be pull-down (D), pull-up (U), or off (O). + +.br + +\fBExample\fP +.br + +.EX +$ pigs pud 4 d # Set pull-down on GPIO 4. +.br +$ pigs pud 4 u # Set pull-up on GPIO 4. +.br +$ pigs pud 4 o # No pull-up/down on GPIO 4. +.br + +.EE + +.br + +.IP "\fBR/READ g\fP - Read GPIO level" +.IP "" 4 + +.br +This reads the current level of GPIO \fBg\fP. + +.br +Upon success the current level is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs r 17 # Get level of GPIO 17. +.br +0 +.br + +.br +$ pigs r 4 # Get level of GPIO 4. +.br +1 +.br + +.EE + +.br + +.IP "\fBS/SERVO u v\fP - Set GPIO servo pulsewidth" +.IP "" 4 + +.br +This command starts servo pulses of \fBv\fP microseconds on GPIO \fBu\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The servo pulsewidth may be 0 (off), 500 (most anti-clockwise) +to 2500 (most clockwise). + +.br +The range supported by servos varies and should probably be determined +by experiment. Generally values between 1000-2000 should be safe. +A value of 1500 should always be safe and represents +the mid-point of rotation. + +.br +You can DAMAGE a servo if you command it to move beyond its limits. + +.br + +\fBExample\fP +.br + +.EX +$ pigs SERVO 17 1500 +.br + +.EE + +.br +This example causes an on pulse of 1500 microseconds duration to be +transmitted on GPIO 17 at a rate of 50 times per second. + +.br +This will command a servo connected to GPIO 17 to rotate to its mid-point. + +.br + +\fBExample\fP +.br + +.EX +pigs s 17 0 # Switch servo pulses off. +.br + +.EE + +.br + +.IP "\fBSERC h\fP - Close serial handle" +.IP "" 4 + +.br +This command closes a serial handle \fBh\fP previously opened with \fBSERO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serc 0 # First close okay. +.br + +.br +$ pigs serc 0 # Second close gives error. +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBSERDA h\fP - Check for serial data ready to read" +.IP "" 4 + +.br +This command returns the number of bytes of data available +to be read from the serial device associated with handle \fBh\fP. + +.br +Upon success the count of bytes available to be read is +returned (which may be 0). On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serda 0 +.br +0 +.br + +.EE + +.br + +.IP "\fBSERO dev b sef\fP - Open serial device dev at baud b with flags" +.IP "" 4 + +.br +This command opens the serial \fBdev\fP at \fBb\fP bits per second. + +.br +No flags are currently defined. \fBsef\fP should be set to zero. + +.br +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +.br +The device name must start with /dev/tty or /dev/serial. + +.br + +.br +The baud rate must be one of 50, 75, 110, 134, 150, +200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, +38400, 57600, 115200, or 230400. + +.br + +\fBExample\fP +.br + +.EX +$ pigs sero /dev/ttyAMA0 9600 0 +.br +0 +.br + +.br +$ pigs sero /dev/tty1 38400 0 +.br +1 +.br + +.EE + +.br + +.IP "\fBSERR h num\fP - Read bytes from serial handle" +.IP "" 4 + +.br +This command returns up to \fBnum\fP bytes of data read from the +serial device associated with handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serr 0 10 +.br +5 48 49 128 144 255 +.br + +.br +$ pigs serr 0 10 +.br +0 +.br + +.EE + +.br + +.IP "\fBSERRB \fP - Read byte from serial handle" +.IP "" 4 + +.br +This command returns a byte of data read from the serial +device associated with handle \fBh\fP. + +.br +Upon success a number between 0 and 255 is returned. +On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serrb 0 +.br +23 +.br +$ pigs serrb 0 +.br +45 +.br + +.EE + +.br + +.IP "\fBSERW h bvs\fP - Write bytes to serial handle" +.IP "" 4 + +.br +This command writes bytes \fBbvs\fP to the serial device +associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serw 0 23 45 67 89 +.br + +.EE + +.br + +.IP "\fBSERWB h bv\fP - Write byte to serial handle" +.IP "" 4 + +.br +This command writes a single byte \fBbv\fP to the serial device +associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs serwb 0 23 +.br +$ pigs serwb 0 0xf0 +.br + +.EE + +.br + +.IP "\fBSHELL name str\fP - Execute a shell command" +.IP "" 4 + +.br +This command uses the system call to execute a shell script \fBname\fP +with the given string \fBstr\fP as its parameter. + +.br +The exit status of the system call is returned if OK, otherwise +PI_BAD_SHELL_STATUS. + +.br +\fBname\fP must exist in /opt/pigpio/cgi and must be executable. + +.br +The returned exit status is normally 256 times that set +by the shell script exit function. If the script can't +be found 32512 will be returned. + +.br +The following table gives some example returned statuses. + +.br + +.EX +Script exit status Returned system call status +1 256 +5 1280 +10 2560 +200 51200 +script not found 32512 + +.EE + +.br + +\fBExample\fP +.br + +.EX +# pass two parameters, hello and world +.br +$ pigs shell scr1 hello world +.br +256 +.br + +.br +# pass three parameters, hello, string with spaces, and world +.br +$ pigs shell scr1 "hello 'string with spaces' world" +.br +256 +.br + +.br +# pass one parameter, hello string with spaces world +.br +$ pigs shell scr1 "\"hello string with spaces world\"" +.br +256 +.br + +.br +# non-existent script +.br +$ pigs shell scr78 par1 +.br +32512 +.br + +.EE + +.br + +.IP "\fBSLR u num\fP - Read bit bang serial data from GPIO" +.IP "" 4 + +.br +This command returns up to \fBnum\fP bytes of bit bang serial data +read from GPIO \fBu\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br +The GPIO \fBu\fP should have been initialised with the \fBSLRO\fP command. + +.br +The bytes returned for each character depend upon the number of +data bits \fBdb\fP specified in the \fBSLRO\fP command. + +.br +For \fBdb\fP 1-8 there will be one byte per character. +.br +For \fBdb\fP 9-16 there will be two bytes per character. +.br +For \fBdb\fP 17-32 there will be four bytes per character. + +.br + +\fBExample\fP +.br + +.EX +$ pigs slr 15 20 +.br +6 1 0 23 45 89 0 +.br + +.EE + +.br + +.IP "\fBSLRC u\fP - Close GPIO for bit bang serial data" +.IP "" 4 + +.br +This command closes GPIO \fBu\fP for reading bit bang serial data. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs slrc 23 +.br + +.br +$ pigs slrc 23 +.br +-38 +.br +ERROR: no serial read in progress on GPIO +.br + +.EE + +.br + +.IP "\fBSLRI u v\fP - Sets bit bang serial data logic levels" +.IP "" 4 + +.br +This command sets the logic level for reading bit bang serial data +on GPIO \fBu\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The invert parameter \fBv\fP is 1 for inverted signal, 0 for normal. + +.br + +\fBExample\fP +.br + +.EX +$ pigs slri 17 1 # invert logic on GPIO 17 +.br + +.br +$ pigs slri 23 0 # use normal logic on GPIO 23 +.br + +.EE + +.br + +.IP "\fBSLRO u b db\fP - Open GPIO for bit bang serial data" +.IP "" 4 + +.br +This command opens GPIO \fBu\fP for reading bit bang serial data +at \fBb\fP baud and \fBdb\fP data bits. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The baud rate may be between 50 and 250000 bits per second. + +.br +The received data is held in a cyclic buffer. + +.br +It is the user's responsibility to read the data (with \fBSLR\fP) +in a timely fashion. + +.br + +\fBExample\fP +.br + +.EX +$ pigs slro 23 19200 8 +.br + +.br +$ pigs slro 23 19200 8 +.br +-50 +.br +ERROR: GPIO already in use +.br + +.EE + +.br + +.IP "\fBSPIC h\fP - SPI close handle" +.IP "" 4 + +.br +This command closes the SPI handle \fBh\fP returned by a prior +call to \fBSPIO\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs spic 1 +.br + +.br +$ pigs spic 1 +.br +-25 +.br +ERROR: unknown handle +.br + +.EE + +.br + +.IP "\fBSPIO c b spf\fP - SPI open channel at baud b with flags" +.IP "" 4 + +.br +This command returns a handle to a SPI device on channel \fBc\fP. + +.br +Data will be transferred at \fBb\fP bits per second. The flags \fBspf\fP +may be used to modify the default behaviour of 4-wire operation, +mode 0, active low chip select. + +.br +Speeds between 32kbps and 125Mbps are allowed. Speeds above 30Mbps +are unlikely to work. + +.br +The Pi has two SPI peripherals: main and auxiliary. + +.br +The main SPI has two chip selects (channels), the auxiliary has +three. + +.br +The auxiliary SPI is available on all models but the A and B. + +.br +The GPIO used are given in the following table. + +.br + +.EX + MISO MOSI SCLK CE0 CE1 CE2 +Main SPI 9 10 11 8 7 - +Aux SPI 19 20 21 18 17 16 + +.EE + +.br +The flags consists of the least significant 22 bits. + +.br + +.EX +21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 +.br + b b b b b b R T n n n n W A u2 u1 u0 p2 p1 p0 m m +.br + +.EE + +.br +mm defines the SPI mode. + +.br +Warning: modes 1 and 3 do not appear to work on the auxiliary SPI. + +.br + +.EX +Mode POL PHA +.br + 0 0 0 +.br + 1 0 1 +.br + 2 1 0 +.br + 3 1 1 +.br + +.EE + +.br +px is 0 if CEx is active low (default) and 1 for active high. + +.br +ux is 0 if the CEx GPIO is reserved for SPI (default) and 1 otherwise. + +.br +A is 0 for the main SPI, 1 for the auxiliary SPI. + +.br +W is 0 if the device is not 3-wire, 1 if the device is 3-wire. Main +SPI only. + +.br +nnnn defines the number of bytes (0-15) to write before switching +the MOSI line to MISO to read data. This field is ignored +if W is not set. Main SPI only. + +.br +T is 1 if the least significant bit is transmitted on MOSI first, the +default (0) shifts the most significant bit out first. Auxiliary SPI +only. + +.br +R is 1 if the least significant bit is received on MISO first, the +default (0) receives the most significant bit first. Auxiliary SPI +only. + +.br +bbbbbb defines the word size in bits (0-32). The default (0) +sets 8 bits per word. Auxiliary SPI only. + +.br +The \fBSPIR\fP, \fBSPIW\fP, and \fBSPIX\fP commands transfer data +packed into 1, 2, or 4 bytes according to the word size in bits. + +.br +For bits 1-8 there will be one byte per character. +.br +For bits 9-16 there will be two bytes per character. +.br +For bits 17-32 there will be four bytes per character. + +.br +Multi-byte transfers are made in least significant byte first order. + +.br +E.g. to transfer 32 11-bit words 64 bytes need to be sent. + +.br +E.g. to transfer the 14 bit value 0x1ABC send the bytes 0xBC followed +by 0x1A. + +.br +The other bits in flags should be set to zero. + +.br +Upon success a handle (>=0) is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs spio 0 100000 3 # Open channel 0 at 100kbps in mode 3. +.br +0 +.br + +.br +$ pigs spio 0 32000 256 # Open channel 0 of auxiliary spi at 32kbps. +.br +1 +.br + +.EE + +.br + +.IP "\fBSPIR h num\fP - SPI read bytes from handle" +.IP "" 4 + +.br +This command returns \fBnum\fP bytes read from the SPI device +associated with handle \fBh\fP. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs spir 0 10 # Read 10 bytes from the SPI device. +.br +10 0 0 0 0 0 0 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBSPIW h bvs\fP - SPI write bytes to handle" +.IP "" 4 + +.br +This command writes bytes \fBbvs\fP to the SPI device +associated with handle \fBh\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs spiw 0 0x22 0x33 0xcc 0xff +.br + +.EE + +.br + +.IP "\fBSPIX h bvs\fP - SPI transfer bytes to handle" +.IP "" 4 + +.br +This command writes bytes \fBbvs\fP to the SPI device +associated with handle \fBh\fP. It returns the same +number of bytes read from the device. + +.br +Upon success the count of returned bytes followed by the bytes themselves +is returned. On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs spix 0 0x22 0x33 0xcc 0xff +.br +4 0 0 0 0 +.br + +.EE + +.br + +.IP "\fBT/TICK \fP - Get current tick" +.IP "" 4 + +.br +This command returns the current system tick. + +.br +Tick is the number of microseconds since system boot. + +.br +As tick is an unsigned 32 bit quantity it wraps around after 2^32 microseconds, +which is approximately 1 hour 12 minutes. + +.br + +\fBExample\fP +.br + +.EX +$ pigs t mils 1000 t +.br +3691823946 +.br +3692833987 +.br + +.EE + +.br + +.IP "\fBTRIG u pl L\fP - Send a trigger pulse" +.IP "" 4 + +.br +This command sends a trigger pulse of \fBpl\fP microseconds at level \fBL\fP +to GPIO \fBu\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The GPIO is set to not level at the end of the pulse. + +.br + +\fBExample\fP +.br + +.EX +$ pigs trig 4 10 1 +.br + +.br +$ pigs trig 4 51 1 +.br +-46 +.br +ERROR: trigger pulse > 50 microseconds +.br + +.EE + +.br + +.IP "\fBW/WRITE g L\fP - Write GPIO level" +.IP "" 4 + +.br +This command sets GPIO \fBg\fP to level \fBL\fP. The level may be 0 +(low, off, clear) or 1 (high, on, set). + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs w 23 0 +.br +$ pigs w 23 1 +.br + +.br +$ pigs w 23 2 +.br +-5 +.br +ERROR: level not 0-1 +.br + +.EE + +.br + +.IP "\fBWDOG u v\fP - Set GPIO watchdog" +.IP "" 4 + +.br +This command sets a watchdog of \fBv\fP milliseconds on GPIO \fBu\fP. + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br +The watchdog is nominally in milliseconds. + +.br +One watchdog may be registered per GPIO. + +.br +The watchdog may be cancelled by setting timeout to 0. + +.br +Once a watchdog has been started monitors of the GPIO +will be triggered every timeout interval after the last +GPIO activity. The watchdog expiry will be indicated by +a special TIMEOUT value. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wdog 23 90000 +.br +-15 +.br +ERROR: timeout not 0-60000 +.br + +.br +$ pigs wdog 23 9000 +.br + +.EE + +.br +This example causes a report to be written to any notification pipes +listening on GPIO 23 whenever GPIO 23 changes state or approximately +every 9000 ms. + +.br + +.IP "\fBWVAG trips\fP - Add generic pulses to waveform" +.IP "" 4 + +.br +This command adds 1 one or more triplets \fBtrips\fP of GPIO on, GPIO off, +delay to the existing waveform (if any). + +.br +Upon success the total number of pulses in the waveform so far is +returned. On error a negative status code will be returned. + +.br +The triplets will be added at the start of the existing waveform. If +they are to start offset from the start then the first triplet should +consist solely of a delay i.e. 0 0 offset. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvag 0x10 0x80 1000 0x80 0x10 9000 +.br +2 +.br + +.br +$ pigs wvag 0 0 10000 0x10 0x80 1000 0x80 0x10 9000 +.br +4 +.br + +.EE + +.br + +.IP "\fBWVAS u b db sb o bvs\fP - Add serial data to waveform" +.IP "" 4 + +.br +This command adds a waveform representing serial data \fBbvs\fP to +GPIO \fBu\fP at \fBb\fP baud to the existing waveform (if any). +The serial data starts \fBo\fP microseconds from the start of the +waveform. + +.br +Upon success the total number of pulses in the waveform so far is +returned. On error a negative status code will be returned. + +.br +The serial data is formatted as one start bit, \fBdb\fP data bits, and +\fBsb\fP/2 stop bits. + +.br +The baud rate may be between 50 and 1000000 bits per second. + +.br +It is legal to add serial data streams with different baud rates to +the same waveform. + +.br +The bytes required for each character depend upon \fBdb\fP. + +.br +For \fBdb\fP 1-8 there will be one byte per character. +.br +For \fBdb\fP 9-16 there will be two bytes per character. +.br +For \fBdb\fP 17-32 there will be four bytes per character. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvas 4 9600 8 2 0 0x30 0x31 0x32 0x33 +.br +23 +.br + +.br +$ pigs wvas 7 38400 8 2 0 0x41 0x42 +.br +35 +.br + +.EE + +.br + +.IP "\fBWVTAT \fP - Returns the current transmitting waveform" +.IP "" 4 + +.br +This command returns the id of the waveform currently +being transmitted. Chained waves are not supported. + +.br +Returns the waveform id or one of the following special +values: + +.br +9998 - transmitted wave not found +.br +9999 - no wave being transmitted + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvtat +.br +9999 +.br + +.EE + +.br + +.IP "\fBWVBSY \fP - Check if waveform is being transmitted" +.IP "" 4 + +.br +This command checks to see if a waveform is currently being transmitted. + +.br +Returns 1 if a waveform is currently being transmitted, otherwise 0. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvbsy +.br +0 +.br + +.EE + +.br + +.IP "\fBWVCHA bvs\fP - Transmits a chain of waveforms" +.IP "" 4 + +.br +This command transmits a chain of waveforms. + +.br +NOTE: Any hardware PWM started by \fBHP\fP will +be cancelled. + +.br +The waves to be transmitted are specified by the contents of +\fBbvs\fP which contains an ordered list of wave_ids and optional +command codes and related data. + +.br +Upon success 0 is returned. On error a negative status code +will be returned. + +.br +Each wave is transmitted in the order specified. A wave may +occur multiple times per chain. + +.br +A blocks of waves may be transmitted multiple times by using +the loop commands. The block is bracketed by loop start and +end commands. Loops may be nested. + +.br +Delays between waves may be added with the delay command. + +.br +The following command codes are supported: + +.br + +.EX +Name Cmd & Data Meaning +Loop Start 255 0 Identify start of a wave block +Loop Repeat 255 1 x y loop x + y*256 times +Delay 255 2 x y delay x + y*256 microseconds +Loop Forever 255 3 loop forever + +.EE + +.br +If present Loop Forever must be the last entry in the chain. + +.br +The code is currently dimensioned to support a chain with roughly +600 entries and 20 loop counters. + +.br + +\fBExample\fP +.br + +.EX +#!/bin/bash +.br + +.br +GPIO=4 +.br +WAVES=5 +.br + +.br +pigs m $GPIO w +.br + +.br +for ((i=0; i<$WAVES; i++)) +.br +do +.br + pigs wvag $((1<=0) is returned. On error a negative status +code will be returned. + +.br +The data provided by the \fBWVAG\fP and \fBWVAS\fP commands is +consumed by this command. + +.br +As many waveforms may be created as there is space available. +The wave id is passed to \fBWVTX\fP or \fBWVTXR\fP to specify the +waveform to transmit. + +.br +Normal usage would be + +.br +Step 1. \fBWVCLR\fP to clear all waveforms and added data. + +.br +Step 2. \fBWVAG\fP/\fBWVAS\fP calls to supply the waveform data. + +.br +Step 3. \fBWVCRE\fP to create the waveform and get a unique id. + +.br +Repeat steps 2 and 3 as needed. + +.br +Step 4. \fBWVTX\fP or \fBWVTXR\fP with the id of the waveform to transmit. + +.br +A waveform comprises of one or more pulses. + +.br +A pulse specifies + +.br +1) the GPIO to be switched on at the start of the pulse. +.br +2) the GPIO to be switched off at the start of the pulse. +.br +3) the delay in microseconds before the next pulse. + +.br +Any or all the fields can be zero. It doesn't make any sense to +set all the fields to zero (the pulse will be ignored). + +.br +When a waveform is started each pulse is executed in order with +the specified delay between the pulse and the next. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvas 4 9600 0 23 45 67 89 90 +.br +37 +.br +$ pigs wvcre +.br +0 +.br + +.br +$ pigs wvcre +.br +-69 +.br +ERROR: attempt to create an empty waveform +.br + +.EE + +.br + +.IP "\fBWVCAP percent\fP - Create a waveform of fixed size" +.IP "" 4 + +.br +Create a waveform of fixed size. Similar to \fBWVCRE\fP, this command creates a waveform but pads the consumed resources to a fixed size, specified as a \fBpercent\fP of the total resources. Padded waves of equal size can be re-cycled efficiently allowing newly created waves to re-use the resources of deleted waves of the same dimension. + +.br +Upon success a wave id (>=0) is returned. On error a negative status code will be returned. + +.br +The data provided by the \fBWVAG\fP and \fBWVAS\fP commands are consumed by this command. + +.br +As many waveforms may be created as there is space available. The wave id is passed to \fBWVTX\fP or \fBWVTXR\fP to specify the waveform to transmit. + +.br +Normal usage would be + +.br +Step 1. \fBWVCLR\fP to clear all waveforms and added data. + +.br +Step 2. \fBWVAG\fP/\fBWVAS\fP calls to supply the waveform data. + +.br +Step 3. \fBWVCAP\fP to create a waveform of a uniform size. + +.br +Step 4. \fBWVTX\fP or \fBWVTXR\fP with the id of the waveform to transmit. + +.br +Repeat steps 2 - 4 as needed. + +.br +Step 5. Any wave id can now be deleted and another wave of the same size can be created in its place. + +.br +Example + +.br + +\fBExample\fP +.br + +.EX +# Create a wave that consumes 50% of the total resource: +.br + +.br +$ pigs wvag 16 0 5000000 0 16 5000000 +.br +2 +.br +$ pigs wvcap 50 +.br +0 +.br +$ pigs wvtx 0 +.br +11918 +.br + +.EE + +.br + +.IP "\fBWVDEL wid\fP - Delete selected waveform" +.IP "" 4 + +.br +This command deletes the waveform with id \fBwid\fP. + +.br +The wave is flagged for deletion. The resources used by the wave +will only be reused when either of the following apply. + +.br +- all waves with higher numbered wave ids have been deleted or have +been flagged for deletion. + +.br +- a new wave is created which uses exactly the same resources as +the current wave (see the C source for gpioWaveCreate for details). + +.br +Upon success nothing is returned. On error a negative status code +will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvdel 0 +.br + +.br +$ pigs wvdel 0 +.br +-66 +.br +ERROR: non existent wave id +.br + +.EE + +.br + +.IP "\fBWVHLT \fP - Stop waveform" +.IP "" 4 + +.br +This command aborts the transmission of the current waveform. + +.br +Nothing is returned. + +.br +This command is intended to stop a waveform started in the repeat mode. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvhlt +.br + +.EE + +.br + +.IP "\fBWVNEW \fP - Initialise a new waveform" +.IP "" 4 + +.br +This clears any existing waveform data ready for the creation of a new +waveform. + +.br +Nothing is returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvnew +.br + +.EE + +.br + +.IP "\fBWVSC ws\fP - Get waveform DMA CB stats" +.IP "" 4 + +.br +The statistic requested by \fBws\fP is returned. + +.br +\fBws\fP identifies the subcommand as follows. + +.br +0 Get Cbs +.br +1 Get High Cbs +.br +2 Get Max Cbs + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvas 4 9600 0 23 45 67 89 90 +.br +37 +.br + +.br +$ pigs wvsc 0 +.br +74 +.br +$ pigs wvsc 1 +.br +74 +.br +$ pigs wvsc 2 +.br +25016 +.br + +.EE + +.br + +.IP "\fBWVSM ws\fP - Get waveform time stats" +.IP "" 4 + +.br +The statistic requested by \fBws\fP is returned. + +.br +\fBws\fP identifies the subcommand as follows. + +.br +0 Get Micros +.br +1 Get High Micros +.br +2 Get Max Micros + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvsm 0 +.br +5314 +.br +$ pigs wvsm 1 +.br +5314 +.br +$ pigs wvsm 2 +.br +1800000000 +.br + +.EE + +.br + +.IP "\fBWVSP ws\fP - Get waveform pulse stats" +.IP "" 4 + +.br +The statistic requested by \fBws\fP is returned. + +.br +\fBws\fP identifies the subcommand as follows. + +.br +0 Get Pulses +.br +1 Get High Pulses +.br +2 Get Max Pulses + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvsp 0 +.br +37 +.br +$ pigs wvsp 1 +.br +37 +.br +$ pigs wvsp 2 +.br +12000 +.br + +.EE + +.br + +.IP "\fBWVTX wid\fP - Transmits waveform once" +.IP "" 4 + +.br +This command transmits the waveform with id \fBwid\fP once. + +.br +NOTE: Any hardware PWM started by \fBHP\fP will be cancelled. + +.br +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvtx 1 +.br +75 +.br + +.br +$ pigs wvtx 2 +.br +-66 +.br +ERROR: non existent wave id +.br + +.EE + +.br + +.IP "\fBWVTXM wid wmde\fP - Transmits waveform using mode" +.IP "" 4 + +.br +This command transmits the waveform with id \fBwid\fP using mode \fBwmde\fP. + +.br +The mode may be send once (0), send repeatedly (1), send once but +first sync with previous wave (2), or send repeatedly but first +sync with previous wave (3). + +.br +WARNING: bad things may happen if you delete the previous +waveform before it has been synced to the new waveform. + +.br +NOTE: Any hardware PWM started by \fBHP\fP will be cancelled. + +.br +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvtxm 1 3 +.br +75 +.br + +.br +$ pigs wvtxm 2 0 +.br +-66 +.br +ERROR: non existent wave id +.br + +.EE + +.br + +.IP "\fBWVTXR wid\fP - Transmits waveform repeatedly" +.IP "" 4 + +.br +This command transmits the waveform with id \fBwid\fP repeatedly. + +.br +NOTE: Any hardware PWM started by \fBHP\fP will be cancelled. + +.br +Upon success the number of DMA control blocks in the waveform is returned. +On error a negative status code will be returned. + +.br + +\fBExample\fP +.br + +.EX +$ pigs wvtxr 1 +.br +75 +.br + +.br +$ pigs wvtxr 2 +.br +-66 +.br +ERROR: non existent wave id +.br + +.EE + +.br + +.SH PARAMETERS + +.br + +.IP "\fBactv\fP - 0-1000000" 0 + +.br +The number of microseconds level changes are reported for once +a noise filter has been triggered (by \fBstdy\fP microseconds of +a stable level). + +.br + +.IP "\fBb\fP - baud" 0 +The command expects the baud rate in bits per second for +the transmission of serial data (I2C/SPI/serial link, waves). + +.br + +.IP "\fBbctl\fP - BSC control word" 0 +The command expects a BSC control word, see \fBBSCX\fP. + +.br + +.IP "\fBbit\fP - bit value (0-1)" 0 +The command expects 0 or 1. + +.br + +.IP "\fBbits\fP - a bit mask" 0 +A mask is used to select one or more GPIO. A GPIO is selected +if bit (1<=0)" 0 +The command expects a handle. + +.br +A handle is a number referencing an object opened by one of \fBFO\fP, +\fBI2CO\fP, \fBNO\fP, \fBSERO\fP, \fBSPIO\fP. + +.br + +.IP "\fBib\fP - I2C bus (>=0)" 0 +The command expects an I2C bus number. + +.br + +.IP "\fBid\fP - I2C device (0-0x7F)" 0 +The command expects the address of an I2C device. + +.br + +.IP "\fBif\fP - I2C flags (0)" 0 +The command expects an I2C flags value. No flags are currently defined. + +.br + +.IP "\fBL\fP - level (0-1)" 0 +The command expects a GPIO level. + +.br + +.IP "\fBm\fP - mode (RW540123)" 0 +The command expects a mode character. + +.br +Each GPIO can be configured to be in one of 8 different modes. The modes +are named Input, Output, ALT0, ALT1, ALT2, ALT3, ALT4, and ALT5. + +.br +To set the mode use the code for the mode. + +.br +The value is returned by the mode get command. + +.br + +.EX +Mode Input Output ALT0 ALT1 ALT2 ALT3 ALT4 ALT5 +Code R W 0 1 2 3 4 5 +Value 0 1 4 5 6 7 3 2 + +.EE + +.br + +.IP "\fBmiso\fP - GPIO (0-31)" 0 +The GPIO used for the MISO signal when bit banging SPI. + +.br + +.IP "\fBmode\fP - file open mode" 0 +One of the following values. + +.br + +.EX + Value Meaning +READ 1 open file for reading +WRITE 2 open file for writing +RW 3 open file for reading and writing + +.EE + +.br +The following values can be or'd into the mode. + +.br + +.EX + Value Meaning +APPEND 4 All writes append data to the end of the file +CREATE 8 The file is created if it doesn't exist +TRUNC 16 The file is truncated + +.EE + +.br + +.IP "\fBmosi\fP - GPIO (0-31)" 0 +The GPIO used for the MOSI signal when bit banging SPI. + +.br + +.IP "\fBname\fP - the name of a script" 0 +Only alphanumeric characters, '-' and '_' are allowed in the name. + +.br + +.IP "\fBnum\fP - maximum number of bytes to return (1-)" 0 +The command expects the maximum number of bytes to return. + +.br +For the I2C and SPI commands the requested number of bytes will always +be returned. + +.br +For the serial and file commands the smaller of the number of +bytes available to be read (which may be zero) and \fBnum\fP bytes +will be returned. + +.br + +.IP "\fBo\fP - offset (>=0)" 0 +Serial data is stored offset microseconds from the start of the waveform. + +.br + +.IP "\fBp\fP - PUD (ODU)" 0 +The command expects a PUD character. + +.br +Each GPIO can be configured to use or not use an internal pull up or +pull down resistor. This is useful to provide a default state for inputs. + +.br +A pull up will default the input to 1 (high). + +.br +A pull down will default the input to 0 (low). + +.br +To set the pull up down state use the command character for the state. + +.br + +.EX +Pull Up Down Off Pull Down Pull Up +Command Character O D U + +.EE + +.br +There is no mechanism to read the pull up down state. + +.br + +.IP "\fBpad\fP - 0-2" 0 +A set of GPIO which share common drivers. + +.br + +.EX +Pad GPIO +0 0-27 +1 28-45 +2 46-53 + +.EE + +.br + +.IP "\fBpadma\fP - 1-16" 0 +The mA which may be drawn from each GPIO whilst still guaranteeing the +high and low levels. + +.br + +.IP "\fBpars\fP - script parameters" 0 +The command expects 0 to 10 numbers as parameters to be passed to the script. + +.br + +.IP "\fBpat\fP - a file name pattern" 0 +A file path which may contain wildcards. To be accessible the path +must match an entry in /opt/pigpio/access. + +.br + +.IP "\fBpdc\fP - hardware PWM dutycycle (0-1000000)" 0 +The command expects a dutycycle. + +.br + +.IP "\fBpercent\fP - percent (1-100)" 0 +The percent of wave resources to allocate to a wave. It can be useful +to create waves of fixed sizes to prevent wave fragmentation (where +there are plenty of resources but not a large enough contiguous space). + +.br + +.IP "\fBpf\fP - hardware PWM frequency (1-125M, 1-187.5M for the BCM2711)" 0 +The command expects a frequency. + +.br + +.IP "\fBpl\fP - pulse length (1-100)" 0 +The command expects a pulse length in microseconds. + +.br + +.IP "\fBr\fP - register (0-255)" 0 +The command expects an I2C register number. + +.br + +.IP "\fBsb\fP - serial stop (half) bits (2-8)" 0 +The command expects the number of stop (half) bits per serial character. + +.br + +.IP "\fBscl\fP - user GPIO (0-31)" 0 +The command expects the number of the GPIO to be used for SCL +when bit banging I2C. + +.br + +.IP "\fBsclk\fP - user GPIO (0-31)" 0 +The GPIO used for the SCLK signal when bit banging SPI. + +.br + +.IP "\fBsda\fP - user GPIO (0-31)" 0 +The command expects the number of the GPIO to be used for SDA +when bit banging I2C. + +.br + +.IP "\fBsef\fP - serial flags (32 bits)" 0 +The command expects a flag value. No serial flags are currently defined. + +.br + +.IP "\fBsid\fP - script id (>= 0)" 0 +The command expects a script id as returned by a call to \fBPROC\fP. + +.br + +.IP "\fBspf\fP - SPI flags (32 bits)" 0 +See \fBSPIO\fP and \fBBSPIO\fP. + +.br + +.IP "\fBstdy\fP - 0-300000" 0 + +.br +The number of microseconds level changes must be stable for +before reporting the level changed (\fBFG\fP) or triggering +the active part of a noise filter (\fBFN\fP). + +.br + +.IP "\fBstr\fP - a string" 0 +The command expects a string. + +.br + +.IP "\fBt\fP - a string" 0 +The command expects a string. + +.br + +.IP "\fBtrips\fP - triplets" 0 +The command expects 1 or more triplets of GPIO on, GPIO off, delay. + +.br +E.g. 0x400000 0 100000 0 0x400000 900000 defines two pulses as follows + +.br + +.EX + GPIO on GPIO off delay +0x400000 (GPIO 22) 0 (None) 100000 (1/10th s) + 0 (None) 0x400000 (GPIO 22) 900000 (9/10th s) + +.EE + +.br + +.IP "\fBu\fP - user GPIO (0-31)" 0 +The command expects the number of a user GPIO. + +.br +A number of commands are restricted to GPIO in bank 1, +in particular the PWM commands, the servo command, +the watchdog command, and the notification command. + +.br +It is your responsibility to ensure that the PWM and servo commands +are only used on safe GPIO. + +.br +See \fBg\fP + +.br + +.IP "\fBuvs\fP - values" 0 +The command expects an arbitrary number of >=0 values (possibly none). +Any after the first two must be <= 255. + +.br + +.IP "\fBv\fP - value" 0 +The command expects a number. + +.br + +.IP "\fBwid\fP - wave id (>=0)" 0 +The command expects a wave id. + +.br +When a waveform is created it is given an id (0, 1, 2, ...). + +.br + +.IP "\fBwmde\fP - mode (0-3)" 0 +The command expects a wave transmission mode. + +.br +0 = send once +.br +1 = send repeatedly +.br +2 = send once but first sync with previous wave +.br +3 = send repeatedly but first sync with previous wave +.br + +.br + +.IP "\fBws\fP - wave stats sucommand (0-2)" 0 +The command expects a subcommand. + +.br +0 = current value. +.br +1 = highest value so far. +.br +2 = maximum possible value. + +.br + +.IP "\fBwv\fP - word value (0-65535)" 0 +The command expects a word value. + +.br + +.SH SCRIPTS + +.br +Scripts are programs to be stored and executed by the pigpio daemon. +They are intended to mitigate any performance problems associated with +the pigpio daemon server/client model. + +.br +.SS Example +.br +A trivial example might be useful. Suppose you want to toggle a GPIO +on and off as fast as possible. + +.br +From the command line you could write + +.br + +.EX +for ((i=0; i<1000;i++)); do pigs w 22 1 w 22 0; done +.br + +.EE + +.br +Timing that you will see it takes about 14 seconds, or roughly +70 toggles per second. + +.br +Using the pigpio Python module you could use code such as + +.br + +.EX +#!/usr/bin/env python +.br + +.br +import time +.br + +.br +import pigpio +.br + +.br +PIN=4 +.br + +.br +TOGGLE=10000 +.br + +.br +pi = pigpio.pi() # Connect to local Pi. +.br + +.br +s = time.time() +.br + +.br +for i in range(TOGGLE): +.br + pi.write(PIN, 1) +.br + pi.write(PIN, 0) +.br + +.br +e = time.time() +.br + +.br +print("pigpio did {} toggles per second".format(int(TOGGLE/(e-s)))) +.br + +.br +pi.stop() +.br + +.EE + +.br +Timing that shows a speed improvement to roughly 800 toggles per second. + +.br +Now let's use a script. + +.br + +.EX +pigs proc tag 999 w 22 1 w 22 0 dcr p0 jp 999 +.br + +.EE + +.br +Ignore the details for now. + +.br +Let's time the script running. + +.br +Again, ignore the details for now. + +.br + +.EX +time (pigs procr 0 10000000; while a=$(pigs procp 0); [[ ${a::1} -eq 2 ]];\ +.br + do sleep 0.2; done) +.br + +.EE + +.br +The script takes roughly 12 seconds to complete, or 800,000 toggles per second. + +.br +That is the advantage of a stored script. + +.br +Some details. + +.br + +.EX +pigs proc tag 999 w 22 1 w 22 0 dcr p0 jp 999 +.br + +.EE + +.br +proc introduces a script. Everything after proc is part of the script. +.br +tag 999 names the current position in the script. +.br +w 22 1 writes 1 to GPIO 22. +.br +w 22 0 writes 0 to GPIO 22. +.br +dcr p0 decrements parameter 0. +.br +jp 999 jumps to tag 999 if the result is positive. + +.br + +.EX +time (pigs procr 0 10000000; while a=$(pigs procp 0); [[ ${a::1} -eq 2 ]];\ +.br + do sleep 0.2; done) +.br + +.EE + +.br +pigs procr 0 10000000 starts script 0 with parameter 0 of 10 million. + +.br +The rest is bash apart from + +.br +pigs procp 0 asks for the status and parameters of script 0. +The status will be 2 while the script is running and 1 when it is complete. + +.br +.SS Virtual machine +.br +A script runs within a virtual machine with + +.br +a 32 bit accumulator A. +.br +a flags register F. +.br +a program counter PC. + +.br +Each script has + +.br +10 parameters named 0 through 9. +.br +150 variables named 0 through 149. +.br +50 labels which are named by any unique number. + +.br +.SS Commands +.br +Many pigpio commands may be used within a script. However +some commands do not work within the script model as designed and +are not permitted. + +.br +The following commands are not permitted within a script: + +.br +File - FL FO FR FW + +.br +I2C - BI2CZ I2CPK I2CRD I2CRI I2CRK I2CWD I2CWI I2CWK I2CZ + +.br +Misc - BSCX CF1 CF2 SHELL + +.br +Script control - PARSE PROC PROCD PROCP PROCR PROCS PROCU + +.br +Serial - SERO SERR SERW SLR + +.br +SPI - BSPIO BSPIX SPIR SPIW SPIX + +.br +Waves - WVAG WVAS WVCHA WVGO WVGOR + +.br +The following commands are only permitted within a script: + +.br + +.EX +Command Description Definition +ADD x Add x to accumulator A+=x; F=A +AND x And x with accumulator A&=x; F=A +CALL L Call subroutine at tag L push(PC+1); PC=L +CMP x Compare x with accumulator F=A-x +DCR y Decrement register --*y; F=*y +DCRA Decrement accumulator --A; F=A +DIV x Divide x into accumulator A/=x; F=A +EVTWT Wait for an event to occur A=wait(x); F=A +HALT Halt Halt +INR y Increment register ++*y; F=*y +INRA Increment accumulator ++A; F=A +JM L Jump if minus to tag L if (F<0) PC=L +JMP L Jump to tag L PC=L +JNZ L Jump if non-zero to tag L if (F) PC=L +JP L Jump if positive to tag L if (F>=0) PC=L +JZ L Jump if zero to tag L if (!F) PC=L +LD y x Load register with x *y=x +LDA x Load accumulator with x A=x +MLT x Multiply x with accumulator A*=x; F=A +MOD x Modulus x with accumulator A%=x; F=A +OR x Or x with accumulator A|=x; F=A +POP y Pop register y=pop() +POPA Pop accumulator A=pop() +PUSH y Push register push(y) +PUSHA Push accumulator push(A) +RET Return from subroutine PC=pop() +RL y x Rotate left register x bits *y<<=x; F=*y +RLA x Rotate left accumulator x bits A<<=x; F=A +RR y x Rotate right register x bits *y>>=x; F=*y +RRA x Rotate right accumulator x bits A>>=x; F=A +STA y Store accumulator in register y=A +SUB x Subtract x from accumulator A-=x; F=A +SYS str Run external script (/opt/pigpio/cgi/str) system(str); F=A +TAG L Label the current script position N/A +WAIT x Wait for a GPIO in x to change state A=wait(x); F=A +X y1 y2 Exchange contents of registers y1 and y2 t=*y1;*y1=*y2;*y2=t +XA y Exchange contents of accumulator and register t=A;A=*y;*y=t +XOR x Xor x with accumulator A^=x; F=A + +.EE + +.br +x may be a constant, a parameter (p0-p9), or a variable (v0-v149). + +.br +y may be a parameter (p0-p9), or a variable (v0-v149). If p or v isn't +specified y is assumed to be a variable. + +.br +The EVTWT command parameter is a bit-mask with 1 set for events of interest. + +.br +The WAIT command parameter is a bit-mask with 1 set for GPIO of interest. + +.br +The SYS script receives two unsigned parameters: the accumulator A and +the current GPIO levels. + +.br + +.SH SEE ALSO + +pigpiod(1), pig2vcd(1), pigpio(3), pigpiod_if(3), pigpiod_if2(3) +.SH AUTHOR + +joan@abyz.me.uk diff --git a/pigpio-master/pigs.c b/pigpio-master/pigs.c new file mode 100644 index 0000000..928afa3 --- /dev/null +++ b/pigpio-master/pigs.c @@ -0,0 +1,394 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* +This version is for pigpio version 69+ +*/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" +#include "command.h" +#include "pigs.h" + +/* +This program provides a socket interface to some of +the commands available from pigpio. +*/ + +char command_buf[CMD_MAX_EXTENSION]; +char response_buf[CMD_MAX_EXTENSION]; + +int printFlags = 0; + +int status = PIGS_OK; + +#define SOCKET_OPEN_FAILED -1 + +#define PRINT_HEX 1 +#define PRINT_ASCII 2 + +void report(int err, char *fmt, ...) +{ + char buf[128]; + va_list ap; + + if (err > status) status = err; + + va_start(ap, fmt); + vsnprintf(buf, sizeof(buf), fmt, ap); + va_end(ap); + + fprintf(stderr, "%s\n", buf); + + fflush(stderr); +} + +static int initOpts(int argc, char *argv[]) +{ + int opt, args; + + opterr = 0; + + args = 1; + + while ((opt = getopt(argc, argv, "ax")) != -1) + { + switch (opt) + { + case 'a': + printFlags |= PRINT_ASCII; + args++; + break; + + case 'x': + printFlags |= PRINT_HEX; + args++; + break; + + default: + args++; + report(PIGS_OPTION_ERR, "ERROR: bad option %c", optopt); + } + } + return args; +} + +static int openSocket(void) +{ + int sock, err; + struct addrinfo hints, *res, *rp; + const char *addrStr, *portStr; + + portStr = getenv(PI_ENVPORT); + + if (!portStr) portStr = PI_DEFAULT_SOCKET_PORT_STR; + + addrStr = getenv(PI_ENVADDR); + + if (!addrStr) addrStr = PI_DEFAULT_SOCKET_ADDR_STR; + + memset (&hints, 0, sizeof (hints)); + + hints.ai_family = PF_UNSPEC; + hints.ai_socktype = SOCK_STREAM; + hints.ai_flags |= AI_CANONNAME; + + err = getaddrinfo(addrStr, portStr, &hints, &res); + + if (err) return SOCKET_OPEN_FAILED; + + for (rp=res; rp!=NULL; rp=rp->ai_next) + { + sock = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); + + if (sock == -1) continue; + + if (connect(sock, rp->ai_addr, rp->ai_addrlen) != -1) break; + } + + freeaddrinfo(res); + + if (rp == NULL) return SOCKET_OPEN_FAILED; + + return sock; +} + +void print_result(int sock, int rv, cmdCmd_t cmd) +{ + int i, r, ch; + uint32_t *p; + + r = cmd.res; + + switch (rv) + { + case 0: + case 1: + if (r < 0) + { + printf("%d\n", r); + report(PIGS_SCRIPT_ERR, "ERROR: %s", cmdErrStr(r)); + } + break; + + case 2: + printf("%d\n", r); + if (r < 0) report(PIGS_SCRIPT_ERR, "ERROR: %s", cmdErrStr(r)); + break; + + case 3: + printf("%08X\n", cmd.res); + break; + + case 4: + printf("%u\n", cmd.res); + break; + + case 5: + printf("%s", cmdUsage); + break; + + case 6: /* + BI2CZ CF2 FL FR I2CPK I2CRD I2CRI I2CRK + I2CZ SERR SLR SPIX SPIR + */ + printf("%d", r); + if (r < 0) report(PIGS_SCRIPT_ERR, "ERROR: %s", cmdErrStr(r)); + if (r > 0) + { + if (printFlags == PRINT_ASCII) printf(" "); + + for (i=0; i 4) + { + if (printFlags == PRINT_ASCII) printf(" "); + + for (i=4; i 0) + { + recv(sock, response_buf, res, MSG_WAITALL); + response_buf[res] = 0; + } + break; + } +} + +int main(int argc , char *argv[]) +{ + int sock, command; + int args, idx, i, pp, l, len; + cmdCmd_t cmd; + uintptr_t p[CMD_P_ARR]; + cmdCtlParse_t ctl; + cmdScript_t s; + char v[CMD_MAX_EXTENSION]; + + sock = openSocket(); + + args = initOpts(argc, argv); + + command_buf[0] = 0; + l = 0; + pp = 0; + + for (i=args; i= 0) && (ctl.eaten < len)) + { + if ((idx=cmdParse(command_buf, p, CMD_MAX_EXTENSION, v, &ctl)) >= 0) + { + command = p[0]; + + if (command < PI_CMD_SCRIPT) + { + if (command == PI_CMD_HELP) + { + printf("%s", cmdUsage); + } + else if (command == PI_CMD_PARSE) + { + cmdParseScript(v, &s, 1); + if (s.par) free (s.par); + } + else + { + cmd.cmd = command; + cmd.p1 = p[1]; + cmd.p2 = p[2]; + cmd.p3 = p[3]; + + if (sock != SOCKET_OPEN_FAILED) + { + if (send(sock, &cmd, sizeof(cmdCmd_t), 0) == + sizeof(cmdCmd_t)) + { + if (p[3]) send(sock, v, p[3], 0); /* send extensions */ + + if (recv(sock, &cmd, sizeof(cmdCmd_t), MSG_WAITALL) == + sizeof(cmdCmd_t)) + { + get_extensions(sock, command, cmd.res); + + print_result(sock, cmdInfo[idx].rv, cmd); + } + else report(PIGS_CONNECT_ERR, "socket receive failed"); + } + else report(PIGS_CONNECT_ERR, "socket send failed"); + } + else report(PIGS_CONNECT_ERR, "socket connect failed"); + } + } + else report(PIGS_SCRIPT_ERR, + "%s only allowed within a script", cmdInfo[idx].name); + } + else + { + if (idx == CMD_UNKNOWN_CMD) + report(PIGS_SCRIPT_ERR, + "%s? unknown command, pigs h for help", cmdStr()); + else + report(PIGS_SCRIPT_ERR, + "%s: bad parameter, pigs h for help", cmdStr()); + } + } + + if (sock >= 0) close(sock); + + return status; +} + diff --git a/pigpio-master/pigs.h b/pigpio-master/pigs.h new file mode 100644 index 0000000..16cfcdd --- /dev/null +++ b/pigpio-master/pigs.h @@ -0,0 +1,41 @@ +/* +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +*/ + +/* +This version is for pigpio version 67+ +*/ + +#ifndef PIGS_H +#define PIGS_H + +#define PIGS_OK 0 +#define PIGS_CONNECT_ERR 255 +#define PIGS_OPTION_ERR 254 +#define PIGS_SCRIPT_ERR 253 + +#endif + diff --git a/pigpio-master/setup.py b/pigpio-master/setup.py new file mode 100644 index 0000000..4dbb8a9 --- /dev/null +++ b/pigpio-master/setup.py @@ -0,0 +1,23 @@ +#!/usr/bin/env python + +from distutils.core import setup + +setup(name='pigpio', + version='1.78', + author='joan', + author_email='joan@abyz.me.uk', + maintainer='joan', + maintainer_email='joan@abyz.me.uk', + url='http://abyz.me.uk/rpi/pigpio/python.html', + description='Raspberry Pi GPIO module', + long_description='Raspberry Pi Python module to access the pigpio daemon', + download_url='http://abyz.me.uk/rpi/pigpio/pigpio.zip', + license='unlicense.org', + py_modules=['pigpio'], + keywords=['raspberrypi', 'gpio',], + classifiers=[ + "Programming Language :: Python :: 2", + "Programming Language :: Python :: 3", + ] + ) + diff --git a/pigpio-master/util/Findpigpio.cmake b/pigpio-master/util/Findpigpio.cmake new file mode 100644 index 0000000..eebfbfe --- /dev/null +++ b/pigpio-master/util/Findpigpio.cmake @@ -0,0 +1,31 @@ +################################################################################ +### Find the pigpio shared libraries. +################################################################################ + +# Find the path to the pigpio includes. +find_path(pigpio_INCLUDE_DIR + NAMES pigpio.h pigpiod_if.h pigpiod_if2.h + HINTS /usr/local/include) + +# Find the pigpio libraries. +find_library(pigpio_LIBRARY + NAMES libpigpio.so + HINTS /usr/local/lib) +find_library(pigpiod_if_LIBRARY + NAMES libpigpiod_if.so + HINTS /usr/local/lib) +find_library(pigpiod_if2_LIBRARY + NAMES libpigpiod_if2.so + HINTS /usr/local/lib) + +# Set the pigpio variables to plural form to make them accessible for +# the paramount cmake modules. +set(pigpio_INCLUDE_DIRS ${pigpio_INCLUDE_DIR}) +set(pigpio_INCLUDES ${pigpio_INCLUDE_DIR}) + +# Handle REQUIRED, QUIET, and version arguments +# and set the _FOUND variable. +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(pigpio + DEFAULT_MSG + pigpio_INCLUDE_DIR pigpio_LIBRARY pigpiod_if_LIBRARY pigpiod_if2_LIBRARY) diff --git a/pigpio-master/util/pigpiod.service b/pigpio-master/util/pigpiod.service new file mode 100644 index 0000000..f040d38 --- /dev/null +++ b/pigpio-master/util/pigpiod.service @@ -0,0 +1,10 @@ +[Unit] +Description=Pigpio daemon + +[Service] +Type=forking +PIDFile=pigpio.pid +ExecStart=/usr/bin/pigpiod + +[Install] +WantedBy=multi-user.target diff --git a/pigpio-master/util/readme.md b/pigpio-master/util/readme.md new file mode 100644 index 0000000..27c4c3d --- /dev/null +++ b/pigpio-master/util/readme.md @@ -0,0 +1,31 @@ +This folder provides utility files for the pigpio library. + +### pigpiod + +`pigpiod` is a script that allows to run pigpiod as a Linux service with root privileges. +The advantage of running pigpiod as a service is that pigpiod can be automatically launched on system startup. +To automatically start pigpiod as a service, do the following: + ++ Copy `pigpiod` from this directory to `/etc/init.d/`. + ++ Make it executable: + ``` + sudo chmod +x /etc/init.d/pigpiod + ``` + ++ Tell update-rc.d to automatically start the pigpiod service on system startup: + ``` + sudo update-rc.d pigpiod defaults + ``` + ++ Now, you can start, stop, and restart pigpiod using + ``` + sudo service pigpiod start + sudo service pigpiod stop + sudo service pigpiod restart + ``` + + +### Findpigpio.cmake + +`Findpigpio.cmake` is a script used by CMake to find out where the pigpio header and library files are located. diff --git a/pigpio-master/x_pigpio.c b/pigpio-master/x_pigpio.c new file mode 100644 index 0000000..8119d73 --- /dev/null +++ b/pigpio-master/x_pigpio.c @@ -0,0 +1,952 @@ +/* +gcc -Wall -pthread -o x_pigpio x_pigpio.c -lpigpio +sudo ./x_pigpio + +*** WARNING ************************************************ +* * +* All the tests make extensive use of gpio 25 (pin 22). * +* Ensure that either nothing or just a LED is connected to * +* gpio 25 before running any of the tests. * +* * +* Some tests are statistical in nature and so may on * +* occasion fail. Repeated failures on the same test or * +* many failures in a group of tests indicate a problem. * +************************************************************ +*/ + +#include +#include +#include +#include +#include +#include +#include +#include + +#include "pigpio.h" + +#define USERDATA 18249013 + +#define GPIO 25 + +void CHECK(int t, int st, int got, int expect, int pc, char *desc) +{ + if ((got >= (((1E2-pc)*expect)/1E2)) && (got <= (((1E2+pc)*expect)/1E2))) + { + printf("TEST %2d.%-2d PASS (%s: %d)\n", t, st, desc, expect); + } + else + { + fprintf(stderr, + "TEST %2d.%-2d FAILED got %d (%s: %d)\n", + t, st, got, desc, expect); + } +} + +void t0() +{ + printf("\nTesting pigpio C I/F\n"); + + printf("pigpio version %d.\n", gpioVersion()); + + printf("Hardware revision %d.\n", gpioHardwareRevision()); +} + +void t1() +{ + int v; + + printf("Mode/PUD/read/write tests.\n"); + + gpioSetMode(GPIO, PI_INPUT); + v = gpioGetMode(GPIO); + CHECK(1, 1, v, 0, 0, "set mode, get mode"); + + gpioSetPullUpDown(GPIO, PI_PUD_UP); + gpioDelay(1); /* 1 micro delay to let GPIO reach level reliably */ + v = gpioRead(GPIO); + CHECK(1, 2, v, 1, 0, "set pull up down, read"); + + gpioSetPullUpDown(GPIO, PI_PUD_DOWN); + gpioDelay(1); /* 1 micro delay to let GPIO reach level reliably */ + v = gpioRead(GPIO); + CHECK(1, 3, v, 0, 0, "set pull up down, read"); + + gpioWrite(GPIO, PI_LOW); + v = gpioGetMode(GPIO); + CHECK(1, 4, v, 1, 0, "write, get mode"); + + v = gpioRead(GPIO); + CHECK(1, 5, v, 0, 0, "read"); + + gpioWrite(GPIO, PI_HIGH); + gpioDelay(1); /* 1 micro delay to let GPIO reach level reliably */ + v = gpioRead(GPIO); + CHECK(1, 6, v, 1, 0, "write, read"); +} + +int t2_count; + +void t2cb(int gpio, int level, uint32_t tick) +{ + t2_count++; +} + +void t2() +{ + int dc, f, r, rr, oc; + + printf("PWM dutycycle/range/frequency tests.\n"); + + gpioSetPWMrange(GPIO, 255); + gpioSetPWMfrequency(GPIO, 0); + f = gpioGetPWMfrequency(GPIO); + CHECK(2, 1, f, 10, 0, "set PWM range, set/get PWM frequency"); + + t2_count=0; + + gpioSetAlertFunc(GPIO, t2cb); + + gpioPWM(GPIO, 0); + dc = gpioGetPWMdutycycle(GPIO); + CHECK(2, 2, dc, 0, 0, "get PWM dutycycle"); + + time_sleep(0.5); /* allow old notifications to flush */ + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 3, f, 0, 0, "set PWM dutycycle, callback"); + + gpioPWM(GPIO, 128); + dc = gpioGetPWMdutycycle(GPIO); + CHECK(2, 4, dc, 128, 0, "get PWM dutycycle"); + + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 5, f, 40, 5, "set PWM dutycycle, callback"); + + gpioSetPWMfrequency(GPIO, 100); + f = gpioGetPWMfrequency(GPIO); + CHECK(2, 6, f, 100, 0, "set/get PWM frequency"); + + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 7, f, 400, 1, "callback"); + + gpioSetPWMfrequency(GPIO, 1000); + f = gpioGetPWMfrequency(GPIO); + CHECK(2, 8, f, 1000, 0, "set/get PWM frequency"); + + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 9, f, 4000, 1, "callback"); + + r = gpioGetPWMrange(GPIO); + CHECK(2, 10, r, 255, 0, "get PWM range"); + + rr = gpioGetPWMrealRange(GPIO); + CHECK(2, 11, rr, 200, 0, "get PWM real range"); + + gpioSetPWMrange(GPIO, 2000); + r = gpioGetPWMrange(GPIO); + CHECK(2, 12, r, 2000, 0, "set/get PWM range"); + + rr = gpioGetPWMrealRange(GPIO); + CHECK(2, 13, rr, 200, 0, "get PWM real range"); + + gpioPWM(GPIO, 0); +} + +int t3_val; +int t3_reset; +int t3_count; +uint32_t t3_tick; +float t3_on; +float t3_off; + +void t3cbf(int gpio, int level, uint32_t tick, void *userdata) +{ + static int unreported = 1; + + uint32_t td; + int *val; + + val = userdata; + + if (*val != USERDATA) + { + if (unreported) + { + fprintf + ( + stderr, + "unexpected userdata %d (expected %d)\n", + *val, USERDATA + ); + } + unreported = 0; + } + + if (t3_reset) + { + t3_count = 0; + t3_on = 0.0; + t3_off = 0.0; + t3_reset = 0; + } + else + { + td = tick - t3_tick; + + if (level == 0) t3_on += td; + else t3_off += td; + } + + t3_count ++; + t3_tick = tick; +} + +void t3() +{ + int f, rr; + + float on, off; + + int t, v; + + int pw[3]={500, 1500, 2500}; + int dc[4]={20, 40, 60, 80}; + + printf("PWM/Servo pulse accuracy tests.\n"); + + t3_val = USERDATA; + t3_reset=1; + t3_count=0; + t3_tick=0; + t3_on=0.0; + t3_off=0.0; + + gpioSetAlertFuncEx(GPIO, t3cbf, &t3_val); /* test extended alert */ + + for (t=0; t<3; t++) + { + gpioServo(GPIO, pw[t]); + v = gpioGetServoPulsewidth(GPIO); + CHECK(3, t+t+1, v, pw[t], 0, "get servo pulsewidth"); + + time_sleep(1); + t3_reset = 1; + time_sleep(4); + on = t3_on; + off = t3_off; + CHECK(3, t+t+2, (1E3*(on+off))/on, 2E7/pw[t], 1, + "set servo pulsewidth"); + } + + gpioServo(GPIO, 0); + gpioSetPWMfrequency(GPIO, 1000); + f = gpioGetPWMfrequency(GPIO); + CHECK(3, 7, f, 1000, 0, "set/get PWM frequency"); + + rr = gpioSetPWMrange(GPIO, 100); + CHECK(3, 8, rr, 200, 0, "set PWM range"); + + for (t=0; t<4; t++) + { + gpioPWM(GPIO, dc[t]); + v = gpioGetPWMdutycycle(GPIO); + CHECK(3, t+t+9, v, dc[t], 0, "get PWM dutycycle"); + + time_sleep(1); + t3_reset = 1; + time_sleep(2); + on = t3_on; + off = t3_off; + CHECK(3, t+t+10, (1E3*on)/(on+off), 1E1*dc[t], 1, + "set PWM dutycycle"); + } + + gpioPWM(GPIO, 0); +} + +void t4() +{ + int h, e, f, n, s, b, l, seq_ok, toggle_ok; + gpioReport_t r; + char p[32]; + + printf("Pipe notification tests.\n"); + + gpioSetPWMfrequency(GPIO, 0); + gpioPWM(GPIO, 0); + gpioSetPWMrange(GPIO, 100); + + h = gpioNotifyOpen(); + + sprintf(p, "/dev/pigpio%d", h); + f = open(p, O_RDONLY); + + e = gpioNotifyBegin(h, (1< 0) text[c] = 0; + CHECK(5, 11, strcmp(TEXT, text), 0, 0, "wave tx busy, serial read"); + + e = gpioSerialReadClose(GPIO); + CHECK(5, 12, e, 0, 0, "serial read close"); + + c = gpioWaveGetMicros(); + CHECK(5, 13, c, 6158148, 0, "wave get micros"); + + c = gpioWaveGetHighMicros(); + CHECK(5, 14, c, 6158148, 0, "wave get high micros"); + + c = gpioWaveGetMaxMicros(); + CHECK(5, 15, c, 1800000000, 0, "wave get max micros"); + + c = gpioWaveGetPulses(); + CHECK(5, 16, c, 3405, 0, "wave get pulses"); + + c = gpioWaveGetHighPulses(); + CHECK(5, 17, c, 3405, 0, "wave get high pulses"); + + c = gpioWaveGetMaxPulses(); + CHECK(5, 18, c, 12000, 0, "wave get max pulses"); + + c = gpioWaveGetCbs(); + if (e < 6963) CHECK(5, 19, c, 6810, 0, "wave get cbs"); + else CHECK(5, 19, c, 7115, 0, "wave get cbs"); + + c = gpioWaveGetHighCbs(); + if (e < 6963) CHECK(5, 20, c, 6810, 0, "wave get high cbs"); + else CHECK(5, 20, c, 7115, 0, "wave get high cbs"); + + c = gpioWaveGetMaxCbs(); + CHECK(5, 21, c, 25016, 0, "wave get max cbs"); + + /* waveCreatePad tests */ + gpioWaveTxStop(); + gpioWaveClear(); + gpioSetAlertFunc(GPIO, t5cbf); + + e = gpioWaveAddGeneric(2, (gpioPulse_t[]) + { {1<= 0) text[b] = 0; + CHECK(10, 7, strcmp(TEXT, text), 0, 0, "serial read"); + + b = serReadByte(h); + CHECK(10, 8, b, 0xAA, 0, "serial read byte"); + + b = serReadByte(h); + CHECK(10, 9, b, 0x55, 0, "serial read byte"); + + b = serReadByte(h); + CHECK(10, 10, b, 0x00, 0, "serial read byte"); + + b = serReadByte(h); + CHECK(10, 11, b, 0xFF, 0, "serial read byte"); + + b = serDataAvailable(h); + CHECK(10, 12, b, 0, 0, "serial data availabe"); + + e = serClose(h); + CHECK(10, 13, e, 0, 0, "serial close"); +} + +void tb() +{ + int h, e, b, len; + char *exp; + char buf[128]; + + printf("SMBus / I2C tests."); + + /* this test requires an ADXL345 on I2C bus 1 addr 0x53 */ + + h = i2cOpen(1, 0x53, 0); + CHECK(11, 1, h, 0, 0, "i2cOpen"); + + e = i2cWriteDevice(h, "\x00", 1); /* move to known register */ + CHECK(11, 2, e, 0, 0, "i2cWriteDevice"); + + b = i2cReadDevice(h, buf, 1); + CHECK(11, 3, b, 1, 0, "i2cReadDevice"); + CHECK(11, 4, buf[0], 0xE5, 0, "i2cReadDevice"); + + b = i2cReadByte(h); + CHECK(11, 5, b, 0xE5, 0, "i2cReadByte"); + + b = i2cReadByteData(h, 0); + CHECK(11, 6, b, 0xE5, 0, "i2cReadByteData"); + + b = i2cReadByteData(h, 48); + CHECK(11, 7, b, 2, 0, "i2cReadByteData"); + + exp = "\x1D[aBcDeFgHjKM]"; + len = strlen(exp); + + e = i2cWriteDevice(h, exp, len); + CHECK(11, 8, e, 0, 0, "i2cWriteDevice"); + + e = i2cWriteDevice(h, "\x1D", 1); + b = i2cReadDevice(h, buf, len-1); + CHECK(11, 9, b, len-1, 0, "i2cReadDevice"); + CHECK(11, 10, strncmp(buf, exp+1, len-1), 0, 0, "i2cReadDevice"); + + if (strncmp(buf, exp+1, len-1)) + printf("got [%.*s] expected [%.*s]\n", len-1, buf, len-1, exp+1); + + e = i2cWriteByteData(h, 0x1d, 0xAA); + CHECK(11, 11, e, 0, 0, "i2cWriteByteData"); + + b = i2cReadByteData(h, 0x1d); + CHECK(11, 12, b, 0xAA, 0, "i2cReadByteData"); + + e = i2cWriteByteData(h, 0x1d, 0x55); + CHECK(11, 13, e, 0, 0, "i2cWriteByteData"); + + b = i2cReadByteData(h, 0x1d); + CHECK(11, 14, b, 0x55, 0, "i2cReadByteData"); + + exp = "[1234567890#]"; + len = strlen(exp); + + e = i2cWriteBlockData(h, 0x1C, exp, len); + CHECK(11, 15, e, 0, 0, "i2c writeBlockData"); + + e = i2cWriteDevice(h, "\x1D", 1); + b = i2cReadDevice(h, buf, len); + CHECK(11, 16, b, len, 0, "i2cReadDevice"); + CHECK(11, 17, strncmp(buf, exp, len), 0, 0, "i2cReadDevice"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + b = i2cReadI2CBlockData(h, 0x1D, buf, len); + CHECK(11, 18, b, len, 0, "i2cReadI2CBlockData"); + CHECK(11, 19, strncmp(buf, exp, len), 0, 0, "i2cReadI2CBlockData"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + exp = "(-+=;:,<>!%)"; + len = strlen(exp); + + e = i2cWriteI2CBlockData(h, 0x1D, exp, len); + CHECK(11, 20, e, 0, 0, "i2cWriteI2CBlockData"); + + b = i2cReadI2CBlockData(h, 0x1D, buf, len); + CHECK(11, 21, b, len, 0, "i2cReadI2CBlockData"); + CHECK(11, 22, strncmp(buf, exp, len), 0, 0, "i2cReadI2CBlockData"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + e = i2cClose(h); + CHECK(11, 23, e, 0, 0, "i2cClose"); +} + +void tc() +{ + int h, x, b, e; + char txBuf[8], rxBuf[8]; + + printf("SPI tests."); + + /* this test requires a MCP3202 on SPI channel 1 */ + + h = spiOpen(1, 50000, 0); + CHECK(12, 1, h, 0, 0, "spiOpen"); + + sprintf(txBuf, "\x01\x80"); + + for (x=0; x<5; x++) + { + b = spiXfer(h, txBuf, rxBuf, 3); + CHECK(12, 2, b, 3, 0, "spiXfer"); + if (b == 3) + { + time_sleep(1.0); + printf("%d ", ((rxBuf[1]&0x0F)*256)|rxBuf[2]); + } + } + + e = spiClose(h); + CHECK(12, 99, e, 0, 0, "spiClose"); +} + +int main(int argc, char *argv[]) +{ + int i, t, c, status; + + char test[64]={0,}; + + if (argc > 1) + { + t = 0; + + for (i=0; i 0x03000000: + + if type(r) == type(""): + r = bytearray(r, 'latin-1') + + if type(s) == type(""): + s = bytearray(s, 'latin-1') + + if r != s: + print(r, s) + return 0 + + else: + return 1 + +def CHECK(t, st, got, expect, pc, desc): + if got >= (((1E2-pc)*expect)/1E2) and got <= (((1E2+pc)*expect)/1E2): + print("TEST {:2d}.{:<2d} PASS ({}: {:d})".format(t, st, desc, expect)) + else: + print("TEST {:2d}.{:<2d} FAILED got {:d} ({}: {:d})". + format(t, st, got, desc, expect)) + +def t0(): + + print("\nTesting pigpio Python module {}".format(pigpio.VERSION)) + + print("Python {}".format(sys.version.replace("\n", " "))) + + print("pigpio version {}.".format(pi.get_pigpio_version())) + + print("Hardware revision {}.".format(pi.get_hardware_revision())) + +def t1(): + + print("Mode/PUD/read/write tests.") + + pi.set_mode(GPIO, pigpio.INPUT) + v = pi.get_mode(GPIO) + CHECK(1, 1, v, 0, 0, "set mode, get mode") + + pi.set_pull_up_down(GPIO, pigpio.PUD_UP) + v = pi.read(GPIO) + CHECK(1, 2, v, 1, 0, "set pull up down, read") + + pi.set_pull_up_down(GPIO, pigpio.PUD_DOWN) + v = pi.read(GPIO) + CHECK(1, 3, v, 0, 0, "set pull up down, read") + + pi.write(GPIO, pigpio.LOW) + v = pi.get_mode(GPIO) + CHECK(1, 4, v, 1, 0, "write, get mode") + + v = pi.read(GPIO) + CHECK(1, 5, v, 0, 0, "read") + + pi.write(GPIO, pigpio.HIGH) + v = pi.read(GPIO) + CHECK(1, 6, v, 1, 0, "write, read") + +t2_count=0 + +def t2cbf(gpio, level, tick): + global t2_count + t2_count += 1 + +def t2(): + + global t2_count + + print("PWM dutycycle/range/frequency tests.") + + pi.set_PWM_range(GPIO, 255) + pi.set_PWM_frequency(GPIO,0) + f = pi.get_PWM_frequency(GPIO) + CHECK(2, 1, f, 10, 0, "set PWM range, set/get PWM frequency") + + t2cb = pi.callback(GPIO, pigpio.EITHER_EDGE, t2cbf) + + pi.set_PWM_dutycycle(GPIO, 0) + dc = pi.get_PWM_dutycycle(GPIO) + CHECK(2, 2, dc, 0, 0, "get PWM dutycycle") + + time.sleep(0.5) # allow old notifications to flush + oc = t2_count + time.sleep(2) + f = t2_count - oc + CHECK(2, 3, f, 0, 0, "set PWM dutycycle, callback") + + pi.set_PWM_dutycycle(GPIO, 128) + dc = pi.get_PWM_dutycycle(GPIO) + CHECK(2, 4, dc, 128, 0, "get PWM dutycycle") + + time.sleep(1) + oc = t2_count + time.sleep(2) + f = t2_count - oc + CHECK(2, 5, f, 40, 10, "set PWM dutycycle, callback") + + pi.set_PWM_frequency(GPIO,100) + f = pi.get_PWM_frequency(GPIO) + CHECK(2, 6, f, 100, 0, "set/get PWM frequency") + + time.sleep(1) + oc = t2_count + time.sleep(2) + f = t2_count - oc + CHECK(2, 7, f, 400, 5, "callback") + + pi.set_PWM_frequency(GPIO,1000) + f = pi.get_PWM_frequency(GPIO) + CHECK(2, 8, f, 1000, 0, "set/get PWM frequency") + + time.sleep(1) + oc = t2_count + time.sleep(2) + f = t2_count - oc + CHECK(2, 9, f, 4000, 5, "callback") + + r = pi.get_PWM_range(GPIO) + CHECK(2, 10, r, 255, 0, "get PWM range") + + rr = pi.get_PWM_real_range(GPIO) + CHECK(2, 11, rr, 200, 0, "get PWM real range") + + pi.set_PWM_range(GPIO, 2000) + r = pi.get_PWM_range(GPIO) + CHECK(2, 12, r, 2000, 0, "set/get PWM range") + + rr = pi.get_PWM_real_range(GPIO) + CHECK(2, 13, rr, 200, 0, "get PWM real range") + + pi.set_PWM_dutycycle(GPIO, 0) + + t2cb.cancel() + +t3_reset=True +t3_count=0 +t3_tick=0 +t3_on=0.0 +t3_off=0.0 + +def t3cbf(gpio, level, tick): + global t3_reset, t3_count, t3_tick, t3_on, t3_off + + if t3_reset: + t3_count = 0 + t3_on = 0.0 + t3_off = 0.0 + t3_reset = False + else: + td = pigpio.tickDiff(t3_tick, tick) + + if level == 0: + t3_on += td + else: + t3_off += td + + t3_count += 1 + t3_tick = tick + +def t3(): + + global t3_reset, t3_count, t3_on, t3_off + + pw=[500.0, 1500.0, 2500.0] + dc=[0.2, 0.4, 0.6, 0.8] + + print("PWM/Servo pulse accuracy tests.") + + t3cb = pi.callback(GPIO, pigpio.EITHER_EDGE, t3cbf) + + t = 0 + for x in pw: + t += 1 + pi.set_servo_pulsewidth(GPIO, x) + v = pi.get_servo_pulsewidth(GPIO) + CHECK(3, t, v, int(x), 0, "get servo pulsewidth") + + t += 1 + time.sleep(1) + t3_reset = True + time.sleep(4) + c = t3_count + on = t3_on + off = t3_off + CHECK(3, t, int((1E3*(on+off))/on), int(2E7/x), 1, "set servo pulsewidth") + + + pi.set_servo_pulsewidth(GPIO, 0) + pi.set_PWM_frequency(GPIO, 1000) + f = pi.get_PWM_frequency(GPIO) + CHECK(3, 7, f, 1000, 0, "set/get PWM frequency") + + rr = pi.set_PWM_range(GPIO, 100) + CHECK(3, 8, rr, 200, 0, "set PWM range") + + t = 8 + for x in dc: + t += 1 + pi.set_PWM_dutycycle(GPIO, x*100) + v = pi.get_PWM_dutycycle(GPIO) + CHECK(3, t, v, int(x*100), 0, "get PWM dutycycle") + + t += 1 + time.sleep(1) + t3_reset = True + time.sleep(2) + c = t3_count + on = t3_on + off = t3_off + CHECK(3, t, int((1E3*on)/(on+off)), int(1E3*x), 1, "set PWM dutycycle") + + pi.set_PWM_dutycycle(GPIO, 0) + + t3cb.cancel() + +def t4(): + + print("Pipe notification tests.") + + pi.set_PWM_frequency(GPIO, 0) + pi.set_PWM_dutycycle(GPIO, 0) + pi.set_PWM_range(GPIO, 100) + + h = pi.notify_open() + e = pi.notify_begin(h, (1<=0, 1, 0, "serial open") + + (b, s) = pi.serial_read(h, 1000) # flush buffer + + b = pi.serial_data_available(h) + CHECK(10, 2, b, 0, 0, "serial data available") + + TEXT = """ +To be, or not to be, that is the question- +Whether 'tis Nobler in the mind to suffer +The Slings and Arrows of outrageous Fortune, +Or to take Arms against a Sea of troubles, +""" + e = pi.serial_write(h, TEXT) + CHECK(10, 3, e, 0, 0, "serial write") + + e = pi.serial_write_byte(h, 0xAA) + e = pi.serial_write_byte(h, 0x55) + e = pi.serial_write_byte(h, 0x00) + e = pi.serial_write_byte(h, 0xFF) + + CHECK(10, 4, e, 0, 0, "serial write byte") + + time.sleep(0.1) # allow time for transmission + + b = pi.serial_data_available(h) + CHECK(10, 5, b, len(TEXT)+4, 0, "serial data available") + + (b, text) = pi.serial_read(h, len(TEXT)) + CHECK(10, 6, b, len(TEXT), 0, "serial read") + CHECK(10, 7, STRCMP(text, TEXT), True, 0, "serial read") + + b = pi.serial_read_byte(h) + CHECK(10, 8, b, 0xAA, 0, "serial read byte") + + b = pi.serial_read_byte(h) + CHECK(10, 9, b, 0x55, 0, "serial read byte") + + b = pi.serial_read_byte(h) + CHECK(10, 10, b, 0x00, 0, "serial read byte") + + b = pi.serial_read_byte(h) + CHECK(10, 11, b, 0xFF, 0, "serial read byte") + + b = pi.serial_data_available(h) + CHECK(10, 12, b, 0, 0, "serial data available") + + e = pi.serial_close(h) + CHECK(10, 13, e, 0, 0, "serial close") + +def tb(): + print("SMBus / I2C tests.") + + # this test requires an ADXL345 on I2C bus 1 addr 0x53 + + h = pi.i2c_open(1, 0x53) + CHECK(11, 1, h>=0, 1, 0, "i2c open") + + e = pi.i2c_write_device(h, "\x00") # move to known register + CHECK(11, 2, e, 0, 0, "i2c write device") + + (b, d) = pi.i2c_read_device(h, 1) + CHECK(11, 3, b, 1, 0, "i2c read device") + CHECK(11, 4, ord(d), 0xE5, 0, "i2c read device") + + b = pi.i2c_read_byte(h) + CHECK(11, 5, b, 0xE5, 0, "i2c read byte") + + b = pi.i2c_read_byte_data(h, 0) + CHECK(11, 6, b, 0xE5, 0, "i2c read byte data") + + b = pi.i2c_read_byte_data(h, 48) + CHECK(11, 7, b, 2, 0, "i2c read byte data") + + exp = b"[aB\x08cD\xAAgHj\xFD]" + + e = pi.i2c_write_device(h, b'\x1D'+ exp) + CHECK(11, 8, e, 0, 0, "i2c write device") + + e = pi.i2c_write_device(h, '\x1D') + (b, d) = pi.i2c_read_device(h, 12) + CHECK(11, 9, b, 12, 0, "i2c read device") + CHECK(11, 10, STRCMP(d, exp), True, 0, "i2c read device") + + e = pi.i2c_write_byte_data(h, 0x1d, 0xAA) + CHECK(11, 11, e, 0, 0, "i2c write byte data") + + b = pi.i2c_read_byte_data(h, 0x1d) + CHECK(11, 12, b, 0xAA, 0, "i2c read byte data") + + e = pi.i2c_write_byte_data(h, 0x1d, 0x55) + CHECK(11, 13, e, 0, 0, "i2c write byte data") + + b = pi.i2c_read_byte_data(h, 0x1d) + CHECK(11, 14, b, 0x55, 0, "i2c read byte data") + + exp = "[1234567890#]" + + e = pi.i2c_write_block_data(h, 0x1C, exp) + CHECK(11, 15, e, 0, 0, "i2c write block data") + + e = pi.i2c_write_device(h, '\x1D') + (b, d) = pi.i2c_read_device(h, 13) + CHECK(11, 16, b, 13, 0, "i2c read device") + CHECK(11, 17, STRCMP(d, exp), True, 0, "i2c read device") + + (b, d) = pi.i2c_read_i2c_block_data(h, 0x1D, 13) + CHECK(11, 18, b, 13, 0, "i2c read i2c block data") + CHECK(11, 19, STRCMP(d, exp), True, 0, "i2c read i2c block data") + + expl = [0x01, 0x05, 0x06, 0x07, 0x09, 0x1B, 0x99, 0xAA, 0xBB, 0xCC] + exp = "\x01\x05\x06\x07\x09\x1B\x99\xAA\xBB\xCC" + + e = pi.i2c_write_i2c_block_data(h, 0x1D, expl) + CHECK(11, 20, e, 0, 0, "i2c write i2c block data") + + (b, d) = pi.i2c_read_i2c_block_data(h, 0x1D, 10) + CHECK(11, 21, b, 10, 0, "i2c read i2c block data") + CHECK(11, 22, STRCMP(d, exp), True, 0, "i2c read i2c block data") + + e = pi.i2c_close(h) + CHECK(11, 23, e, 0, 0, "i2c close") + +def tca(b, d): + if b == 3: + c1 = d[1] & 0x0F + c2 = d[2] + time.sleep(1.0) + print((c1*256)+c2) + +def tc(): + print("SPI tests.") + + # this test requires a MCP3202 on SPI channel 1 + + h = pi.spi_open(1, 50000) + CHECK(12, 1, h>=0, 1, 0, "spi open") + + (b, d) = pi.spi_xfer(h, [1,128,0]) + CHECK(12, 2, b, 3, 0, "spi xfer") + tca(b, d) + + (b, d) = pi.spi_xfer(h, "\x01\x80\x00") + CHECK(12, 2, b, 3, 0, "spi xfer") + tca(b, d) + + (b, d) = pi.spi_xfer(h, b"\x01\x80\x00") + CHECK(12, 2, b, 3, 0, "spi xfer") + tca(b, d) + + (b, d) = pi.spi_xfer(h, '\x01\x80\x00') + CHECK(12, 2, b, 3, 0, "spi xfer") + tca(b, d) + + (b, d) = pi.spi_xfer(h, b'\x01\x80\x00') + CHECK(12, 2, b, 3, 0, "spi xfer") + tca(b, d) + + e = pi.spi_close(h) + CHECK(12, 99, e, 0, 0, "spi close") + +def td(): + + print("Wavechains & filter tests.") + + tdcb = pi.callback(GPIO) + + pi.set_mode(GPIO, pigpio.OUTPUT) + + pi.write(GPIO, pigpio.LOW) + + e = pi.wave_clear() + CHECK(13, 1, e, 0, 0, "callback, set mode, wave clear") + + wf = [] + + wf.append(pigpio.pulse(1< 1: + tests = "" + for C in sys.argv[1]: + c = C.lower() + if c not in tests: + tests += c + +else: + tests = "0123456789d" + +pi = pigpio.pi() + +if pi.connected: + print("Connected to pigpio daemon.") + + if '0' in tests: t0() + if '1' in tests: t1() + if '2' in tests: t2() + if '3' in tests: t3() + if '4' in tests: t4() + if '5' in tests: t5() + if '6' in tests: t6() + if '7' in tests: t7() + if '8' in tests: t8() + if '9' in tests: t9() + if 'a' in tests: ta() + if 'b' in tests: tb() + if 'c' in tests: tc() + if 'd' in tests: td() + +pi.stop() + diff --git a/pigpio-master/x_pigpiod_if.c b/pigpio-master/x_pigpiod_if.c new file mode 100644 index 0000000..ae4d7a5 --- /dev/null +++ b/pigpio-master/x_pigpiod_if.c @@ -0,0 +1,875 @@ +/* +gcc -Wall -pthread -o x_pigpiod_if x_pigpiod_if.c -lpigpiod_if +./x_pigpiod_if + +*** WARNING ************************************************ +* * +* All the tests make extensive use of gpio 25 (pin 22). * +* Ensure that either nothing or just a LED is connected to * +* gpio 25 before running any of the tests. * +* * +* Some tests are statistical in nature and so may on * +* occasion fail. Repeated failures on the same test or * +* many failures in a group of tests indicate a problem. * +************************************************************ +*/ + +#include +#include +#include +#include +#include +#include +#include + +#include "pigpiod_if.h" + +#define GPIO 25 + +void CHECK(int t, int st, int got, int expect, int pc, char *desc) +{ + if ((got >= (((1E2-pc)*expect)/1E2)) && (got <= (((1E2+pc)*expect)/1E2))) + { + printf("TEST %2d.%-2d PASS (%s: %d)\n", t, st, desc, expect); + } + else + { + fprintf(stderr, + "TEST %2d.%-2d FAILED got %d (%s: %d)\n", + t, st, got, desc, expect); + } +} + +void t0() +{ + printf("\nTesting pigpiod C I/F 1\n"); + + printf("pigpio version %d.\n", get_pigpio_version()); + + printf("Hardware revision %d.\n", get_hardware_revision()); +} + +void t1() +{ + int v; + + printf("Mode/PUD/read/write tests.\n"); + + set_mode(GPIO, PI_INPUT); + v = get_mode(GPIO); + CHECK(1, 1, v, 0, 0, "set mode, get mode"); + + set_pull_up_down(GPIO, PI_PUD_UP); + v = gpio_read(GPIO); + CHECK(1, 2, v, 1, 0, "set pull up down, read"); + + set_pull_up_down(GPIO, PI_PUD_DOWN); + v = gpio_read(GPIO); + CHECK(1, 3, v, 0, 0, "set pull up down, read"); + + gpio_write(GPIO, PI_LOW); + v = get_mode(GPIO); + CHECK(1, 4, v, 1, 0, "write, get mode"); + + v = gpio_read(GPIO); + CHECK(1, 5, v, 0, 0, "read"); + + gpio_write(GPIO, PI_HIGH); + v = gpio_read(GPIO); + CHECK(1, 6, v, 1, 0, "write, read"); +} + +int t2_count=0; + +void t2cb(unsigned gpio, unsigned level, uint32_t tick) +{ + t2_count++; +} + +void t2() +{ + int dc, f, r, rr, oc; + + printf("PWM dutycycle/range/frequency tests.\n"); + + set_PWM_range(GPIO, 255); + set_PWM_frequency(GPIO, 0); + f = get_PWM_frequency(GPIO); + CHECK(2, 1, f, 10, 0, "set PWM range, set/get PWM frequency"); + + callback(GPIO, EITHER_EDGE, t2cb); + + set_PWM_dutycycle(GPIO, 0); + dc = get_PWM_dutycycle(GPIO); + CHECK(2, 2, dc, 0, 0, "get PWM dutycycle"); + + time_sleep(0.5); /* allow old notifications to flush */ + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 3, f, 0, 0, "set PWM dutycycle, callback"); + + set_PWM_dutycycle(GPIO, 128); + dc = get_PWM_dutycycle(GPIO); + CHECK(2, 4, dc, 128, 0, "get PWM dutycycle"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 5, f, 40, 5, "set PWM dutycycle, callback"); + + set_PWM_frequency(GPIO, 100); + f = get_PWM_frequency(GPIO); + CHECK(2, 6, f, 100, 0, "set/get PWM frequency"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 7, f, 400, 1, "callback"); + + set_PWM_frequency(GPIO, 1000); + f = get_PWM_frequency(GPIO); + CHECK(2, 8, f, 1000, 0, "set/get PWM frequency"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 9, f, 4000, 1, "callback"); + + r = get_PWM_range(GPIO); + CHECK(2, 10, r, 255, 0, "get PWM range"); + + rr = get_PWM_real_range(GPIO); + CHECK(2, 11, rr, 200, 0, "get PWM real range"); + + set_PWM_range(GPIO, 2000); + r = get_PWM_range(GPIO); + CHECK(2, 12, r, 2000, 0, "set/get PWM range"); + + rr = get_PWM_real_range(GPIO); + CHECK(2, 13, rr, 200, 0, "get PWM real range"); + + set_PWM_dutycycle(GPIO, 0); +} + +int t3_reset=1; +int t3_count=0; +uint32_t t3_tick=0; +float t3_on=0.0; +float t3_off=0.0; + +void t3cbf(unsigned gpio, unsigned level, uint32_t tick) +{ + uint32_t td; + + if (t3_reset) + { + t3_count = 0; + t3_on = 0.0; + t3_off = 0.0; + t3_reset = 0; + } + else + { + td = tick - t3_tick; + + if (level == 0) t3_on += td; + else t3_off += td; + } + + t3_count ++; + t3_tick = tick; +} + +void t3() +{ + int pw[3]={500, 1500, 2500}; + int dc[4]={20, 40, 60, 80}; + + int f, rr, v; + float on, off; + + int t; + + printf("PWM/Servo pulse accuracy tests.\n"); + + callback(GPIO, EITHER_EDGE, t3cbf); + + for (t=0; t<3; t++) + { + set_servo_pulsewidth(GPIO, pw[t]); + v = get_servo_pulsewidth(GPIO); + CHECK(3, t+t+1, v, pw[t], 0, "get servo pulsewidth"); + + time_sleep(1); + t3_reset = 1; + time_sleep(4); + on = t3_on; + off = t3_off; + CHECK(3, t+t+2, (1000.0*(on+off))/on, 20000000.0/pw[t], 1, + "set servo pulsewidth"); + } + + set_servo_pulsewidth(GPIO, 0); + set_PWM_frequency(GPIO, 1000); + f = get_PWM_frequency(GPIO); + CHECK(3, 7, f, 1000, 0, "set/get PWM frequency"); + + rr = set_PWM_range(GPIO, 100); + CHECK(3, 8, rr, 200, 0, "set PWM range"); + + for (t=0; t<4; t++) + { + set_PWM_dutycycle(GPIO, dc[t]); + v = get_PWM_dutycycle(GPIO); + CHECK(3, t+t+9, v, dc[t], 0, "get PWM dutycycle"); + + time_sleep(1); + t3_reset = 1; + time_sleep(2); + on = t3_on; + off = t3_off; + CHECK(3, t+t+10, (1000.0*on)/(on+off), 10.0*dc[t], 1, + "set PWM dutycycle"); + } + + set_PWM_dutycycle(GPIO, 0); + +} + +void t4() +{ + int h, e, f, n, s, b, l, seq_ok, toggle_ok; + gpioReport_t r; + char p[32]; + + printf("Pipe notification tests.\n"); + + set_PWM_frequency(GPIO, 0); + set_PWM_dutycycle(GPIO, 0); + set_PWM_range(GPIO, 100); + + h = notify_open(); + + sprintf(p, "/dev/pigpio%d", h); + f = open(p, O_RDONLY); + + e = notify_begin(h, (1< 0) text[c] = 0; /* null terminate string */ + CHECK(5, 11, strcmp(TEXT, text), 0, 0, "wave tx busy, serial read"); + + e = bb_serial_read_close(GPIO); + CHECK(5, 12, e, 0, 0, "serial read close"); + + c = wave_get_micros(); + CHECK(5, 13, c, 6158148, 0, "wave get micros"); + + c = wave_get_high_micros(); + if (c > 6158148) c = 6158148; + CHECK(5, 14, c, 6158148, 0, "wave get high micros"); + + c = wave_get_max_micros(); + CHECK(5, 15, c, 1800000000, 0, "wave get max micros"); + + c = wave_get_pulses(); + CHECK(5, 16, c, 3405, 0, "wave get pulses"); + + c = wave_get_high_pulses(); + CHECK(5, 17, c, 3405, 0, "wave get high pulses"); + + c = wave_get_max_pulses(); + CHECK(5, 18, c, 12000, 0, "wave get max pulses"); + + c = wave_get_cbs(); + if (c < 6963) CHECK(5, 19, c, 6810, 0, "wave get cbs"); + else CHECK(5, 19, c, 7115, 0, "wave get cbs"); + + c = wave_get_high_cbs(); + if (c < 6963) CHECK(5, 20, c, 6810, 0, "wave get high cbs"); + else CHECK(5, 20, c, 7115, 0, "wave get high cbs"); + + c = wave_get_max_cbs(); + CHECK(5, 21, c, 25016, 0, "wave get max cbs"); +} + +int t6_count=0; +int t6_on=0; +uint32_t t6_on_tick=0; + +void t6cbf(unsigned gpio, unsigned level, uint32_t tick) +{ + if (level == 1) + { + t6_on_tick = tick; + t6_count++; + } + else + { + if (t6_on_tick) t6_on += (tick - t6_on_tick); + } +} + +void t6() +{ + int tp, t, p; + + printf("Trigger tests.\n"); + + gpio_write(GPIO, PI_LOW); + + tp = 0; + + callback(GPIO, EITHER_EDGE, t6cbf); + + time_sleep(0.2); + + for (t=0; t<5; t++) + { + time_sleep(0.1); + p = 10 + (t*10); + tp += p; + gpio_trigger(GPIO, p, 1); + } + + time_sleep(0.5); + + CHECK(6, 1, t6_count, 5, 0, "gpio trigger count"); + + CHECK(6, 2, t6_on, tp, 25, "gpio trigger pulse length"); +} + +int t7_count=0; + +void t7cbf(unsigned gpio, unsigned level, uint32_t tick) +{ + if (level == PI_TIMEOUT) t7_count++; +} + +void t7() +{ + int c, oc; + + printf("Watchdog tests.\n"); + + /* type of edge shouldn't matter for watchdogs */ + callback(GPIO, FALLING_EDGE, t7cbf); + + set_watchdog(GPIO, 50); /* 50 ms, 20 per second */ + time_sleep(0.5); + oc = t7_count; + time_sleep(2); + c = t7_count - oc; + CHECK(7, 1, c, 39, 5, "set watchdog on count"); + + set_watchdog(GPIO, 0); /* 0 switches watchdog off */ + time_sleep(0.5); + oc = t7_count; + time_sleep(2); + c = t7_count - oc; + CHECK(7, 2, c, 0, 1, "set watchdog off count"); +} + +void t8() +{ + int v; + + printf("Bank read/write tests.\n"); + + gpio_write(GPIO, 0); + v = read_bank_1() & (1<= 0) text[b] = 0; + CHECK(10, 7, strcmp(TEXT, text), 0, 0, "serial read"); + + b = serial_read_byte(h); + CHECK(10, 8, b, 0xAA, 0, "serial read byte"); + + b = serial_read_byte(h); + CHECK(10, 9, b, 0x55, 0, "serial read byte"); + + b = serial_read_byte(h); + CHECK(10, 10, b, 0x00, 0, "serial read byte"); + + b = serial_read_byte(h); + CHECK(10, 11, b, 0xFF, 0, "serial read byte"); + + b = serial_data_available(h); + CHECK(10, 12, b, 0, 0, "serial data availabe"); + + e = serial_close(h); + CHECK(10, 13, e, 0, 0, "serial close"); +} + +void tb() +{ + int h, e, b, len; + char *exp; + char buf[128]; + + printf("SMBus / I2C tests."); + + /* this test requires an ADXL345 on I2C bus 1 addr 0x53 */ + + h = i2c_open(1, 0x53, 0); + CHECK(11, 1, h, 0, 0, "i2c open"); + + e = i2c_write_device(h, "\x00", 1); /* move to known register */ + CHECK(11, 2, e, 0, 0, "i2c write device"); + + b = i2c_read_device(h, buf, 1); + CHECK(11, 3, b, 1, 0, "i2c read device"); + CHECK(11, 4, buf[0], 0xE5, 0, "i2c read device"); + + b = i2c_read_byte(h); + CHECK(11, 5, b, 0xE5, 0, "i2c read byte"); + + b = i2c_read_byte_data(h, 0); + CHECK(11, 6, b, 0xE5, 0, "i2c read byte data"); + + b = i2c_read_byte_data(h, 48); + CHECK(11, 7, b, 2, 0, "i2c read byte data"); + + exp = "\x1D[aBcDeFgHjKM]"; + len = strlen(exp); + + e = i2c_write_device(h, exp, len); + CHECK(11, 8, e, 0, 0, "i2c write device"); + + e = i2c_write_device(h, "\x1D", 1); + b = i2c_read_device(h, buf, len-1); + CHECK(11, 9, b, len-1, 0, "i2c read device"); + CHECK(11, 10, strncmp(buf, exp+1, len-1), 0, 0, "i2c read device"); + + if (strncmp(buf, exp+1, len-1)) + printf("got [%.*s] expected [%.*s]\n", len-1, buf, len-1, exp+1); + + e = i2c_write_byte_data(h, 0x1d, 0xAA); + CHECK(11, 11, e, 0, 0, "i2c write byte data"); + + b = i2c_read_byte_data(h, 0x1d); + CHECK(11, 12, b, 0xAA, 0, "i2c read byte data"); + + e = i2c_write_byte_data(h, 0x1d, 0x55); + CHECK(11, 13, e, 0, 0, "i2c write byte data"); + + b = i2c_read_byte_data(h, 0x1d); + CHECK(11, 14, b, 0x55, 0, "i2c read byte data"); + + exp = "[1234567890#]"; + len = strlen(exp); + + e = i2c_write_block_data(h, 0x1C, exp, len); + CHECK(11, 15, e, 0, 0, "i2c write block data"); + + e = i2c_write_device(h, "\x1D", 1); + b = i2c_read_device(h, buf, len); + CHECK(11, 16, b, len, 0, "i2c read device"); + CHECK(11, 17, strncmp(buf, exp, len), 0, 0, "i2c read device"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + b = i2c_read_i2c_block_data(h, 0x1D, buf, len); + CHECK(11, 18, b, len, 0, "i2c read i2c block data"); + CHECK(11, 19, strncmp(buf, exp, len), 0, 0, "i2c read i2c block data"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + exp = "(-+=;:,<>!%)"; + len = strlen(exp); + + e = i2c_write_i2c_block_data(h, 0x1D, exp, len); + CHECK(11, 20, e, 0, 0, "i2c write i2c block data"); + + b = i2c_read_i2c_block_data(h, 0x1D, buf, len); + CHECK(11, 21, b, len, 0, "i2c read i2c block data"); + CHECK(11, 22, strncmp(buf, exp, len), 0, 0, "i2c read i2c block data"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + e = i2c_close(h); + CHECK(11, 23, e, 0, 0, "i2c close"); +} + +void tc() +{ + int h, x, b, e; + char buf[128]; + + printf("SPI tests."); + + /* this test requires a MCP3202 on SPI channel 1 */ + + h = spi_open(1, 50000, 0); + CHECK(12, 1, h, 0, 0, "spi open"); + + + for (x=0; x<5; x++) + { + sprintf(buf, "\x01\x80"); + b = spi_xfer(h, buf, buf, 3); + CHECK(12, 2, b, 3, 0, "spi xfer"); + if (b == 3) + { + time_sleep(1.0); + printf("%d ", ((buf[1]&0x0F)*256)|buf[2]); + } + } + + e = spi_close(h); + CHECK(12, 99, e, 0, 0, "spi close"); +} + + +int main(int argc, char *argv[]) +{ + int i, t, c, status; + + char test[64]={0,}; + + if (argc > 1) + { + t = 0; + + for (i=0; i +#include +#include +#include +#include +#include +#include + +#include "pigpiod_if2.h" + +#define GPIO 25 + +void CHECK(int t, int st, int got, int expect, int pc, char *desc) +{ + if ((got >= (((1E2-pc)*expect)/1E2)) && (got <= (((1E2+pc)*expect)/1E2))) + { + printf("TEST %2d.%-2d PASS (%s: %d)\n", t, st, desc, expect); + } + else + { + fprintf(stderr, + "TEST %2d.%-2d FAILED got %d (%s: %d)\n", + t, st, got, desc, expect); + } +} + +void t0(int pi) +{ + printf("\nTesting pigpiod C I/F 2\n"); + + printf("pigpio version %d.\n", get_pigpio_version(pi)); + + printf("Hardware revision %d.\n", get_hardware_revision(pi)); +} + +void t1(int pi) +{ + int v; + + printf("Mode/PUD/read/write tests.\n"); + + set_mode(pi, GPIO, PI_INPUT); + v = get_mode(pi, GPIO); + CHECK(1, 1, v, 0, 0, "set mode, get mode"); + + set_pull_up_down(pi, GPIO, PI_PUD_UP); + v = gpio_read(pi, GPIO); + CHECK(1, 2, v, 1, 0, "set pull up down, read"); + + set_pull_up_down(pi, GPIO, PI_PUD_DOWN); + v = gpio_read(pi, GPIO); + CHECK(1, 3, v, 0, 0, "set pull up down, read"); + + gpio_write(pi, GPIO, PI_LOW); + v = get_mode(pi, GPIO); + CHECK(1, 4, v, 1, 0, "write, get mode"); + + v = gpio_read(pi, GPIO); + CHECK(1, 5, v, 0, 0, "read"); + + gpio_write(pi, GPIO, PI_HIGH); + v = gpio_read(pi, GPIO); + CHECK(1, 6, v, 1, 0, "write, read"); + + v = pigpio_start(PI_DEFAULT_SOCKET_ADDR_STR, PI_DEFAULT_SOCKET_PORT_STR); + CHECK(1, 7, v, 31, 100, "pigpio_start with non-default arguments"); + pigpio_stop(v); +} + +int t2_count=0; + +void t2cb(int pi, unsigned gpio, unsigned level, uint32_t tick) +{ + t2_count++; +} + +void t2(int pi) +{ + int dc, f, r, rr, oc, id; + + printf("PWM dutycycle/range/frequency tests.\n"); + + set_PWM_range(pi, GPIO, 255); + set_PWM_frequency(pi, GPIO, 0); + f = get_PWM_frequency(pi, GPIO); + CHECK(2, 1, f, 10, 0, "set PWM range, set/get PWM frequency"); + + id = callback(pi, GPIO, EITHER_EDGE, t2cb); + + set_PWM_dutycycle(pi, GPIO, 0); + dc = get_PWM_dutycycle(pi, GPIO); + CHECK(2, 2, dc, 0, 0, "get PWM dutycycle"); + + time_sleep(0.5); /* allow old notifications to flush */ + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 3, f, 0, 0, "set PWM dutycycle, callback"); + + set_PWM_dutycycle(pi, GPIO, 128); + dc = get_PWM_dutycycle(pi, GPIO); + CHECK(2, 4, dc, 128, 0, "get PWM dutycycle"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 5, f, 40, 5, "set PWM dutycycle, callback"); + + set_PWM_frequency(pi, GPIO, 100); + f = get_PWM_frequency(pi, GPIO); + CHECK(2, 6, f, 100, 0, "set/get PWM frequency"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 7, f, 400, 1, "callback"); + + set_PWM_frequency(pi, GPIO, 1000); + f = get_PWM_frequency(pi, GPIO); + CHECK(2, 8, f, 1000, 0, "set/get PWM frequency"); + + time_sleep(0.2); + oc = t2_count; + time_sleep(2); + f = t2_count - oc; + CHECK(2, 9, f, 4000, 1, "callback"); + + r = get_PWM_range(pi, GPIO); + CHECK(2, 10, r, 255, 0, "get PWM range"); + + rr = get_PWM_real_range(pi, GPIO); + CHECK(2, 11, rr, 200, 0, "get PWM real range"); + + set_PWM_range(pi, GPIO, 2000); + r = get_PWM_range(pi, GPIO); + CHECK(2, 12, r, 2000, 0, "set/get PWM range"); + + rr = get_PWM_real_range(pi, GPIO); + CHECK(2, 13, rr, 200, 0, "get PWM real range"); + + set_PWM_dutycycle(pi, GPIO, 0); + + callback_cancel(id); +} + +int t3_reset=1; +int t3_count=0; +uint32_t t3_tick=0; +float t3_on=0.0; +float t3_off=0.0; + +void t3cbf(int pi, unsigned gpio, unsigned level, uint32_t tick) +{ + uint32_t td; + +// printf("pi=%d g=%d l=%d t=%u\n", pi, gpio, level, tick); + if (t3_reset) + { + t3_count = 0; + t3_on = 0.0; + t3_off = 0.0; + t3_reset = 0; + } + else + { + td = tick - t3_tick; + + if (level == 0) t3_on += td; + else t3_off += td; + } + + t3_count ++; + t3_tick = tick; +} + +void t3(int pi) +{ + int pw[3]={500, 1500, 2500}; + int dc[4]={20, 40, 60, 80}; + + int f, rr, v; + float on, off; + + int t, id; + + printf("PWM/Servo pulse accuracy tests.\n"); + + id = callback(pi, GPIO, EITHER_EDGE, t3cbf); + + for (t=0; t<3; t++) + { + set_servo_pulsewidth(pi, GPIO, pw[t]); + v = get_servo_pulsewidth(pi, GPIO); + CHECK(3, t+t+1, v, pw[t], 0, "get servo pulsewidth"); + + time_sleep(1); + t3_reset = 1; + time_sleep(4); + on = t3_on; + off = t3_off; + CHECK(3, t+t+2, (1000.0*(on+off))/on, 20000000.0/pw[t], 1, + "set servo pulsewidth"); + } + + set_servo_pulsewidth(pi, GPIO, 0); + set_PWM_frequency(pi, GPIO, 1000); + f = get_PWM_frequency(pi, GPIO); + CHECK(3, 7, f, 1000, 0, "set/get PWM frequency"); + + rr = set_PWM_range(pi, GPIO, 100); + CHECK(3, 8, rr, 200, 0, "set PWM range"); + + for (t=0; t<4; t++) + { + set_PWM_dutycycle(pi, GPIO, dc[t]); + v = get_PWM_dutycycle(pi, GPIO); + CHECK(3, t+t+9, v, dc[t], 0, "get PWM dutycycle"); + + time_sleep(1); + t3_reset = 1; + time_sleep(2); + on = t3_on; + off = t3_off; + CHECK(3, t+t+10, (1000.0*on)/(on+off), 10.0*dc[t], 1, + "set PWM dutycycle"); + } + + set_PWM_dutycycle(pi, GPIO, 0); + + callback_cancel(id); +} + +void t4(int pi) +{ + int h, e, f, n, s, b, l, seq_ok, toggle_ok; + gpioReport_t r; + char p[32]; + + printf("Pipe notification tests.\n"); + + set_PWM_frequency(pi, GPIO, 0); + set_PWM_dutycycle(pi, GPIO, 0); + set_PWM_range(pi, GPIO, 100); + + h = notify_open(pi); + + sprintf(p, "/dev/pigpio%d", h); + f = open(p, O_RDONLY); + + e = notify_begin(pi, h, (1< 0) text[c] = 0; /* null terminate string */ + CHECK(5, 11, strcmp(TEXT, text), 0, 0, "wave tx busy, serial read"); + + e = bb_serial_read_close(pi, GPIO); + CHECK(5, 12, e, 0, 0, "serial read close"); + + c = wave_get_micros(pi); + CHECK(5, 13, c, 6158148, 0, "wave get micros"); + + c = wave_get_high_micros(pi); + if (c > 6158148) c = 6158148; + CHECK(5, 14, c, 6158148, 0, "wave get high micros"); + + c = wave_get_max_micros(pi); + CHECK(5, 15, c, 1800000000, 0, "wave get max micros"); + + c = wave_get_pulses(pi); + CHECK(5, 16, c, 3405, 0, "wave get pulses"); + + c = wave_get_high_pulses(pi); + CHECK(5, 17, c, 3405, 0, "wave get high pulses"); + + c = wave_get_max_pulses(pi); + CHECK(5, 18, c, 12000, 0, "wave get max pulses"); + + c = wave_get_cbs(pi); + if (c < 6963) CHECK(5, 19, c, 6810, 0, "wave get cbs"); + else CHECK(5, 19, c, 7115, 0, "wave get cbs"); + + c = wave_get_high_cbs(pi); + if (c < 6963) CHECK(5, 20, c, 6810, 0, "wave get high cbs"); + else CHECK(5, 20, c, 7115, 0, "wave get high cbs"); + + c = wave_get_max_cbs(pi); + CHECK(5, 21, c, 25016, 0, "wave get max cbs"); + + callback_cancel(id); + + /* wave create and pad tests */ + id = callback(pi, GPIO, FALLING_EDGE, t5cbf); + e = wave_clear(pi); + + e = wave_add_generic(pi, 2, (gpioPulse_t[]) + { {1<= 0) text[b] = 0; + CHECK(10, 7, strcmp(TEXT, text), 0, 0, "serial read"); + + b = serial_read_byte(pi, h); + CHECK(10, 8, b, 0xAA, 0, "serial read byte"); + + b = serial_read_byte(pi, h); + CHECK(10, 9, b, 0x55, 0, "serial read byte"); + + b = serial_read_byte(pi, h); + CHECK(10, 10, b, 0x00, 0, "serial read byte"); + + b = serial_read_byte(pi, h); + CHECK(10, 11, b, 0xFF, 0, "serial read byte"); + + b = serial_data_available(pi, h); + CHECK(10, 12, b, 0, 0, "serial data availabe"); + + e = serial_close(pi, h); + CHECK(10, 13, e, 0, 0, "serial close"); +} + +void tb(int pi) +{ + int h, e, b, len; + char *exp; + char buf[128]; + + printf("SMBus / I2C tests."); + + /* this test requires an ADXL345 on I2C bus 1 addr 0x53 */ + + h = i2c_open(pi, 1, 0x53, 0); + CHECK(11, 1, h, 0, 0, "i2c open"); + + e = i2c_write_device(pi, h, "\x00", 1); /* move to known register */ + CHECK(11, 2, e, 0, 0, "i2c write device"); + + b = i2c_read_device(pi, h, buf, 1); + CHECK(11, 3, b, 1, 0, "i2c read device"); + CHECK(11, 4, buf[0], 0xE5, 0, "i2c read device"); + + b = i2c_read_byte(pi, h); + CHECK(11, 5, b, 0xE5, 0, "i2c read byte"); + + b = i2c_read_byte_data(pi, h, 0); + CHECK(11, 6, b, 0xE5, 0, "i2c read byte data"); + + b = i2c_read_byte_data(pi, h, 48); + CHECK(11, 7, b, 2, 0, "i2c read byte data"); + + exp = "\x1D[aBcDeFgHjKM]"; + len = strlen(exp); + + e = i2c_write_device(pi, h, exp, len); + CHECK(11, 8, e, 0, 0, "i2c write device"); + + e = i2c_write_device(pi, h, "\x1D", 1); + b = i2c_read_device(pi, h, buf, len-1); + CHECK(11, 9, b, len-1, 0, "i2c read device"); + CHECK(11, 10, strncmp(buf, exp+1, len-1), 0, 0, "i2c read device"); + + if (strncmp(buf, exp+1, len-1)) + printf("got [%.*s] expected [%.*s]\n", len-1, buf, len-1, exp+1); + + e = i2c_write_byte_data(pi, h, 0x1d, 0xAA); + CHECK(11, 11, e, 0, 0, "i2c write byte data"); + + b = i2c_read_byte_data(pi, h, 0x1d); + CHECK(11, 12, b, 0xAA, 0, "i2c read byte data"); + + e = i2c_write_byte_data(pi, h, 0x1d, 0x55); + CHECK(11, 13, e, 0, 0, "i2c write byte data"); + + b = i2c_read_byte_data(pi, h, 0x1d); + CHECK(11, 14, b, 0x55, 0, "i2c read byte data"); + + exp = "[1234567890#]"; + len = strlen(exp); + + e = i2c_write_block_data(pi, h, 0x1C, exp, len); + CHECK(11, 15, e, 0, 0, "i2c write block data"); + + e = i2c_write_device(pi, h, "\x1D", 1); + b = i2c_read_device(pi, h, buf, len); + CHECK(11, 16, b, len, 0, "i2c read device"); + CHECK(11, 17, strncmp(buf, exp, len), 0, 0, "i2c read device"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + b = i2c_read_i2c_block_data(pi, h, 0x1D, buf, len); + CHECK(11, 18, b, len, 0, "i2c read i2c block data"); + CHECK(11, 19, strncmp(buf, exp, len), 0, 0, "i2c read i2c block data"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + exp = "(-+=;:,<>!%)"; + len = strlen(exp); + + e = i2c_write_i2c_block_data(pi, h, 0x1D, exp, len); + CHECK(11, 20, e, 0, 0, "i2c write i2c block data"); + + b = i2c_read_i2c_block_data(pi, h, 0x1D, buf, len); + CHECK(11, 21, b, len, 0, "i2c read i2c block data"); + CHECK(11, 22, strncmp(buf, exp, len), 0, 0, "i2c read i2c block data"); + + if (strncmp(buf, exp, len)) + printf("got [%.*s] expected [%.*s]\n", len, buf, len, exp); + + e = i2c_close(pi, h); + CHECK(11, 23, e, 0, 0, "i2c close"); +} + +void tc(int pi) +{ + int h, x, b, e; + char buf[128]; + + printf("SPI tests."); + + /* this test requires a MCP3202 on SPI channel 1 */ + + h = spi_open(pi, 1, 50000, 0); + CHECK(12, 1, h, 0, 0, "spi open"); + + + for (x=0; x<5; x++) + { + sprintf(buf, "\x01\x80"); + b = spi_xfer(pi, h, buf, buf, 3); + CHECK(12, 2, b, 3, 0, "spi xfer"); + if (b == 3) + { + time_sleep(1.0); + printf("%d ", ((buf[1]&0x0F)*256)|buf[2]); + } + } + + e = spi_close(pi, h); + CHECK(12, 99, e, 0, 0, "spi close"); +} + + +int main(int argc, char *argv[]) +{ + int i, t, c, pi; + + char test[64]={0,}; + + if (argc > 1) + { + t = 0; + + for (i=0; i/dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 h /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 p /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 -a v /dev/pigpio +read -t 1 s /dev/pigpio +sleep 0.1 +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 w /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +echo "tick" >/dev/pigpio +read -t 1 t1 /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 w /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s /dev/pigpio +read -t 1 s +#include + +/** + + +---------+ +---------+ 0 + | | | | + A | | | | + | | | | + +---------+ +---------+ +----- 1 + + +---------+ +---------+ 0 + | | | | + B | | | | + | | | | + ----+ +---------+ +---------+ 1 + +*/ + +pigRotaryDial::pigRotaryDial() +{ + +} + +pigRotaryDial::pigRotaryDial( pigpio::bcm_t bcmButton, pigpio::bcm_t bcmUp, pigpio::bcm_t bcmDown ) +{ + init( bcmButton, bcmDown, bcmUp ); +} + + +pigRotaryDial::~pigRotaryDial() +{ + +} + + +void pigRotaryDial::init( pigpio::bcm_t bcmButton, pigpio::bcm_t bcmUp, pigpio::bcm_t bcmDown ) +{ + + pigButton::init( bcmButton ); + /* + _pinButton.init( bcmButton, pull_up ); + _pinButton.set_callback( this, falling ); + _pinButton.set_glitch_filter( 500 ); + */ + + _pinUp.init( bcmUp, pull_up ); + _pinUp.set_callback( this ); + _pinUp.set_glitch_filter( 500 ); + + _pinDown.init( bcmDown, pull_up ); + _pinDown.set_callback( this ); + _pinDown.set_glitch_filter( 500 ); + + _oldState = ( _pinUp.get_level() << 1 ) | _pinDown.get_level(); + +} + + +void pigRotaryDial::reset() +{ + _state = false; + _value = 0; +} + + + +void pigRotaryDial::trigger( pigpio::bcm_t bcm, uint32_t level ) +{ + + //std::cout << " -- pigRotaryDial::trigger: " << (uint32_t) bcm << " : " << level << std::endl; + + if( level == pigpio::TimeOut ) + return; + + if( bcm ==_pinIn.bcm ) + { + std::cout << "pigButton::trigger " << (uint32_t) bcm << " : " << level << std::endl; + // simply on/off + toggle_state(); + return; + } + + if( bcm ==_pinUp.bcm ) + _levUp = level; + else + _levDown = level; + + int newState = _levUp << 1 | _levDown; + int inc = Transits[ _oldState << 2 | newState ]; + + if( inc ) + { + //std::cout << "dial: " << inc << std::endl; + _oldState = newState; + //int detent = _step / 4; + _value += inc; + + //if( detent != ( _step / 4) ) + // handlePulse( _step / 4 ); + //handlePulse( _step ); + + /// gültigkeit sicherstellen + //_step = qBound( 0, _step, 100 ); + //emit valueChanged( _step ); + sigValue( _value ); + } + +} diff --git a/pigrotarydial.h b/pigrotarydial.h new file mode 100644 index 0000000..8910eed --- /dev/null +++ b/pigrotarydial.h @@ -0,0 +1,73 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGROTARYDIAL_H +#define PIGROTARYDIAL_H + + +#include +#include + + +/** + * @brief The pigRotaryDial class + * + * TODO: flags: step oder detent, inc/dec oder value, set_range range_stop: bis 100 oder 100->0 + * + */ + +class LIBPIGPIO_EXPORT pigRotaryDial : public pigButton, public pigValue +{ + +public: + + pigRotaryDial(); + explicit pigRotaryDial( pigpio::bcm_t bcmButton, pigpio::bcm_t bcmUp, pigpio::bcm_t bcmDown ); + virtual ~pigRotaryDial(); + + void init( pigpio::bcm_t bcmButton, pigpio::bcm_t bcmUp, pigpio::bcm_t bcmDown ); + + virtual void reset(); + +protected: + + void trigger( pigpio::bcm_t bcm, uint32_t level ) override; + + constexpr const static int Transits[16]= + { + /* 0000 0001 0010 0011 0100 0101 0110 0111 */ + 0, -1, 1, 0, 1, 0, 0, -1, + /* 1000 1001 1010 1011 1100 1101 1110 1111 */ + -1, 0, 0, 1, 0, 1, -1, 0 + }; + + pigPinIn _pinDown; + pigPinIn _pinUp; + + int _levUp = 0; + int _levDown = 0; + int _oldState = -1; + +}; + + +#endif // PIGROTARYDIAL_H diff --git a/pigsonar.cpp b/pigsonar.cpp new file mode 100644 index 0000000..b711305 --- /dev/null +++ b/pigsonar.cpp @@ -0,0 +1,215 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + + pigSonar based on: https://github.com/OmarAflak/HC-SR04-Raspberry-Pi-C- + +***************************************************************************/ + + +#include +#include + +/** + * @brief pigSonar::pigSonar + * + * + * Beschreibung HC-SR04: + * Das Ultraschall Modul HC-SR04 eignet sich zur + * Entfernungsmessung im Bereich zwischen 2cm und ca. + * 3m mit einer Auflösung von 3mm. Es benötigt nur eine + * einfache Versorgungsspannung von 5V bei einer + * Stromaufnahme von <2mA. Nach Triggerung mit einer + * fallenden Flanke (TTL - Pegel) misst das Modul + * selbstständig die Entfernung und wandelt diese in ein + * PWM Signal welches am Ausgang zur Verfügung steht. + * Ein Messintervall hat eine Dauer von 20ms. Es können + * also 50 Messungen pro Sekunde durchgeführt werden + * + * https://www.mikrocontroller.net/attachment/218122/HC-SR04_ultraschallmodul_beschreibung_3.pdf + */ + +pigSonar::pigSonar() +{ + +} + + +pigSonar::pigSonar( pigpio::bcm_t trigger, pigpio::bcm_t echo ) +{ + init( trigger, echo ); +} + + +pigSonar::~pigSonar() +{ + //detach_pin( ) //?? doch wg .callback +} + + +void pigSonar::init( pigpio::bcm_t trigger, pigpio::bcm_t echo ) +{ + + _pinEcho.init( echo ); + //_pinEcho.set_callback( this, rising ); + + _pinTrig.init( trigger ); + _pinTrig.set_level( low ); + + delay_millis( 500 ); + +} + +void pigSonar::stop() +{ + _active = false; +} + +void pigSonar::start( double thresh ) +{ + _active = true; + std::thread thrd( + [=]() + { + while( _active ) + { + double dist = distance(); + if( dist < thresh ) + sigValue( dist ); + delay_millis( 50 ); + } + + } ); + thrd.detach(); + +} + + +double pigSonar::distance( int timeout ) +{ + + // erholungspause + delay_millis( 10 ); + + // ein 10 ms pulse löst die messung aus + _pinTrig.set_level( high ); + delay_micros( 10 ); + _pinTrig.set_level( low ); + + //_timer.start(); + _now = get_current_tick(); + // busy waiting ?? + while ( _pinEcho.get_level() == low && _timer.elapsed_millis() < timeout ) + //while ( _pinEcho.get_level() == low ) + ; + + //_timer.start(); + _now = get_current_tick(); + while( _pinEcho.get_level() == high ) + ; + + uint32_t tof = get_current_tick() - _now; + //double tof = _timer.elapsed_micros(); + _dist = 100 * ( ( tof /1000000.0 ) * 340.29 ) / 2; + + return _dist; +} + +/* +void pigSonar::trigger( pigpio::bcm_t bcm, uint32_t level ) +{ + double duration = _timer.elapsed_micros(); + // Convert the time into a distance + _dist = (duration/2) / 29.1; // Divide by 29.1 or multiply by 0.0343 + //double inches = (duration/2) / 74; // Divide by 74 or multiply by 0.0135 + +} +*/ + +/** + + Die Variante mit WiringPi ist erheblich genauer. Warum? Timer? + Code: https://github.com/OmarAflak/HC-SR04-Raspberry-Pi-C- + + dort: + + Distance is 27.4614 cm. + Distance is 27.4614 cm. + Distance is 27.4614 cm. + Distance is 27.4614 cm. + Distance is 27.4784 cm. + Distance is 27.4784 cm. + Distance is 27.4614 cm. + Distance is 27.4784 cm. + Distance is 27.4614 cm. + Distance is 27.4784 cm. + Distance is 27.4614 cm. + Distance is 27.4784 cm. + Distance is 27.4614 cm. + + hier (busy wait): + + distance: 28.21 + distance: 25.9811 + distance: 28.3121 + distance: 28.2441 + distance: 28.4482 + distance: 27.9889 + distance: 28.0569 + distance: 28.0059 + distance: 28.2441 + distance: 25.3346 + distance: 28.0059 + distance: 29.0608 + distance: 27.9718 + distance: 28.0399 + distance: 27.9889 + + +Die eigene Variante _ohne_ busy wating mit callback ist logischerweise +auch nicht besser. + +double Sonar::distance(int timeout) +{ + delay(10); + + digitalWrite(trigger, HIGH); + delayMicroseconds(10); + digitalWrite(trigger, LOW); + + now=micros(); + + while (digitalRead(echo) == LOW && micros()-now +#include +#include +#include +#include + + +class LIBPIGPIO_EXPORT pigSonar : public pigNode, public pigValue +{ + + +public: + + pigSonar(); + pigSonar( pigpio::bcm_t trigger, pigpio::bcm_t echo ); + virtual ~pigSonar(); + + void init( pigpio::bcm_t trigger, pigpio::bcm_t echo ); + + void stop(); + void start( double thresh = 50000 ); + + double distance( int timeout=10 ); + +protected: + + pigPinOut _pinTrig; + pigPinIn _pinEcho; + + pigChrono _timer; + double _dist; + uint32_t _now, _lst; + bool _active = false; + +}; + + + +#endif // PIGSONAR_H diff --git a/pigstate.cpp b/pigstate.cpp new file mode 100644 index 0000000..78edf9e --- /dev/null +++ b/pigstate.cpp @@ -0,0 +1,67 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include + + +pigState::pigState( bool state ) + : _state{ state } +{ + +} + + +bool pigState::state() +{ + return _state; +} + + +void pigState::set_state( bool newState ) +{ + _state = newState; +} + +void pigState::toggle_state() +{ + change_state( !state() ); +} + +/* +void pigState::change_state( bool newState ) +{ + if( newState == state() ) + return; + set_state( newState ); + sigState( _state ); +} +*/ + + +/* +void pigState::connect( pigState& listener ) +{ + sigState.connect( [&](bool state) { listener.change_state( state ); } ); +} +*/ + diff --git a/pigstate.h b/pigstate.h new file mode 100644 index 0000000..3e70829 --- /dev/null +++ b/pigstate.h @@ -0,0 +1,107 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGSTATE_H +#define PIGSTATE_H + +#include +#include + + +/** + * @brief The pigState class + * set_state ist passiv; change_state kann von 'innen' (per Gui) _oder_ von 'aussen' + * (elektrisch) kommen, je nach Zweck der implementierung ... + */ + +class LIBPIGPIO_EXPORT pigState +{ + +public: + + signalBool sigState; + + pigState() = default; + explicit pigState( bool astate ); + virtual ~pigState() = default; + + bool state(); + virtual void set_state( bool newState ); + void toggle_state(); + + // passiv (empfänger) oder aktiv (sender): + // die implemetierung entscheidet + virtual void change_state( bool newState ) = 0; + + template< typename T > + void connect_state( T& listener ) + { + //sigState.connect( [&](bool state) { T::change_state( state ); } ); + sigState.connect( &T::change_state, &listener ); + } + +protected: + + bool _state = false; + +}; + +template< typename V> +class LIBPIGPIO_EXPORT pigRec +{ + +public: + + virtual void change_x( V newValue ) + { + std::cout << "pigRec:" << newValue << std::endl; + } + +}; + +template< typename V> +class LIBPIGPIO_EXPORT pigFykz +{ + + +public: + + sigslot::signal sigFykz; + + virtual void change_x( V newValue ) + { + std::cout << "pigFykz: " << newValue << std::endl; + } + + template< typename T > + void connect_x( T& listener ) + { + //sigState.connect( [&](bool state) { T::change_state( state ); } ); + sigFykz.connect( &T::change_x, &listener ); + } + +}; + + + + +#endif // PIGSTATE_H diff --git a/pigtimer.cpp b/pigtimer.cpp new file mode 100644 index 0000000..23a6911 --- /dev/null +++ b/pigtimer.cpp @@ -0,0 +1,140 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#include +#include +#include + +#include + + +pigTimer::pigTimer() +{ + +} + +pigTimer::pigTimer( int timeOn, int timeOff, int repcnt ) + : _timeOn{ timeOn }, _timeOff{ timeOff }, _repcnt{ repcnt } +{ + if( !_timeOff ) + _timeOff = _timeOn; +} + + +pigTimer::~pigTimer() +{ + +} + +void pigTimer::change_state( bool newState ) +{ + set_state( newState ); +} + +int pigTimer::timeOn() +{ + return _timeOn; +} + + +void pigTimer::setTimeOn( int timeOn ) +{ + _timeOn = timeOn; + // reset?? +} + + +int pigTimer::timeOff() +{ + return _timeOff; +} + + +void pigTimer::setTimeOff( int timeOff ) +{ + _timeOff = timeOff; +} + + +int pigTimer::repetitions() +{ + return _repcnt; +} + + +void pigTimer::setRepetitions( int repcnt ) +{ + _repcnt = repcnt; +} + + +void pigTimer::start() +{ + _active = true; + // ewig + if( _repcnt < 1 ) + { + while( _active ) + sleepCycle(); + return; + } + + // abgezählt + for( int i=0; i<_repcnt; ++i ) + sleepCycle(); + +} + + +void pigTimer::stop() +{ + _active = false; +} + + +void pigTimer::sleepCycle() +{ + + sleepThread( _timeOff ); + + if( !_active ) + return; + + sleepThread( _timeOn ); + + +} +void pigTimer::sleepThread( int delay ) +{ + std::thread thrd( + [=]() + { + if( !_active ) + return; + + std::this_thread::sleep_for( std::chrono::milliseconds( delay ) ); + + toggle_state(); + + } ); + thrd.detach(); +} diff --git a/pigtimer.h b/pigtimer.h new file mode 100644 index 0000000..b761f7c --- /dev/null +++ b/pigtimer.h @@ -0,0 +1,68 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGTIMER_H +#define PIGTIMER_H + +#include +#include + + +class LIBPIGPIO_EXPORT pigTimer : public pigState +{ + +public: + + pigTimer(); + pigTimer( int timeOn, int timeOff = 0, int repcnt = -1 ); + virtual ~pigTimer(); + + void change_state( bool newState ) override; + + int timeOn(); + void setTimeOn( int timeOn ); + + int timeOff(); + void setTimeOff( int timeOff ); + + void setRepetitions( int repcnt ); + int repetitions(); + + void start(); + void stop(); + +protected: + + void sleepCycle(); + void sleepThread( int delay ); + + int _timeOn = 0; + int _timeOff = 0; + + bool _active = false; + int _repcnt = -1; + int _count = 0; + +}; + +#endif // PIGTIMER_H + diff --git a/pigvalue.cpp b/pigvalue.cpp new file mode 100644 index 0000000..4164cbe --- /dev/null +++ b/pigvalue.cpp @@ -0,0 +1,22 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + diff --git a/pigvalue.h b/pigvalue.h new file mode 100644 index 0000000..2e8af86 --- /dev/null +++ b/pigvalue.h @@ -0,0 +1,84 @@ +/***************************************************************************** + + source::worx libPiGPio + Copyright © 2022 c.holzheuer + chris@sourceworx.org + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + Uses: + + pigpiod_if2 by joan2937, pigpio @ abyz.me.uk + https://abyz.me.uk/rpi/pigpio + + sigslot by 2017 Pierre-Antoine Lacaze + https://github.com/palacaze/sigslot + +***************************************************************************/ + + +#ifndef PIGVALUE_H +#define PIGVALUE_H + + +#include + +//class rangeVal + +template +class LIBPIGPIO_EXPORT pigValue +{ + +public: + + sigslot::signal sigValue; + + pigValue() = default; + pigValue( T val ) + : _value( val ) + { + + } + virtual ~pigValue() = default; + + T value() + { + return _value; + } + + void set_value( T value ) + { + _value = value; + } + + void change_value( T value ) + { + set_value( value ); + // emit ... + } + + template< typename V > + void connect_value( V& listener ) + { + //sigState.connect( [&](bool state) { T::change_state( state ); } ); + sigValue.connect( &V::change_value, &listener ); + } + /* + template< typename O > + void add_value_observer( O* target ) + { + signal.connect( &O::on_value_changed, target ); + } + */ + + +protected: + + T _value = T(); + +}; + +#endif // PIGVALUE_H diff --git a/qrc_QtGPIO.cpp b/qrc_QtGPIO.cpp new file mode 100644 index 0000000..356fa59 --- /dev/null +++ b/qrc_QtGPIO.cpp @@ -0,0 +1,5533 @@ +/**************************************************************************** +** Resource object code +** +** Created by: The Resource Compiler for Qt version 5.15.2 +** +** WARNING! All changes made in this file will be lost! +*****************************************************************************/ + +static const unsigned char qt_resource_data[] = { + // /home/pi/share/projects.nxt/libPiGPIO/images/Red.png + 0x0,0x0,0x64,0x81, + 0x89, + 0x50,0x4e,0x47,0xd,0xa,0x1a,0xa,0x0,0x0,0x0,0xd,0x49,0x48,0x44,0x52,0x0, + 0x0,0x1,0x5c,0x0,0x0,0x1,0x5c,0x8,0x6,0x0,0x0,0x0,0x84,0x16,0x6,0x2c, + 0x0,0x0,0x0,0x6,0x62,0x4b,0x47,0x44,0x0,0xff,0x0,0xff,0x0,0xff,0xa0,0xbd, + 0xa7,0x93,0x0,0x0,0x20,0x0,0x49,0x44,0x41,0x54,0x78,0x9c,0xec,0xbd,0x79,0x7c, + 0xdc,0xc6,0x79,0xff,0xff,0x19,0x2c,0x76,0x97,0x87,0x48,0xf1,0x14,0x75,0x53,0x92, + 0xf,0xc9,0x92,0x25,0xdf,0x87,0x6c,0x99,0x5a,0x5a,0xbe,0xe4,0xc6,0x76,0x8e,0xda, + 0x71,0x93,0xfa,0x9b,0xe4,0x97,0x3a,0x6e,0x8e,0x6f,0xea,0x36,0x69,0xd3,0xf4,0x9b, + 0xc3,0x71,0x8e,0xa6,0x39,0xed,0xa4,0x75,0x73,0xd8,0x89,0x73,0xd9,0x8e,0x9d,0xb4, + 0x69,0x1c,0xdf,0x4e,0xac,0xf8,0xa8,0x64,0x59,0xb4,0x24,0x4a,0xb4,0x2c,0x59,0x96, + 0x48,0x89,0x12,0xcf,0xbd,0x48,0xee,0xd,0x60,0x7e,0x7f,0x2c,0xb1,0xc2,0x62,0xb1, + 0xbb,0x0,0x16,0x58,0x80,0xe4,0xbc,0x5f,0x2f,0xbd,0x34,0xc4,0xe,0x6,0xf,0x30, + 0xc0,0x7,0xf,0x66,0x9e,0x99,0x21,0x60,0x30,0xaa,0x7,0xd9,0xb8,0x71,0xe3,0x62, + 0x9e,0xe7,0x5b,0x25,0x49,0x6a,0xe5,0x38,0xae,0x15,0x40,0x3b,0xa5,0xb4,0x85,0x52, + 0xda,0x4a,0x8,0x69,0x5,0x20,0xff,0xf3,0x2,0x0,0xa5,0x74,0x9e,0x9c,0x6,0xd0, + 0x0,0x80,0xd7,0x28,0x77,0x12,0x80,0x40,0x29,0xcd,0xa5,0xa7,0xf7,0x9d,0x24,0x84, + 0x8c,0x53,0x4a,0xc7,0x9,0x21,0x41,0x42,0x48,0x50,0x92,0xa4,0xa0,0x9c,0x16,0x4, + 0x21,0x98,0x48,0x24,0x4e,0xf6,0xf6,0xf6,0xc6,0xec,0x3d,0x6d,0x6,0x23,0xb,0x71, + 0xda,0x0,0xc6,0xac,0x82,0xdb,0xb4,0x69,0xd3,0xa,0x0,0xab,0x0,0xac,0xe2,0x38, + 0x6e,0x15,0x80,0x55,0x94,0x52,0xf9,0xff,0x66,0xbd,0x5,0x4d,0x8b,0xa7,0x6e,0x8c, + 0xe4,0xd7,0xc8,0x9b,0x4,0x70,0x12,0xc0,0x11,0x0,0x47,0x8,0x21,0x47,0x28,0xa5, + 0x47,0x24,0x49,0x3a,0xc2,0xf3,0xfc,0xa1,0x57,0x5e,0x79,0x65,0xd2,0x90,0x31,0xc, + 0x46,0x11,0x98,0xe0,0x32,0x4c,0x71,0xcd,0x35,0xd7,0xd4,0x27,0x12,0x89,0x75,0x0, + 0xce,0x1,0xb0,0x7e,0xfa,0xdf,0x6,0x0,0x2d,0x5a,0xf9,0x2b,0x14,0x44,0x4b,0xf2, + 0x9a,0x2c,0x5b,0x0,0xf0,0x16,0x80,0xde,0xe9,0x7f,0xfb,0x0,0xec,0xdb,0xb1,0x63, + 0x47,0xbf,0xa1,0x3,0x33,0x18,0x60,0x82,0xcb,0xd0,0xc1,0xa6,0x4d,0x9b,0x9a,0x39, + 0x8e,0xdb,0x8,0xe0,0x62,0x0,0x67,0x53,0x4a,0xcf,0x41,0xd6,0x8b,0xe5,0xf4,0xec, + 0xef,0x6,0xb1,0xb5,0x41,0x98,0xa3,0x98,0x16,0x5f,0x0,0xbb,0x5,0x41,0xd8,0xbe, + 0x6b,0xd7,0xae,0x37,0x0,0x48,0x86,0xe,0xc4,0x98,0x53,0x30,0xc1,0x65,0xa8,0xe1, + 0x36,0x6d,0xda,0x74,0x1e,0xc7,0x71,0x9b,0x0,0x5c,0xe,0x60,0x13,0x80,0x45,0xf2, + 0x8f,0x2e,0xf3,0x3e,0x1d,0xcd,0xab,0x91,0x3f,0xe,0x60,0x37,0x80,0x1e,0x4a,0xe9, + 0xcb,0x0,0xfe,0xb4,0x73,0xe7,0xce,0xa0,0xa1,0x2,0x19,0xb3,0x1a,0x26,0xb8,0xc, + 0x74,0x75,0x75,0x9d,0x45,0x29,0xbd,0x8e,0xe3,0xb8,0x2e,0x4a,0xe9,0x65,0x0,0x16, + 0x68,0xe5,0x73,0xa9,0xc8,0xb9,0xd9,0xe,0x1,0xc0,0x1e,0x0,0xaf,0x50,0x4a,0x9f, + 0x4f,0x26,0x93,0x2f,0xb0,0xe,0xba,0xb9,0xd,0x13,0xdc,0x39,0xc8,0x15,0x57,0x5c, + 0xb1,0x88,0xe3,0xb8,0x1b,0x28,0xa5,0x57,0x1,0x8,0x0,0x68,0x2f,0xb7,0x8f,0x1b, + 0x44,0x6e,0x16,0x8,0xb3,0x88,0xac,0x0,0x3f,0x4f,0x8,0xf9,0xc3,0xab,0xaf,0xbe, + 0xfa,0xbf,0x60,0x4d,0x10,0x73,0xa,0x26,0xb8,0x73,0x84,0xee,0xee,0xee,0x73,0x28, + 0xa5,0x5b,0x25,0x49,0xba,0xe,0xc0,0x65,0x38,0x15,0x6a,0x55,0x92,0x59,0x20,0x72, + 0x6e,0xce,0x7b,0x9c,0x10,0xf2,0x34,0x80,0x67,0x78,0x9e,0x7f,0x96,0x45,0x43,0xcc, + 0x7e,0x98,0xe0,0xce,0x5e,0x48,0x20,0x10,0xb8,0x9c,0x52,0x7a,0x33,0x80,0x77,0x3, + 0x58,0xa,0xb8,0x43,0x88,0x98,0x1d,0x9a,0x79,0x45,0x0,0x3b,0x0,0x3c,0x26,0x8, + 0xc2,0x43,0xbb,0x77,0xef,0x1e,0xd3,0x5d,0x0,0x63,0xc6,0xc0,0x4,0x77,0x76,0xa1, + 0x14,0xd9,0x77,0x2,0x58,0xae,0xfc,0xd1,0xd,0xe2,0xe2,0x16,0x3b,0x5c,0x6e,0xb3, + 0x8,0xe0,0x5,0x42,0xc8,0x2f,0x44,0x51,0xfc,0x9f,0x9e,0x9e,0x9e,0xa8,0xee,0x2, + 0x19,0xae,0x86,0x9,0xee,0x2c,0xa0,0xab,0xab,0x6b,0x19,0x21,0xe4,0x83,0x0,0x6e, + 0x1,0x70,0xb6,0xfa,0x77,0x97,0x8b,0x8b,0xab,0xed,0x70,0xda,0x66,0x42,0xc8,0x14, + 0x80,0xc7,0x45,0x51,0xfc,0xd5,0xaa,0x55,0xab,0x9e,0x7e,0xec,0xb1,0xc7,0x44,0x43, + 0x6,0x31,0x5c,0x5,0x13,0xdc,0x19,0xca,0xc6,0x8d,0x1b,0x6b,0x7d,0x3e,0xdf,0x6d, + 0x0,0x3e,0x2,0xe0,0x82,0x62,0xf9,0x9c,0x16,0xc,0xbb,0xf3,0xba,0xc5,0x8e,0x6a, + 0xd8,0x4c,0x8,0x9,0x53,0x4a,0x1f,0x3,0xf0,0xfd,0x5d,0xbb,0x76,0xed,0x37,0x74, + 0x40,0x86,0x2b,0x60,0x82,0x3b,0xc3,0xb8,0xe2,0x8a,0x2b,0x36,0x70,0x1c,0xf7,0x71, + 0x64,0xbd,0xd9,0xa6,0x52,0x79,0xdd,0x26,0x18,0x4e,0xe6,0x9d,0x6d,0x76,0x10,0x42, + 0x7a,0x0,0xfc,0x48,0x92,0xa4,0x5f,0xf6,0xf4,0xf4,0xc4,0xd,0x19,0xc0,0x70,0xc, + 0x26,0xb8,0x33,0x80,0x9b,0x6f,0xbe,0xd9,0x33,0x36,0x36,0xf6,0x2e,0x4a,0xe9,0x47, + 0x0,0x6c,0x81,0x8e,0x11,0x5e,0xb3,0x49,0x5c,0xaa,0x99,0x77,0x6,0xda,0x31,0x44, + 0x29,0x7d,0x50,0x92,0xa4,0x1f,0xee,0xde,0xbd,0x7b,0xc0,0xd0,0x1,0x18,0x55,0x87, + 0x9,0xae,0x8b,0xd9,0xb2,0x65,0x4b,0xab,0x28,0x8a,0xff,0x97,0x52,0xfa,0xb7,0x0, + 0x3a,0xf4,0xee,0xe7,0x6,0xc1,0x98,0xe5,0x22,0xe7,0x9a,0xbc,0x8a,0xfc,0x12,0x80, + 0x27,0x39,0x8e,0xbb,0xf7,0xb5,0xd7,0x5e,0x7b,0xde,0x50,0x1,0x8c,0xaa,0xc1,0x4, + 0xd7,0x85,0x4,0x2,0x81,0x35,0x94,0xd2,0xbf,0x27,0x84,0xbc,0x9f,0x52,0x5a,0xaf, + 0x77,0xbf,0x39,0x24,0x2e,0xcc,0x8e,0xd2,0x79,0x77,0x13,0x42,0xee,0xa1,0x94,0x3e, + 0xdc,0xd3,0xd3,0x93,0xd1,0x5d,0x20,0xc3,0x76,0x98,0xe0,0xba,0x88,0x40,0x20,0x70, + 0x15,0x80,0xbf,0xa3,0x94,0x5e,0x4f,0x8,0xe1,0xdc,0xf0,0x50,0xdb,0x59,0xf6,0x4c, + 0xb4,0x63,0x86,0xd9,0x3c,0x44,0x8,0xf9,0x51,0x2a,0x95,0xba,0x77,0xdf,0xbe,0x7d, + 0x61,0xdd,0x85,0x33,0x6c,0x83,0x9,0xae,0xb,0x8,0x4,0x2,0x97,0x2,0xb8,0x1b, + 0xc0,0xd5,0xf2,0x36,0x37,0x8,0xc6,0xc,0x13,0x17,0x57,0xd9,0xe1,0x32,0x9b,0xc7, + 0x29,0xa5,0xdf,0x12,0x45,0xf1,0xdf,0xd9,0x5c,0xe,0xce,0xc2,0x4,0xd7,0x41,0xba, + 0xbb,0xbb,0x37,0x53,0x4a,0xbf,0x8a,0xec,0xac,0x5c,0x0,0x5c,0xf7,0xa0,0x3a,0x5e, + 0x36,0xb3,0xd9,0xba,0xb2,0x29,0xa5,0x21,0x42,0xc8,0xf7,0xbd,0x5e,0xef,0x77,0x5e, + 0x7d,0xf5,0xd5,0x9,0x43,0x7,0x66,0x58,0x2,0x13,0x5c,0x7,0x8,0x4,0x2,0x17, + 0x2,0xf8,0x57,0x0,0x57,0x29,0xb7,0xbb,0xf5,0x41,0x9d,0x6d,0x76,0x30,0x9b,0xb3, + 0x1e,0x6f,0x4d,0x4d,0xcd,0xf7,0xb6,0x6f,0xdf,0x9e,0x30,0x54,0x30,0xa3,0x22,0x98, + 0xe0,0x56,0x91,0xae,0xae,0xae,0xf3,0x38,0x8e,0xfb,0x6,0x54,0x42,0xb,0x30,0xc1, + 0x70,0xa3,0x1d,0x33,0xd1,0x66,0x83,0xf9,0x47,0x29,0xa5,0xdf,0x99,0x3f,0x7f,0xfe, + 0xbd,0xdb,0xb6,0x6d,0x4b,0x1a,0x3a,0x8,0xc3,0x14,0x4c,0x70,0xab,0xc0,0xb5,0xd7, + 0x5e,0xdb,0x92,0x4e,0xa7,0xef,0xa2,0x94,0x7e,0x14,0x1a,0x8b,0x20,0xce,0xc0,0x7, + 0xd5,0x92,0xbc,0x94,0x52,0x88,0xa2,0x8,0x51,0x14,0x21,0x8,0x2,0x24,0x49,0xca, + 0xfd,0x2f,0x8a,0x62,0x6e,0x3f,0x51,0x14,0x41,0x8,0x1,0xa5,0x14,0x92,0x54,0x38, + 0x9b,0xa1,0xc7,0xe3,0x1,0x0,0x10,0x42,0x40,0x8,0xc9,0x6d,0xf3,0x78,0x3c,0xe0, + 0x38,0x2e,0xf7,0xbf,0x32,0x5d,0x8d,0xf3,0xab,0x76,0xd9,0x15,0xd8,0xf1,0x86,0x24, + 0x49,0x7f,0xbf,0x77,0xef,0xde,0x67,0xd,0x15,0xc0,0x30,0xc,0x13,0x5c,0x1b,0xd9, + 0xba,0x75,0xab,0x3f,0x91,0x48,0x7c,0x16,0xc0,0xa7,0x1,0x68,0x86,0x77,0xb9,0xe1, + 0xe1,0xb3,0x4b,0x30,0x4,0x41,0x40,0x3a,0x9d,0x86,0x20,0x8,0xc8,0x64,0x32,0xb9, + 0x7f,0xf2,0xdf,0x7a,0xcb,0x91,0x45,0xd4,0xaa,0x7c,0x0,0xe0,0xf5,0x7a,0xc1,0xf3, + 0x3c,0x3c,0x1e,0xf,0x78,0x9e,0xcf,0xfb,0xe7,0xf1,0x78,0x74,0x97,0x35,0x13,0xc5, + 0xb6,0x58,0x5e,0x42,0xc8,0xb,0x0,0xee,0x7c,0xfd,0xf5,0xd7,0x7b,0x75,0x17,0xc6, + 0x30,0x4,0x13,0x5c,0x9b,0xd8,0xbc,0x79,0xf3,0xcd,0x84,0x90,0xaf,0x1,0x38,0x5d, + 0xeb,0xf7,0xd9,0xf4,0xa0,0xa6,0xd3,0x69,0xa4,0x52,0x29,0xa4,0x52,0xa9,0x5c,0x3a, + 0x9d,0x4e,0x97,0x2c,0xdb,0x6a,0x11,0xb5,0x3a,0x1f,0xc7,0x71,0xf0,0x7a,0xbd,0xf0, + 0xfb,0xfd,0xf0,0x7a,0xbd,0xf0,0x7a,0xbd,0xf0,0xf9,0x7c,0x79,0xfb,0xbb,0xe1,0xa5, + 0x66,0x43,0x5e,0x9,0xc0,0xaf,0x44,0x51,0xfc,0x74,0x6f,0x6f,0xef,0xa8,0xee,0x82, + 0x19,0xba,0x60,0x82,0x6b,0x31,0x5b,0xb6,0x6c,0xd9,0x20,0x8,0xc2,0x77,0x9,0x21, + 0x57,0x16,0xcb,0x33,0x93,0x1f,0x54,0x4a,0x29,0x12,0x89,0x4,0xe2,0xf1,0x38,0x12, + 0x89,0x4,0x92,0xc9,0x24,0x4,0x41,0xb0,0xc5,0xb,0x75,0x9b,0x28,0x13,0x42,0x72, + 0xe2,0xeb,0xf7,0xfb,0xe1,0xf7,0xfb,0xc1,0xf3,0x5,0x2d,0x44,0x5,0xcc,0xd0,0xfa, + 0xe,0x53,0x4a,0xff,0x4d,0x10,0x84,0xef,0xf6,0xf5,0xf5,0xa5,0xd,0x19,0xc5,0x28, + 0xa,0x13,0x5c,0x8b,0x8,0x4,0x2,0x35,0x0,0x3e,0x47,0x29,0xfd,0x47,0x42,0x88, + 0xaf,0x58,0x3e,0x37,0x78,0xaa,0x46,0xf2,0xa7,0x52,0x29,0xc4,0x62,0x31,0x24,0x12, + 0x9,0x24,0x12,0x9,0xa4,0xd3,0x85,0xcf,0x9e,0x1d,0x82,0x57,0xef,0xf5,0xa2,0xb5, + 0xae,0xe,0x0,0xd0,0x5e,0x5f,0xf,0xaf,0xc7,0x83,0x5a,0x9e,0x47,0x73,0x7d,0x7e, + 0xcb,0x8c,0x4,0x20,0x41,0x8,0x26,0xa3,0x51,0x24,0x0,0x8,0x84,0x40,0x10,0x45, + 0x9c,0x9c,0x9c,0xc4,0xc4,0xc4,0x44,0x5e,0x99,0x56,0xdb,0x8,0xe4,0x7b,0xc2,0x7e, + 0xbf,0xbf,0x6a,0x5e,0x70,0x15,0x85,0x79,0x37,0xc7,0x71,0xb7,0xbf,0xfe,0xfa,0xeb, + 0x3d,0x86,0xe,0xc8,0xd0,0x84,0x9,0xae,0x5,0x74,0x77,0x77,0x5f,0x4b,0x29,0xfd, + 0x1,0x80,0x15,0xa5,0xf2,0xb9,0xe1,0xe1,0x2b,0x97,0x97,0x52,0x8a,0x78,0x3c,0x8e, + 0x58,0x2c,0x86,0xa9,0xa9,0x29,0x24,0x93,0xa5,0x3b,0xaf,0x8d,0x8,0x54,0x5b,0x4d, + 0xd,0x2e,0x58,0xba,0x14,0xeb,0x97,0x2f,0xc7,0x99,0x4b,0x97,0x62,0xd1,0xc2,0x85, + 0x98,0xdf,0xdc,0x8c,0x86,0x96,0x16,0xd4,0x35,0x37,0xa3,0xa6,0xa5,0x5,0xde,0xe6, + 0x66,0xf0,0x2d,0x2d,0x20,0xf3,0xe6,0x95,0x32,0x32,0xff,0xff,0x22,0x69,0x2a,0x49, + 0x10,0xc3,0x61,0xa4,0x27,0x26,0x90,0x8a,0x44,0x90,0x88,0x44,0x10,0x8b,0x46,0x11, + 0x9,0x6,0x71,0x62,0x78,0x18,0x87,0x4f,0x9e,0xc4,0x81,0xe1,0x61,0x1c,0x18,0x1d, + 0xc5,0x89,0x93,0x27,0x35,0x5f,0x26,0x46,0xcf,0x99,0xe3,0x38,0xf8,0xfd,0x7e,0xd4, + 0xd4,0xd4,0xc0,0xef,0xf7,0xe7,0x3a,0xf4,0xca,0xe1,0x86,0x7b,0xa3,0x44,0x7e,0xa, + 0xe0,0xc7,0x7e,0xbf,0xff,0x1f,0x59,0xfc,0x6e,0x65,0x30,0xc1,0xad,0x80,0x40,0x20, + 0xd0,0x46,0x8,0xb9,0x8f,0x66,0x57,0x58,0x28,0x8a,0x8b,0x3e,0x13,0x35,0xb7,0x27, + 0x12,0x89,0x9c,0xc0,0x26,0x12,0x9,0x5d,0x65,0x16,0x13,0x1d,0x3f,0xc7,0xa1,0xab, + 0xb3,0x13,0x81,0xb5,0x6b,0x71,0xee,0xba,0x75,0x58,0xbc,0x6a,0x15,0x9a,0x3b,0x3b, + 0x51,0xdb,0xd9,0x9,0xcf,0x2,0xcd,0xc5,0x80,0xcb,0x19,0x6d,0x6d,0x5a,0xb1,0x8d, + 0xaa,0xd2,0xa9,0xf1,0x71,0x4c,0xc,0xe,0xe2,0xf8,0xe1,0xc3,0x38,0x70,0xf4,0x28, + 0x5e,0x3b,0x7a,0x14,0x7b,0x8f,0x1e,0x45,0x7f,0x7f,0x7f,0x4e,0x8c,0x8d,0x7a,0xc0, + 0x3c,0xcf,0xe7,0x79,0xbf,0x5a,0x11,0x12,0x2e,0x17,0x5b,0x25,0x43,0x94,0xd2,0x4f, + 0xec,0xdd,0xbb,0xf7,0xbf,0xc,0x15,0xcc,0xc8,0xc1,0x4,0xd7,0x24,0xdd,0xdd,0xdd, + 0xff,0x47,0x92,0xa4,0x6f,0x12,0x42,0x4a,0xaa,0x88,0x4b,0x3f,0x13,0x91,0x4a,0xa5, + 0x30,0x31,0x31,0x81,0x89,0x89,0x89,0x9c,0x17,0x6b,0x54,0x4c,0x5a,0x7c,0x3e,0xbc, + 0x73,0xdd,0x3a,0x6c,0x5c,0xb7,0xe,0x6b,0xcf,0x3e,0x1b,0x4b,0x36,0x6c,0x40,0xfd, + 0xba,0x75,0x20,0xf5,0xba,0xe7,0xdb,0xd1,0x32,0x34,0xff,0x7f,0xb,0xd3,0xd4,0xc4, + 0xbe,0x14,0x80,0x28,0x8,0x88,0xc,0xe,0xe2,0xe8,0xa1,0x43,0xd8,0xb5,0x7f,0x3f, + 0x5e,0x3a,0x70,0x0,0xfb,0xfb,0xfa,0x10,0xc,0x6,0x35,0x4f,0xa1,0xd8,0x75,0x94, + 0xbd,0xdf,0xda,0xda,0x5a,0xf8,0xfd,0x7e,0xcd,0x3c,0xa5,0x70,0x91,0x30,0xff,0x1, + 0xc0,0xdf,0xee,0xdd,0xbb,0xf7,0x84,0xa1,0x1d,0x19,0x4c,0x70,0x8d,0xb2,0x65,0xcb, + 0x96,0xe,0x51,0x14,0xff,0x1d,0xc0,0x5f,0x96,0xcb,0xeb,0x36,0xb1,0x4d,0x24,0x12, + 0x88,0x46,0xa3,0x98,0x9c,0x9c,0xcc,0xfb,0x7c,0xd6,0x23,0xb4,0x4,0xc0,0x25,0x6d, + 0x6d,0x78,0xe7,0x5,0x17,0xe0,0xb2,0x8b,0x2f,0xc6,0xca,0x4b,0x2e,0x41,0xdd,0xf9, + 0xe7,0x3,0x26,0x84,0x43,0x61,0x98,0x6d,0x69,0x33,0xe2,0xaa,0xbb,0x6c,0x0,0x12, + 0xa5,0x88,0x9c,0x3c,0x89,0x3,0xfb,0xf7,0xe3,0x95,0x3,0x7,0xf0,0x4a,0x4f,0xf, + 0xf6,0xed,0xdb,0x87,0x4c,0x46,0xdf,0xe4,0x5c,0x1c,0xc7,0xc1,0xe7,0xf3,0xa1,0xa6, + 0xa6,0x6,0x35,0x35,0x35,0x65,0xeb,0xc0,0xd,0x62,0xab,0xca,0x3b,0x2,0xe0,0x93, + 0x7b,0xf7,0xee,0x7d,0x54,0x77,0x1,0xc,0x26,0xb8,0x46,0xe8,0xee,0xee,0x7e,0x1f, + 0xa5,0xf4,0x3e,0x0,0xf3,0xcb,0xe5,0x75,0xc3,0x3,0x2,0x0,0x99,0x4c,0x6,0xd1, + 0x68,0x14,0xd1,0x68,0x14,0x89,0x44,0xe1,0x28,0xce,0x52,0xf,0xfa,0xda,0xb6,0x36, + 0x7c,0xb8,0xab,0xb,0x5d,0xdd,0xdd,0x58,0xb6,0x71,0x23,0xbc,0x2b,0x57,0x1a,0x3a, + 0x76,0x1,0x65,0x3e,0xf1,0xab,0xed,0xbd,0x5a,0x65,0xb,0x5,0x20,0x52,0x8a,0x64, + 0x2a,0x85,0xfd,0x7b,0xf6,0xe0,0x8f,0x3d,0x3d,0x78,0xf5,0xb5,0xd7,0x8a,0xa,0xb0, + 0xfa,0x9a,0x13,0x42,0x50,0x53,0x53,0x83,0xda,0xda,0x5a,0xf8,0x7c,0xf9,0xfd,0xad, + 0x6e,0x6f,0x8e,0x2,0xf0,0xdf,0x7e,0xbf,0xff,0xf6,0x9d,0x3b,0x77,0x6a,0xbb,0xfb, + 0x8c,0x3c,0x98,0xe0,0xea,0x20,0x10,0x8,0xcc,0x9b,0x6e,0xab,0xbd,0x4d,0x4f,0x7e, + 0xa7,0xc5,0x96,0x52,0x8a,0x89,0x89,0x9,0x84,0x42,0x21,0xc4,0x62,0xc5,0x27,0x87, + 0x52,0x3f,0xf8,0xf3,0x79,0x1e,0x1f,0x3e,0xff,0x7c,0x5c,0xdf,0xdd,0x8d,0x35,0x57, + 0x5d,0x85,0xda,0xf3,0xce,0x3,0xc,0x84,0x71,0xa9,0x8c,0xb0,0x2d,0x6d,0xa7,0xf7, + 0x6a,0x38,0x5d,0x44,0x80,0x5,0x0,0xf1,0x64,0x12,0x3d,0x3d,0x3d,0x78,0xfc,0xcf, + 0x7f,0xc6,0x8b,0x2f,0xbe,0x88,0xd1,0xd1,0xf2,0x61,0xad,0x1c,0xc7,0xa1,0xb6,0xb6, + 0x16,0xf5,0xf5,0xf5,0x86,0x42,0xe8,0x1c,0x16,0xe6,0x61,0x4a,0xe9,0x87,0x7a,0x7b, + 0x7b,0x9f,0x36,0x64,0xc4,0x1c,0x84,0x9,0x6e,0x19,0xba,0xbb,0xbb,0x2f,0xa7,0x94, + 0xfe,0x12,0x65,0x22,0x10,0x0,0xc7,0x6f,0x7a,0xa4,0xd3,0x69,0x84,0x42,0x21,0x44, + 0x22,0x11,0x8,0x82,0x50,0x32,0xaf,0xfc,0x30,0x2f,0x9a,0x37,0xf,0x7f,0xb7,0x65, + 0xb,0xae,0xbf,0xf1,0x46,0x2c,0xbe,0xf2,0x4a,0x90,0xc6,0x46,0xdd,0x36,0xa9,0xc, + 0x2c,0x9d,0x76,0xda,0x7b,0xb5,0xc8,0x16,0x33,0x69,0x1,0x40,0xa,0xc0,0x9b,0x6f, + 0xbe,0x89,0xa7,0x5e,0x7e,0x19,0x7f,0xfe,0xf3,0x9f,0x71,0xf0,0xe0,0x41,0xcd,0x3a, + 0x55,0x8a,0xac,0xb2,0xc9,0xa1,0x14,0x2e,0x69,0xba,0xa2,0x94,0xd2,0xef,0x8b,0xa2, + 0xf8,0x8f,0x2c,0x6e,0xb7,0x38,0x4c,0x70,0x8b,0x30,0xbd,0x8e,0xd8,0xe7,0x1,0xfc, + 0x3f,0x68,0xcc,0x7f,0xa0,0xc6,0xc9,0x9b,0x3e,0x1e,0x8f,0x63,0x7c,0x7c,0x1c,0x93, + 0x93,0x93,0x65,0xf3,0x12,0x42,0xb0,0xaa,0xb1,0x11,0x9f,0xba,0xfa,0x6a,0x5c,0x75, + 0xd3,0x4d,0x68,0xbb,0xea,0x2a,0xe3,0xed,0xb0,0x36,0x8b,0x14,0x75,0x48,0x18,0x4b, + 0xa6,0x2d,0x7a,0x49,0x48,0x94,0x22,0x49,0x8,0x4e,0xc,0xf,0xe3,0x37,0x4f,0x3f, + 0x8d,0x27,0x9f,0x7c,0x12,0x3,0x3,0xd9,0xa5,0xc8,0x8a,0x79,0xb4,0x1e,0x8f,0x7, + 0xb5,0xb5,0xb5,0xa8,0xad,0xad,0x2d,0xc8,0xe3,0xf4,0xd7,0x94,0x46,0xfe,0xfd,0x94, + 0xd2,0xf7,0xed,0xdb,0xb7,0x6f,0x9f,0xa1,0x2,0xe6,0x8,0x4c,0x70,0x35,0x8,0x4, + 0x2,0xb,0x1,0xfc,0x1c,0x8a,0x9,0xc1,0x4b,0xe1,0xc4,0x4d,0x4f,0x29,0x45,0x38, + 0x1c,0x46,0x30,0x18,0x44,0x2a,0x95,0x2a,0x5b,0x56,0x53,0x4d,0xd,0xfe,0xf9,0xc6, + 0x1b,0x71,0xe3,0xbb,0xdf,0x8d,0x85,0xdd,0xdd,0x80,0xd7,0xab,0xdb,0xe,0xe6,0xbd, + 0x9a,0x3c,0x8f,0x32,0xfb,0x9,0xc8,0xe,0xda,0xd8,0x7f,0xe0,0x0,0xfe,0xeb,0x99, + 0x67,0xf0,0xdc,0x73,0xcf,0x21,0x1c,0x2e,0xbd,0x30,0x43,0x4d,0x4d,0xd,0xea,0xeb, + 0xeb,0xe1,0xf1,0x78,0xdc,0x28,0xb6,0xf2,0xdf,0x13,0x0,0x3e,0xb6,0x6f,0xdf,0xbe, + 0x5f,0x19,0x2a,0x68,0xe,0xc0,0x4,0x57,0xc5,0xe6,0xcd,0x9b,0xaf,0x26,0x84,0x3c, + 0x4,0xa0,0x4d,0x4f,0xfe,0x6a,0xdf,0xf4,0xa2,0x28,0x62,0x7c,0x7c,0x1c,0xa1,0x50, + 0x8,0xa2,0x28,0x96,0x2d,0xe7,0x43,0x1b,0x36,0xe0,0x23,0xef,0x7f,0x3f,0xce,0x7c, + 0xef,0x7b,0xf5,0x35,0x17,0xcc,0x45,0xef,0x55,0x99,0x76,0xe2,0x25,0x1,0x20,0x3, + 0x60,0x52,0x92,0xf0,0xc2,0xab,0xaf,0xe2,0x37,0xbf,0xfb,0x1d,0x5e,0x7d,0xf5,0xd5, + 0x82,0xfa,0x55,0x37,0x37,0xd4,0xd6,0xd6,0xc2,0xab,0xe3,0xc5,0xe9,0xe0,0x20,0x9a, + 0x5f,0xfa,0x7c,0xbe,0x3b,0xd8,0x32,0xee,0xa7,0x60,0x82,0x3b,0xcd,0x5d,0x77,0xdd, + 0xc5,0x6d,0xdb,0xb6,0xed,0xb,0x0,0x3e,0x7,0xa0,0xec,0xf0,0xa0,0x6a,0xb7,0xd7, + 0x4a,0x92,0x84,0xf1,0xf1,0x71,0x8c,0x8f,0x8f,0xe7,0xa6,0x2b,0x2c,0xc6,0xda,0x25, + 0x4b,0xf0,0xa5,0x5b,0x6f,0xc5,0xe5,0xb7,0xdc,0x82,0x9a,0x33,0xce,0x28,0x77,0x30, + 0xfd,0x69,0xa7,0xbd,0xd7,0xa,0x6c,0xb1,0xd5,0xb,0xb7,0xf0,0x98,0x14,0x59,0xaf, + 0x77,0x28,0x1c,0xc6,0xa3,0x4f,0x3f,0x8d,0xdf,0xff,0xfe,0xf7,0x18,0x1a,0x1a,0x42, + 0x31,0xbc,0x5e,0x2f,0xea,0xeb,0xeb,0x8b,0xce,0xe9,0xe0,0x2,0x2f,0x78,0xf,0xa5, + 0xf4,0x3d,0xfb,0xf6,0xed,0x3b,0xa2,0xbb,0xf0,0x59,0xc,0x13,0x5c,0x0,0x81,0x40, + 0xa0,0x9,0xd9,0x26,0x84,0x1b,0xf4,0xe4,0xaf,0xe6,0xe7,0x99,0x28,0x8a,0x18,0x1b, + 0x1b,0x43,0x30,0x18,0xcc,0xcd,0x5,0x5b,0x4c,0x6c,0xaf,0x59,0xb3,0x6,0x5f,0xb8, + 0xe3,0xe,0x9c,0x75,0xeb,0xad,0x20,0x5a,0xed,0xb2,0x2e,0xfc,0xac,0xae,0x6a,0xda, + 0xe9,0x97,0x84,0x41,0x5b,0x52,0x0,0xa2,0x94,0xe2,0xf9,0x1d,0x3b,0xf0,0xd0,0x23, + 0x8f,0x60,0xff,0xfe,0xfd,0x28,0x86,0x5a,0x78,0x9d,0xee,0xc0,0x55,0xe5,0x9d,0x0, + 0xf0,0x81,0x7d,0xfb,0xf6,0xfd,0xce,0x90,0x51,0xb3,0x90,0x39,0x2f,0xb8,0x5d,0x5d, + 0x5d,0xeb,0x39,0x8e,0xfb,0x2d,0x80,0x32,0xae,0x60,0x96,0x6a,0x79,0xc,0x92,0x24, + 0xe5,0x84,0x56,0xf9,0x69,0xa9,0x16,0x5b,0x2f,0xcf,0xe3,0xf3,0xef,0x7a,0x17,0x3e, + 0x70,0xc7,0x1d,0x68,0x38,0xff,0x7c,0x75,0xa1,0xfa,0xd3,0xcc,0x7b,0x75,0xdc,0x96, + 0x62,0x69,0x91,0x52,0x4c,0x72,0x1c,0xf6,0x1c,0x3e,0x8c,0x9f,0x3e,0xfc,0x30,0x5e, + 0x7c,0xf1,0xc5,0x3c,0xbb,0x95,0xf7,0x84,0xd7,0xeb,0x45,0x6d,0x6d,0xad,0xae,0x59, + 0xcc,0xb2,0x87,0xa9,0x9a,0x30,0x53,0x0,0xdf,0xd8,0xb7,0x6f,0xdf,0xbf,0x20,0x3b, + 0xe7,0xd0,0x9c,0x64,0x4e,0xb,0x6e,0x77,0x77,0xf7,0x4d,0x94,0xd2,0x9f,0x41,0xc7, + 0x40,0x6,0xa0,0x3a,0x62,0x4b,0x29,0x45,0x28,0x14,0xc2,0xd8,0xd8,0x58,0x5e,0xd0, + 0xbc,0x5a,0x68,0x9b,0x6b,0x6a,0xf0,0x8d,0x5b,0x6e,0xc1,0x3b,0x3e,0xfa,0x51,0xf8, + 0x57,0xaf,0x66,0xc2,0xa4,0xc3,0x16,0x47,0xe2,0x77,0x2d,0x2c,0x8f,0x2,0x98,0xe2, + 0x38,0xf4,0x1c,0x38,0x80,0x1f,0x3e,0xf2,0x8,0x76,0xec,0xd8,0x81,0x62,0xc8,0x13, + 0xe8,0x94,0x9a,0x3c,0xc7,0xa1,0xc8,0x9a,0xff,0x4e,0xa7,0xd3,0x1f,0x38,0x78,0xf0, + 0xe0,0xa4,0xa1,0x2,0x67,0x9,0x73,0x55,0x70,0x49,0x20,0x10,0xf8,0x22,0x80,0x2f, + 0x40,0xc7,0x35,0xa8,0x96,0x17,0x10,0x8d,0x46,0x31,0x32,0x32,0x52,0x10,0x75,0xa0, + 0x14,0xdb,0xa6,0x9a,0x1a,0xdc,0x73,0xdb,0x6d,0xb8,0xfe,0xef,0xff,0x1e,0x7c,0x47, + 0x87,0x5c,0x88,0xb2,0xc0,0xd2,0x69,0xa7,0xbd,0x57,0x83,0xb6,0xd8,0xfa,0x92,0xa8, + 0xa2,0x2d,0x66,0xaf,0x4b,0xb1,0x73,0x98,0x22,0x4,0xbb,0xdf,0x7e,0x1b,0xdf,0x7b, + 0xf0,0x41,0xf4,0xf4,0x14,0x9f,0x39,0xd1,0xef,0xf7,0xa3,0xae,0xae,0xce,0x6d,0xe1, + 0x64,0x87,0x3d,0x1e,0xcf,0xf5,0x7b,0xf6,0xec,0x79,0x4b,0x77,0xc1,0xb3,0x84,0x39, + 0x27,0xb8,0x37,0xdf,0x7c,0xb3,0x6f,0x6c,0x6c,0xec,0x87,0x0,0x3e,0xa8,0x27,0x7f, + 0x35,0xc4,0x36,0x99,0x4c,0x62,0x68,0x68,0x8,0x53,0x53,0x53,0x5,0x79,0xe4,0x7, + 0xa5,0xbd,0xb1,0x11,0xf7,0xdd,0x7e,0x3b,0x2,0x77,0xdc,0x1,0x4f,0x4b,0x8b,0x5c, + 0x80,0xb2,0x30,0xd3,0x69,0xe6,0xbd,0xba,0xe7,0x85,0x61,0xf4,0x3c,0xe2,0x0,0x76, + 0xbe,0xf5,0x16,0xee,0xfd,0xd9,0xcf,0xb0,0x77,0xef,0x5e,0xa8,0x91,0xd7,0x79,0x53, + 0xe,0xa0,0x70,0x41,0x47,0x1a,0x28,0xa5,0x41,0x4a,0xe9,0x3b,0xfb,0xfa,0xfa,0x5e, + 0xd6,0xbd,0xd3,0x2c,0x60,0x4e,0x9,0x6e,0x20,0x10,0x68,0xa2,0x94,0xfe,0xb6,0xd4, + 0x6a,0xc,0x4a,0xec,0xfe,0xe4,0xca,0x64,0x32,0x18,0x1e,0x1e,0x46,0x24,0x12,0xd1, + 0xcc,0x43,0x8,0x41,0x53,0x6d,0x2d,0xbe,0x7b,0xdb,0x6d,0xf8,0x8b,0xbf,0xfb,0x3b, + 0xf0,0xca,0xe9,0xd,0x99,0x30,0xb9,0xc6,0x16,0xb3,0x69,0x2b,0xeb,0x62,0x82,0x10, + 0x3c,0xb7,0x73,0x27,0xee,0xfd,0xd9,0xcf,0x30,0x38,0x38,0xa8,0xd9,0xb1,0xea,0xf1, + 0x78,0x72,0xd3,0x44,0xea,0xa1,0xa,0xc2,0x9c,0xa4,0x94,0x7e,0xa8,0xaf,0xaf,0xef, + 0x11,0xdd,0x3b,0xcf,0x70,0xe6,0x8c,0xe0,0x6,0x2,0x81,0x15,0x94,0xd2,0x27,0x8, + 0x21,0x6b,0xf5,0xe4,0xb7,0xfb,0x66,0xb,0x87,0xc3,0x18,0x1e,0x1e,0xd6,0x1c,0x82, + 0x4b,0x8,0x1,0xcf,0xf3,0xf8,0xc6,0x7,0x3f,0x88,0xbf,0xfe,0xf4,0xa7,0xc1,0xcb, + 0x1e,0x6d,0xb6,0x0,0x43,0xe9,0xd9,0xfc,0x59,0x3d,0xd3,0x5e,0x18,0x96,0x9c,0x47, + 0x89,0xdf,0x29,0x80,0x10,0x21,0xf8,0xdd,0x8b,0x2f,0xe2,0xfb,0xf,0x3c,0x80,0xc9, + 0x49,0xed,0x66,0x52,0xb9,0x63,0xad,0xd8,0xea,0xc5,0x55,0x8e,0x70,0xa0,0x0,0xee, + 0xde,0xbf,0x7f,0xff,0x5d,0x86,0xe,0x3a,0x43,0x99,0x13,0x82,0xbb,0x79,0xf3,0xe6, + 0x8b,0x8,0x21,0xbf,0x7,0xb0,0x50,0x4f,0x7e,0x3b,0xc5,0x36,0x95,0x4a,0x61,0x70, + 0x70,0x10,0xf1,0xb8,0x76,0x2c,0x38,0x21,0x4,0x1f,0xdf,0xb2,0x5,0x9f,0xfd,0xd2, + 0x97,0x50,0x77,0xe6,0x99,0xcc,0x7b,0x9d,0xa1,0x2f,0xc,0x27,0x5f,0x12,0x12,0x80, + 0xa1,0x58,0xc,0xf7,0xfe,0xe6,0x37,0xf8,0xef,0x27,0x9f,0xd4,0x5c,0x5a,0x5e,0x9e, + 0x9b,0xb7,0x92,0x25,0x81,0x8c,0xe6,0x2f,0x93,0xf7,0xfe,0xb6,0xb6,0xb6,0x8f,0x6e, + 0xdb,0xb6,0xad,0xf4,0x24,0x20,0x33,0x9c,0x59,0x2f,0xb8,0xdd,0xdd,0xdd,0x9b,0x25, + 0x49,0xfa,0x3d,0x21,0xa4,0xec,0x30,0x2b,0x3b,0x6f,0x36,0x49,0x92,0x30,0x32,0x32, + 0x82,0xf1,0xf1,0xf1,0xa2,0xfb,0x5d,0xbe,0x62,0x5,0x7e,0xf8,0xf9,0xcf,0x63,0xc9, + 0xd,0x37,0x30,0x61,0x9a,0x61,0x2f,0xf,0x37,0xe,0x51,0xce,0x10,0x82,0x9e,0xde, + 0x5e,0x7c,0xe6,0x27,0x3f,0xc1,0xe0,0xc9,0x93,0xb9,0x9f,0x95,0x2,0x2b,0xcf,0xd3, + 0x60,0xe7,0x50,0x61,0x3,0xf9,0x7f,0xed,0xf7,0xfb,0x6f,0xeb,0xe9,0xe9,0xd1,0x37, + 0xa9,0xf0,0xc,0x64,0x56,0xb,0xee,0xe6,0xcd,0x9b,0xdf,0x5,0xe0,0x91,0x52,0x8b, + 0x3a,0xca,0xd8,0x79,0xb3,0xc5,0x62,0x31,0x9c,0x38,0x71,0xa2,0xe8,0xfa,0x60,0xb, + 0x6a,0x6b,0xf1,0xe0,0x9d,0x77,0xe2,0xd2,0x8f,0x7d,0xc,0xc4,0xe7,0xd3,0x7c,0xe8, + 0x1c,0x17,0x26,0xa7,0xbd,0x57,0x1b,0x6c,0xb1,0xe4,0x3c,0x5c,0x60,0x4b,0xb9,0xeb, + 0x32,0x95,0x4e,0xe3,0xfe,0x87,0x1f,0xc6,0x7f,0x3c,0xfb,0x6c,0xd1,0x7b,0x57,0x9e, + 0x99,0x4c,0xf,0x36,0xb,0xf3,0xb,0x0,0x6e,0xec,0xeb,0xeb,0x2b,0xec,0x41,0x9e, + 0x5,0xcc,0x5a,0xc1,0xdd,0xbc,0x79,0xf3,0x6d,0x84,0x90,0x9f,0xc2,0xe2,0x61,0xba, + 0x46,0xbd,0xda,0xd1,0xd1,0x51,0x8c,0x8d,0x8d,0x15,0xdd,0xef,0xae,0xf7,0xbc,0x7, + 0x1f,0xfb,0xfc,0xe7,0xe1,0x5d,0xb8,0x90,0x79,0xaf,0x2e,0x7d,0x61,0xb8,0xd1,0x7b, + 0x35,0x9a,0xa6,0x0,0xde,0x7e,0xeb,0x2d,0x7c,0xf2,0x47,0x3f,0xc2,0xa1,0x22,0x43, + 0x85,0x39,0x8e,0x43,0x5d,0x5d,0x5d,0xd1,0xb6,0xdd,0x6c,0x71,0xf6,0x3c,0x2b,0xaa, + 0xbc,0x2f,0xa5,0x52,0xa9,0x77,0x1c,0x3e,0x7c,0x78,0xd6,0x2d,0x58,0x39,0x2b,0x5, + 0xb7,0xbb,0xbb,0xfb,0xff,0xa3,0x94,0xfe,0x8,0xe,0x8a,0x6d,0x22,0x91,0xc0,0xf1, + 0xe3,0xc7,0x8b,0x7a,0xb5,0xe7,0x74,0x74,0xe0,0x97,0x77,0xdf,0x8d,0xa5,0x37,0xde, + 0xc8,0x84,0xc9,0x6,0x5b,0x2c,0x3f,0xf,0xa7,0xeb,0xc5,0xa0,0x2d,0xc5,0xea,0x42, + 0x48,0x24,0xf0,0xf0,0x2f,0x7e,0x81,0x2f,0xbf,0xf2,0x4a,0xc1,0xfd,0x2c,0x37,0x35, + 0xf8,0xfd,0x7e,0x78,0xbd,0x5e,0xa7,0x63,0x77,0x7b,0x44,0x51,0xbc,0xf6,0xcd,0x37, + 0xdf,0x9c,0x55,0x2b,0x49,0xcc,0x3a,0xc1,0xed,0xee,0xee,0xfe,0x24,0xa5,0xf4,0x1e, + 0x94,0x39,0x37,0x3b,0xdb,0x6b,0xc7,0xc6,0xc6,0x30,0x3c,0x3c,0xac,0xb9,0xf,0xcf, + 0x71,0xf8,0xc1,0x6d,0xb7,0xe1,0x9d,0x9f,0xfd,0x2c,0xb8,0xc6,0xc6,0x19,0x27,0x46, + 0x9a,0xf,0xb5,0xb,0x6c,0x31,0x7b,0x5d,0xe6,0xea,0x10,0xe5,0xa3,0xdb,0xb7,0xe3, + 0x6f,0x1f,0x7c,0x10,0x47,0x8a,0xac,0x46,0xcc,0xf3,0x7c,0x6e,0xad,0x35,0x7,0x3b, + 0xd2,0xde,0x90,0x24,0xe9,0xaa,0x3,0x7,0xe,0x14,0x9f,0xbd,0x67,0x86,0x31,0xab, + 0x4,0x37,0x10,0x8,0x7c,0xa,0xc0,0x37,0xe1,0x90,0xd8,0xa,0x82,0x80,0xe3,0xc7, + 0x8f,0x17,0xd,0xc7,0xe9,0x5e,0xb9,0x12,0x3f,0xb9,0xf7,0x5e,0xcc,0xbf,0xe0,0x82, + 0x19,0x21,0x46,0xcc,0x7b,0x75,0x67,0x1d,0x59,0x55,0x17,0xc2,0xe8,0x28,0x7e,0x7a, + 0xcf,0x3d,0xf8,0xce,0xc8,0x8,0xb4,0x26,0xfa,0x24,0x84,0xc0,0xef,0xf7,0x3b,0x3d, + 0x2f,0xc3,0x9b,0x1e,0x8f,0xe7,0xea,0xde,0xde,0xde,0x41,0x43,0x85,0xbb,0x94,0x59, + 0x23,0xb8,0x9b,0x37,0x6f,0xfe,0x28,0x21,0xe4,0x3f,0x60,0xa1,0xd8,0x1a,0xc9,0x1b, + 0x8b,0xc5,0x70,0xec,0xd8,0x31,0xcd,0x45,0x3,0x39,0x8e,0xc3,0xf,0x3f,0xf2,0x11, + 0xbc,0xfb,0xd3,0x9f,0x6,0xa9,0xa9,0x61,0xc2,0x34,0xc3,0x84,0xc9,0xe9,0x3a,0xb2, + 0x35,0x96,0x5a,0x10,0xd0,0xf7,0xab,0x5f,0xe1,0x8e,0x17,0x5f,0xc4,0x68,0x91,0xb6, + 0x5b,0xaf,0xd7,0x5b,0x76,0x59,0x77,0x9b,0xbd,0xe0,0x3e,0x41,0x10,0x2,0x87,0xe, + 0x1d,0x1a,0x37,0x74,0x10,0x17,0x32,0x2b,0x4,0x37,0x10,0x8,0xfc,0x2d,0x80,0xfb, + 0xe0,0x90,0xd8,0xe,0xd,0xd,0x61,0x6c,0x6c,0x4c,0xf3,0xb7,0xb3,0x3b,0x3a,0xf0, + 0xd8,0xd7,0xbf,0x8e,0x8e,0xab,0xae,0x72,0x95,0x18,0x55,0x4d,0x98,0x9c,0x7e,0x49, + 0x38,0x64,0x8b,0xd9,0xeb,0xe2,0x54,0x2c,0x75,0xfc,0x99,0x67,0xf0,0xf9,0x87,0x1f, + 0xc6,0xe3,0xaa,0x48,0x5,0xb9,0xa9,0x81,0xe3,0xb8,0xa2,0xcb,0xb9,0x57,0x23,0x9c, + 0x8c,0x10,0xb2,0x4f,0x14,0xc5,0xee,0x99,0xde,0xa6,0x3b,0xe3,0x5,0x37,0x10,0x8, + 0xbc,0x9f,0x52,0xfa,0x73,0x42,0x48,0xf1,0xae,0x55,0xd8,0x73,0x53,0x88,0xa2,0x88, + 0x63,0xc7,0x8e,0x15,0x6d,0x42,0xf8,0x7f,0x5b,0xb7,0xe2,0xce,0x7f,0xfb,0x37,0x78, + 0x9a,0x9a,0x5c,0x25,0x0,0xcc,0x7b,0x75,0xcf,0xb,0xc3,0x4d,0x23,0x1,0xc5,0xbd, + 0x7b,0xf1,0xd4,0x77,0xbe,0x83,0xbb,0x6a,0x6a,0x30,0xc1,0x71,0x9a,0xe2,0xaa,0x9e, + 0x81,0xac,0xca,0x1d,0x69,0x3b,0x45,0x51,0xbc,0x6a,0x26,0xcf,0x34,0x36,0xa3,0x5, + 0x77,0xf3,0xe6,0xcd,0x37,0x13,0x42,0x1e,0x46,0x89,0x68,0x4,0xbb,0x3e,0x75,0x92, + 0xc9,0x24,0x6,0x6,0x6,0x34,0xd7,0x13,0x6b,0xa9,0xa9,0xc1,0x93,0x5f,0xfe,0x32, + 0xce,0xbc,0xe5,0x16,0xc7,0x5,0x80,0x79,0xaf,0xee,0x79,0x61,0xcc,0x84,0x91,0x80, + 0xd2,0xd8,0x18,0x8e,0x7f,0xf5,0xab,0xf8,0xcc,0xd4,0x14,0x76,0x17,0x89,0xcb,0xf5, + 0x7a,0xbd,0xf0,0xf9,0x7c,0xd5,0x16,0x5b,0xf9,0xb7,0xff,0xf5,0x7a,0xbd,0xd7,0xf4, + 0xf6,0xf6,0xc6,0x74,0x17,0xe8,0x22,0xca,0x86,0x4d,0xb9,0x95,0xee,0xee,0xee,0xeb, + 0x29,0xa5,0x8f,0x12,0x42,0x8a,0x2e,0xea,0x64,0xd7,0xd,0x11,0x89,0x44,0xd0,0xdf, + 0xdf,0xaf,0x39,0xf,0xc2,0xc6,0x65,0xcb,0xf0,0xfc,0x83,0xf,0x62,0xf1,0x95,0x57, + 0xe6,0xdf,0xf4,0x56,0xa5,0x4f,0x19,0xac,0x99,0xd6,0x25,0x4c,0x55,0xb2,0x45,0x97, + 0x18,0x68,0xa4,0xa9,0x8b,0x6c,0xa9,0xe4,0xba,0x54,0x14,0x4b,0xed,0x50,0x1d,0x91, + 0xba,0x3a,0xcc,0xbf,0xfc,0x72,0x6c,0xed,0xe9,0xc1,0xd4,0xd8,0x18,0xf6,0x69,0x88, + 0xae,0x24,0x49,0x90,0x24,0x9,0x1e,0x8f,0xa7,0xe4,0x52,0x4f,0xa7,0x8a,0xb5,0xee, + 0x39,0x24,0x84,0x2c,0xa3,0x94,0x5e,0x34,0x7f,0xfe,0xfc,0x47,0x43,0xa1,0x50,0xf9, + 0x45,0xfd,0x5c,0xc6,0x8c,0x14,0xdc,0xee,0xee,0xee,0xcd,0x94,0xd2,0xdf,0x13,0x42, + 0x8a,0xe,0x8d,0xb1,0x4b,0x6c,0x47,0x46,0x46,0x70,0xf2,0xe4,0x49,0xcd,0x7d,0xfe, + 0xf5,0xe6,0x9b,0xf1,0xed,0x9f,0xfc,0x4,0xfe,0xc5,0x8b,0x2b,0x17,0x3,0x1d,0xf, + 0x54,0xd5,0x84,0xc9,0x4a,0x1,0xa8,0x54,0x98,0x6c,0xb6,0xc5,0xec,0x75,0x31,0x55, + 0x17,0x2e,0xac,0x23,0x4a,0x29,0xe0,0xf5,0xc2,0xd7,0xd5,0x85,0x8d,0x87,0xf,0x63, + 0xf5,0x5b,0x6f,0xe1,0x95,0xba,0x3a,0xa4,0x35,0x84,0x55,0x14,0xc5,0x92,0xa2,0x6b, + 0x63,0x47,0xda,0x69,0x1c,0xc7,0x9d,0x7d,0xf6,0xd9,0x67,0xff,0xb6,0xbf,0xbf,0x7f, + 0x46,0xad,0x1e,0x31,0xe3,0x4,0x37,0x10,0x8,0xac,0xa1,0x94,0x3e,0x5b,0x6a,0x6e, + 0x4,0x3b,0xc4,0x96,0x52,0x8a,0x63,0xc7,0x8e,0x21,0x18,0x2c,0x6c,0xb3,0xf7,0x7b, + 0x3c,0x78,0xf2,0x33,0x9f,0xc1,0x8d,0x9f,0xf9,0xc,0x88,0xdc,0xbe,0x65,0xc3,0x43, + 0x57,0x55,0xef,0xd5,0x26,0x1,0xa8,0x58,0x98,0x2c,0xb4,0xa5,0x62,0x61,0x32,0x63, + 0x8b,0x5d,0x76,0x99,0xb4,0x85,0x16,0x2b,0x8f,0x10,0x78,0x2e,0xb9,0x4,0xcb,0x4f, + 0x9c,0x40,0x77,0x5f,0x1f,0x76,0xd5,0xd6,0x22,0x34,0x2d,0xae,0x4a,0x81,0x15,0x45, + 0x11,0x9c,0x46,0x7b,0x6f,0x15,0x3a,0xd2,0xd6,0x4c,0x4d,0x4d,0x35,0x8f,0x8f,0x8f, + 0x3f,0x65,0x68,0x67,0x87,0x99,0x51,0x82,0x1b,0x8,0x4,0x96,0x2,0x78,0x91,0x10, + 0xd2,0xa1,0xf5,0xbb,0x9d,0xf1,0xb5,0x47,0x8e,0x1c,0xd1,0x9c,0x20,0xfc,0x8c,0xe6, + 0x66,0xbc,0x72,0xff,0xfd,0x38,0xfd,0x6,0xc5,0xfa,0x93,0x4e,0x9,0x93,0x99,0xe3, + 0xeb,0xb0,0xa5,0x12,0x1,0x98,0x89,0x9f,0xd5,0xea,0xb4,0xa5,0xde,0xab,0x83,0x2f, + 0x8f,0x92,0xe7,0xa1,0x75,0x4c,0x0,0x9e,0x8b,0x2f,0xc6,0xfc,0x64,0x12,0xd7,0xef, + 0xda,0x85,0x13,0x5e,0x2f,0xde,0xd6,0x98,0x4b,0x57,0x16,0x5d,0x79,0x48,0x70,0xb5, + 0x26,0xc1,0x21,0x84,0x5c,0xd2,0xde,0xde,0x9e,0x1c,0x1f,0x1f,0x7f,0xc5,0x50,0x21, + 0xe,0x32,0x63,0x4,0x37,0x10,0x8,0xcc,0xa3,0x94,0x3e,0x43,0x8,0x59,0xad,0xf5, + 0xbb,0x5d,0x62,0x9b,0x4a,0xa5,0x70,0xe4,0xc8,0x11,0xcd,0xce,0xb1,0x2b,0x16,0x2d, + 0xc2,0xe3,0xf,0x3c,0x80,0xf9,0xe7,0x9c,0x23,0x17,0x5a,0x1d,0x61,0x72,0xa9,0x0, + 0xcc,0xaa,0xcf,0x6a,0x97,0xd8,0x52,0xc9,0x75,0x29,0xea,0xbd,0x1a,0x4c,0x7b,0x36, + 0x6c,0x80,0x37,0x99,0x44,0xa0,0xa7,0x7,0x3c,0x80,0x5d,0xb5,0xb5,0x50,0x23,0x8a, + 0x62,0x81,0xf7,0x5b,0xe,0x8b,0x84,0x79,0xcb,0x82,0x5,0xb,0xe,0x8f,0x8d,0x8d, + 0xed,0xd3,0x5d,0x98,0x83,0xcc,0x8,0xc1,0xd,0x4,0x2,0x3c,0xcd,0xae,0xd4,0xd0, + 0xa5,0xf5,0xbb,0x5d,0x6f,0xd4,0x78,0x3c,0x8e,0xfe,0xfe,0x7e,0xcd,0xc1,0xc,0x1f, + 0xbf,0xf0,0x42,0xfc,0xe7,0x2f,0x7e,0x1,0xff,0xb2,0x65,0x72,0xc1,0xca,0x83,0x9c, + 0xfa,0xdf,0xe,0x61,0x52,0x1f,0x47,0x4f,0xda,0x6,0x1,0x98,0xf5,0x9f,0xd5,0xe, + 0xd8,0x62,0xd9,0x4b,0xc2,0x62,0x5b,0x3c,0x1b,0x36,0x80,0xa4,0xd3,0x38,0x67,0xcf, + 0x1e,0xac,0x4f,0xa5,0xb0,0xad,0xbe,0x1e,0x99,0x22,0xcd,0x8,0xa5,0x26,0xbf,0x51, + 0xe7,0xd5,0x43,0x99,0xbc,0x4,0xc0,0xf5,0xad,0xad,0xad,0xdb,0x82,0xc1,0xe0,0x71, + 0xdd,0x85,0x3a,0xc4,0x8c,0x10,0xdc,0xce,0xce,0xce,0xff,0x24,0x84,0xdc,0xaa,0xf5, + 0x9b,0x5d,0x62,0x1b,0x8d,0x46,0x31,0x30,0x30,0x90,0xb7,0x44,0xb9,0xcc,0xb7,0xae, + 0xbe,0x1a,0xff,0x70,0xdf,0x7d,0xe0,0xe6,0xcd,0xd3,0xf5,0xd0,0xb1,0xcf,0x6a,0xf7, + 0xbc,0x3c,0x2c,0x17,0x26,0x87,0xae,0x4b,0xd1,0x58,0x6a,0x1b,0x6d,0xf1,0xac,0x5b, + 0x7,0x1a,0xa,0x61,0xc9,0x5b,0x6f,0x61,0x53,0x3c,0x8e,0x97,0xea,0xeb,0x11,0x9b, + 0x6e,0xbf,0x95,0x3d,0x5b,0x4a,0x29,0x28,0xa5,0x9a,0xed,0xba,0x9a,0xb6,0x97,0x41, + 0x67,0x5e,0x9e,0x10,0x72,0x53,0x5b,0x5b,0xdb,0xef,0xc6,0xc7,0xc7,0x5d,0x3d,0x30, + 0xc2,0xf5,0x82,0x1b,0x8,0x4,0xee,0x24,0x84,0xfc,0x3f,0xad,0xdf,0xec,0xc,0xfb, + 0x3a,0x7e,0xfc,0x78,0xc1,0x3e,0x1c,0x80,0x47,0x6f,0xbd,0x15,0xef,0xf9,0xfa,0xd7, + 0x41,0x78,0xde,0xf8,0x3,0xed,0x72,0x31,0x2a,0x79,0x1e,0xe,0xda,0x52,0xc9,0x75, + 0xb1,0xc5,0x7b,0xad,0xf2,0x75,0xd1,0x7d,0x4f,0x55,0xc1,0x16,0xcf,0xb9,0xe7,0x42, + 0x1a,0x1a,0x42,0xcb,0xc0,0x0,0xae,0x8d,0xc5,0xf0,0x5a,0x5d,0x1d,0x82,0xaa,0xb9, + 0x16,0x64,0xd1,0x55,0x2f,0xd1,0x6e,0xf3,0xf0,0xdf,0x3a,0x0,0x7f,0xd1,0xd4,0xd4, + 0xf4,0x70,0x28,0x14,0xd2,0x5e,0x4e,0xc5,0x5,0xb8,0x5a,0x70,0xbb,0xbb,0xbb,0xaf, + 0x5,0xf0,0x20,0xb2,0x5a,0x97,0xc3,0xce,0x8a,0xb,0x85,0x42,0x18,0x1c,0x1c,0x2c, + 0xd8,0xa7,0x8e,0x10,0x6c,0xfb,0xa7,0x7f,0xc2,0xc5,0x77,0xde,0x29,0x17,0x5a,0x58, + 0xf6,0xc,0x13,0x23,0xc3,0xf,0xb4,0xb,0xc5,0x48,0xb7,0x30,0x55,0xd9,0x96,0x4a, + 0xae,0x8b,0x13,0xde,0xab,0xee,0x34,0x21,0xe0,0x2f,0xb8,0x0,0xd2,0xc0,0x0,0x6a, + 0x4f,0x9c,0xc0,0xd6,0xa9,0x29,0x1c,0xf2,0xfb,0x71,0xdc,0x9b,0x1f,0xe,0xaf,0x16, + 0xdd,0x2a,0x75,0xa4,0x35,0x13,0x42,0xce,0x5f,0xbf,0x7e,0xfd,0x43,0x6e,0xd,0x17, + 0x73,0xad,0xe0,0x76,0x75,0x75,0x9d,0x45,0x8,0x79,0x16,0x40,0x5e,0xb,0xbd,0x9d, + 0x15,0x37,0x3e,0x3e,0x8e,0x13,0x27,0x4e,0x14,0x6c,0x9f,0xcf,0xf3,0xf8,0xdf,0xaf, + 0x7c,0x5,0x2b,0xdf,0xfb,0x5e,0x67,0xc5,0x48,0x99,0xb6,0x52,0x98,0x1c,0xb4,0xa5, + 0x92,0xeb,0x62,0xbb,0x30,0x99,0xb9,0x16,0x6,0x6d,0xb1,0xd5,0x7b,0x35,0x68,0x8b, + 0xee,0x34,0x21,0xf0,0x9c,0x77,0x1e,0xa4,0xbd,0x7b,0xc1,0x47,0x22,0xb8,0x72,0x6a, + 0xa,0x47,0xfd,0x7e,0xf4,0xab,0x22,0x18,0x94,0xcd,0xb,0x7a,0xa9,0xf4,0xf9,0x26, + 0x84,0xac,0x9a,0x9a,0x9a,0x6a,0x71,0x6b,0xb8,0x98,0x2b,0x5,0x77,0xeb,0xd6,0xad, + 0x8d,0xa2,0x28,0xfe,0x11,0xc0,0x62,0xe5,0x76,0x3b,0x87,0x12,0x8e,0x8d,0x8d,0x61, + 0x48,0x63,0x26,0xfc,0x45,0x3e,0x1f,0x5e,0xf9,0xc6,0x37,0xb0,0xf0,0xfa,0xeb,0x95, + 0x3b,0xe8,0x4f,0x5b,0x79,0xa3,0x57,0x2a,0x4c,0x2e,0xb0,0xc5,0xec,0x71,0xdc,0xf4, + 0x59,0x5d,0xc9,0x75,0x99,0x35,0xb1,0xd4,0x1e,0xf,0x3c,0xeb,0xd7,0x43,0xdc,0xb1, + 0x3,0x9e,0x54,0xa,0x5b,0xa6,0xa6,0x30,0xc6,0xf3,0x38,0xa8,0x98,0x55,0x4c,0xd9, + 0xae,0xab,0x27,0x82,0xc1,0xc2,0xe7,0xfb,0xe2,0xd6,0xd6,0xd6,0x63,0xc1,0x60,0x70, + 0x8f,0xee,0x2,0xab,0x84,0x1b,0x5,0x97,0x2c,0x5d,0xba,0xf4,0x11,0x0,0x9b,0x94, + 0x1b,0xed,0x14,0xdb,0x50,0x28,0xa4,0x29,0xb6,0xcb,0xbc,0x5e,0xbc,0x78,0xef,0xbd, + 0x68,0xe9,0xee,0x96,0x33,0xbb,0x52,0x8c,0x74,0xb,0x53,0x95,0x6d,0xa9,0xe4,0xba, + 0xb8,0xfa,0xb3,0x5a,0x67,0xd9,0xb3,0x7d,0x24,0x20,0xa9,0xad,0x5,0x77,0xc6,0x19, + 0x10,0x77,0xec,0x0,0x27,0x49,0xe8,0x8a,0xc5,0x30,0xc5,0x71,0xe8,0xab,0xad,0xd5, + 0x1c,0x8,0x51,0xcd,0xa5,0x7b,0x8,0x21,0xd7,0xb6,0xb6,0xb6,0x3e,0x13,0xc,0x6, + 0x4f,0x96,0xcd,0x5c,0x45,0x5c,0x27,0xb8,0x81,0x40,0xe0,0x33,0x0,0x3e,0x21,0xff, + 0x6d,0x73,0x43,0x3b,0x42,0xa1,0x90,0x66,0x33,0xc2,0xea,0x9a,0x1a,0xbc,0xf0,0x9f, + 0xff,0x89,0xc6,0x8d,0x1b,0xe5,0xcc,0xca,0x1d,0xb,0xd3,0xe,0x9,0x0,0xfb,0xac, + 0x76,0x48,0x98,0x34,0x8e,0xe3,0x58,0x2c,0xb5,0x99,0x6b,0x51,0xc4,0x16,0xa3,0x2f, + 0x9,0xd2,0xdc,0xc,0xae,0xbd,0x1d,0x62,0x4f,0xf,0x8,0x80,0xcb,0xe2,0x71,0x80, + 0x10,0xbc,0xae,0x11,0xab,0x2b,0xcf,0xbf,0xa0,0xc4,0xc6,0xe7,0x9b,0x7,0x70,0x5d, + 0x6b,0x6b,0xeb,0x2f,0x83,0xc1,0xa0,0x6b,0x3a,0xd1,0x5c,0x25,0xb8,0x81,0x40,0xe0, + 0x3a,0x4a,0xe9,0x4f,0xc8,0xf4,0xeb,0xd1,0x6e,0xb1,0x8d,0x44,0x22,0x18,0x1c,0x2c, + 0x9c,0x48,0x7e,0x6d,0x4d,0xd,0x9e,0xf9,0xf7,0x7f,0xc7,0xbc,0x8b,0x2e,0xb2,0xf7, + 0xa6,0x37,0x78,0x73,0xb3,0xcf,0x6a,0x7,0x84,0xa9,0xd2,0xba,0x70,0x79,0x1d,0x59, + 0xd1,0xe9,0xcb,0x2d,0x5e,0xc,0x84,0xc3,0x90,0x8e,0x1d,0x3,0x0,0x5c,0x90,0x48, + 0xc0,0x4f,0x29,0x76,0xd6,0xd5,0x41,0x8d,0xd2,0xd3,0xb5,0xfb,0xf9,0x6,0x30,0x9f, + 0x10,0x72,0x41,0x30,0x18,0xfc,0x15,0x0,0x63,0x7,0xb3,0x9,0xd7,0x8,0x6e,0x20, + 0x10,0x58,0x4a,0x29,0x7d,0x8a,0x10,0x32,0xf,0x30,0x75,0x71,0xd,0xe5,0x8f,0x46, + 0xa3,0x9a,0x62,0x7b,0x9a,0xdf,0x8f,0x67,0xbf,0xfd,0x6d,0x34,0x5c,0x7a,0xa9,0xe3, + 0x2,0xc0,0x3e,0xab,0x9d,0x15,0xa3,0xb2,0x75,0xe1,0x90,0x2d,0x66,0xaf,0x8b,0x9d, + 0x21,0x8b,0x9e,0xb5,0x6b,0x21,0xed,0xdf,0xf,0x1a,0x8d,0x2,0x0,0xce,0x4d,0x26, + 0x35,0x3d,0x5d,0x79,0x8d,0x34,0xbb,0x46,0xa4,0x69,0xe4,0x5f,0xd5,0xde,0xde,0x8e, + 0xf1,0xf1,0xf1,0x6d,0x86,0xa,0xb1,0x9,0x57,0x8,0xee,0x5,0x17,0x5c,0xe0,0xf5, + 0xfb,0xfd,0xcf,0x11,0x42,0xce,0x0,0xec,0x13,0x5b,0x39,0xef,0xe4,0xe4,0x24,0x8e, + 0x1d,0x3b,0x56,0xb0,0xef,0x72,0x8e,0xc3,0xb,0x5f,0xfb,0x1a,0x1a,0x37,0x6f,0xae, + 0xfc,0x46,0x57,0xa6,0xad,0x14,0xa6,0x2a,0xd8,0x52,0x89,0x0,0xcc,0xc5,0xcf,0x6a, + 0xb7,0xd6,0x51,0x55,0x47,0x2,0x72,0x1c,0x3c,0x67,0x9c,0x1,0x61,0xfb,0x76,0x60, + 0x7a,0xb0,0xd0,0x5,0x89,0x4,0x32,0x84,0x60,0xcf,0xb4,0xe8,0xaa,0x45,0xb6,0x8a, + 0x53,0x3b,0x76,0xb5,0xb4,0xb4,0xec,0xa,0x85,0x42,0x6f,0xe9,0x2e,0xcc,0x26,0x5c, + 0x21,0xb8,0xab,0x57,0xaf,0xfe,0x2,0x80,0xf7,0x1,0xf6,0x8b,0x6d,0x22,0x91,0x40, + 0x7f,0x7f,0x7f,0xde,0xbe,0x84,0x10,0x74,0x0,0xd8,0xf6,0xc5,0x2f,0xa2,0xf9,0xba, + 0xeb,0xe4,0x1d,0x9c,0x15,0x26,0x2b,0x8f,0x5f,0xa9,0x18,0x94,0x7a,0xa0,0x5d,0x62, + 0x8b,0x23,0xc2,0xe4,0xa2,0x3a,0x72,0x43,0x2c,0x35,0xa9,0xaf,0x7,0x69,0x6c,0x84, + 0xd4,0xdb,0x9b,0xdb,0x76,0x71,0x22,0x81,0xb8,0xc7,0x83,0xfd,0x1a,0x6d,0xba,0x40, + 0x69,0xd1,0xb5,0x72,0xf8,0x2f,0x21,0xe4,0xaa,0x45,0x8b,0x16,0xfd,0x62,0x74,0x74, + 0xd4,0xd1,0x89,0xcb,0x1d,0x17,0xdc,0xcd,0x9b,0x37,0x6f,0x24,0x84,0xfc,0x94,0x52, + 0xaa,0x3f,0x58,0xf,0xe6,0x2a,0x23,0x95,0x4a,0xe1,0xe8,0xd1,0xa3,0x79,0xc3,0x75, + 0x9,0x21,0x68,0xa2,0x14,0x7f,0xbc,0xe3,0xe,0x2c,0xfc,0xab,0xbf,0x92,0x77,0x50, + 0xee,0x5c,0x3a,0xad,0xf7,0x81,0x9e,0xa1,0x62,0xa4,0x3c,0xe,0xfb,0xac,0x76,0x4f, + 0x1d,0xb9,0x75,0x24,0x20,0xb7,0x74,0x29,0xe8,0xc9,0x93,0xa0,0xc3,0xc3,0xb9,0xc3, + 0x5d,0x12,0x8f,0x63,0x94,0xe7,0x71,0xb0,0xc8,0xa,0x12,0x55,0x5a,0x27,0xad,0x5e, + 0x92,0xa4,0x33,0x82,0xc1,0xe0,0x23,0xba,0xb,0xb6,0x1,0x47,0x5,0x77,0xeb,0xd6, + 0xad,0x8d,0x82,0x20,0x3c,0x47,0x29,0x6d,0xd5,0xbb,0x8f,0xd9,0xf6,0x1c,0x41,0x10, + 0x70,0xf4,0xe8,0xd1,0xbc,0x89,0x68,0x8,0x21,0xa8,0xa7,0x14,0xcf,0xbe,0xe7,0x3d, + 0x58,0xf9,0xc9,0x4f,0x5a,0xf6,0xd0,0xb1,0xcf,0x6a,0x6b,0x6d,0xa9,0x58,0x98,0x5c, + 0x62,0x4b,0x25,0xd7,0xc5,0x96,0x58,0x6a,0x93,0xb6,0x94,0x15,0xdd,0x33,0xce,0x80, + 0xb8,0x73,0x27,0x90,0x4e,0x3,0xc8,0xce,0x2e,0x73,0x79,0x2c,0x86,0x1,0x9f,0xf, + 0x47,0x34,0x56,0xff,0x55,0x86,0x8b,0xd9,0xdc,0x91,0xb6,0xa6,0xb5,0xb5,0x75,0x28, + 0x18,0xc,0xf6,0x18,0x3a,0x88,0x85,0x38,0x2a,0xb8,0x4b,0x97,0x2e,0xfd,0x1,0xa5, + 0xb4,0x5b,0x6f,0x7e,0xb3,0x6f,0x3d,0x4a,0x29,0xfa,0xfb,0xfb,0x91,0x4c,0x26,0x73, + 0xdb,0x8,0x21,0xe0,0x1,0xfc,0xe6,0xd2,0x4b,0x71,0xce,0xdd,0x77,0xab,0x77,0x2e, + 0x4c,0x97,0x7a,0xa0,0xab,0x7d,0xd3,0x5b,0xf9,0xd0,0x55,0x2a,0x4c,0x36,0xd8,0x62, + 0xf6,0xba,0xb8,0xe1,0xb3,0xda,0xb2,0xba,0x70,0x89,0x2d,0x66,0xae,0xb,0xf1,0xf9, + 0x0,0x55,0xd3,0x2,0x7,0x60,0x53,0x2c,0x86,0x3d,0x75,0x75,0x18,0x56,0xc,0x3, + 0x96,0x3b,0xd1,0x8c,0x62,0x56,0x98,0x9,0x21,0x5b,0xda,0xda,0xda,0x7e,0x1b,0xd4, + 0x5a,0x49,0xa0,0xa,0x38,0xb6,0x88,0x64,0x20,0x10,0x78,0x2f,0xa5,0x54,0xb7,0x7b, + 0x5f,0xc9,0x27,0xc6,0xb1,0x63,0xc7,0x10,0x9d,0xee,0x3d,0x95,0x3f,0x5f,0x8,0x80, + 0x9f,0x9f,0x76,0x1a,0xae,0x7b,0xe0,0x1,0x10,0xf9,0xad,0xab,0xe3,0x26,0x36,0xec, + 0xbd,0xea,0xcd,0x6b,0x77,0xda,0xec,0x39,0xd8,0x6c,0x4b,0x25,0x69,0xcb,0xbc,0x57, + 0xb,0x6c,0xb1,0xe4,0x3c,0x5c,0x60,0x8b,0xd9,0xeb,0xa2,0x55,0x17,0x99,0xfb,0xef, + 0x87,0xd8,0xd7,0x7,0x25,0x71,0x8e,0xc3,0xed,0xcb,0x96,0xe1,0xb0,0x46,0xf3,0x82, + 0xde,0xc8,0x85,0x4a,0xbd,0x60,0x42,0xc8,0xeb,0x3c,0xcf,0x6f,0xec,0xeb,0xeb,0x4b, + 0x1b,0x2a,0xc8,0x2,0x1c,0xf1,0x70,0x3,0x81,0xc0,0x42,0x4a,0xe9,0xe3,0x0,0xea, + 0xf5,0xe4,0xaf,0x44,0x6c,0x47,0x46,0x46,0x10,0xa,0x85,0x0,0xe4,0x57,0xe8,0xe7, + 0x1a,0x1a,0xf0,0xfe,0x1f,0xfe,0x10,0x5c,0x63,0xa3,0xbc,0xe3,0xa9,0xff,0xf5,0x78, + 0x1a,0x15,0x78,0x0,0xba,0xd3,0x16,0x79,0x23,0xec,0xb3,0xda,0x3d,0x75,0x64,0xb9, + 0xf7,0x5a,0x81,0x2d,0x95,0x5c,0x17,0x3d,0x9d,0xbe,0xdc,0x8a,0x15,0x10,0x77,0xec, + 0xc8,0x45,0x2d,0x0,0x80,0x97,0x52,0x6c,0x8e,0xc5,0xf0,0xc7,0xc6,0x46,0xc4,0x54, + 0x23,0xcf,0xaa,0x18,0xb5,0xb0,0x48,0x92,0x24,0x31,0x18,0xc,0xfe,0x59,0x77,0x61, + 0x16,0xe1,0x88,0xe0,0x76,0x76,0x76,0xfe,0x1a,0xc0,0xb9,0xe5,0xf2,0x55,0xfa,0x26, + 0x8b,0x44,0x22,0xb9,0x21,0xbb,0xca,0xca,0xfc,0x0,0xa5,0xf8,0xdc,0x3d,0xf7,0xc0, + 0xb3,0x6a,0x95,0x35,0xc2,0x64,0xe5,0x8d,0x5e,0xe1,0x3,0xc8,0x3e,0xab,0xad,0xb7, + 0xc5,0x72,0x61,0x9a,0x61,0x75,0x64,0xb6,0xd3,0x97,0xd4,0xd4,0x0,0xa2,0x8,0xe9, + 0xed,0xb7,0xa1,0xa4,0x4e,0x92,0x70,0x69,0x3c,0x8e,0x67,0x1a,0x1b,0xb,0x16,0xa7, + 0xac,0x52,0xd4,0x2,0x0,0x5c,0xd1,0xde,0xde,0xfe,0xc4,0xf8,0xf8,0x78,0xe1,0x98, + 0x7e,0x1b,0xa9,0xba,0xe0,0x76,0x75,0x75,0xbd,0x97,0x10,0xf2,0xd9,0x72,0xf9,0x2a, + 0x15,0xdb,0x64,0x32,0x89,0x81,0x81,0x1,0x0,0xf9,0x95,0xd8,0x95,0xc9,0xe0,0x3f, + 0xff,0xf9,0x9f,0xc1,0x77,0x75,0xb9,0xfe,0x46,0x37,0xf5,0x30,0x38,0x68,0x4b,0x25, + 0xd7,0xc5,0x16,0xef,0xb5,0xca,0xd7,0x85,0x8d,0x4,0x2c,0x4c,0x73,0xcb,0x97,0x43, + 0xec,0xed,0x5,0xe2,0xf9,0xa3,0x6b,0x9b,0x45,0x11,0xeb,0x92,0x49,0x3c,0xdb,0xd8, + 0x8,0x49,0x87,0xe8,0xda,0x10,0xb5,0xc0,0x51,0x4a,0x2f,0x5d,0xb1,0x62,0xc5,0x3, + 0x43,0x43,0x43,0x55,0x9b,0xca,0xb1,0xaa,0x82,0x1b,0x8,0x4,0xda,0x0,0x3c,0x9, + 0xa0,0x70,0xcc,0x9f,0x82,0x4a,0x2f,0xae,0x28,0x8a,0xe8,0xef,0xef,0x2f,0x58,0xad, + 0xe1,0xc,0x51,0xc4,0xa3,0xd7,0x5d,0x87,0xfa,0x8f,0x7c,0x44,0x59,0x40,0xe9,0xb4, + 0x8b,0x4,0x80,0x79,0xaf,0xd6,0xdb,0x52,0xc9,0x75,0x71,0xbd,0xf7,0xaa,0xc3,0x2e, + 0xdb,0x43,0x16,0x9,0x1,0xa9,0xaf,0x87,0xb4,0x7f,0x3f,0xd4,0x2c,0xce,0x64,0x30, + 0x5f,0x14,0xf1,0xca,0xbc,0x79,0x8a,0xec,0xe6,0x57,0xff,0x35,0x9a,0x9f,0x52,0xda, + 0x91,0x4c,0x26,0x63,0xa1,0x50,0xa8,0x6a,0x8b,0x50,0x56,0x55,0x70,0x3b,0x3b,0x3b, + 0xff,0x3,0xc0,0x65,0xa5,0xf2,0x58,0xf1,0x26,0x3b,0x76,0xec,0x18,0x12,0x89,0x44, + 0xde,0xb6,0x16,0x4a,0xf1,0xbb,0x25,0x4b,0xb0,0xf0,0xdb,0xdf,0x6,0x3c,0x1e,0xc7, + 0x6f,0x74,0x53,0xc2,0xe4,0xa0,0x2d,0x95,0x5c,0x17,0xdb,0x85,0xc9,0xcc,0xb5,0x30, + 0x68,0xcb,0x8c,0x1c,0x9,0xa8,0x61,0x97,0x13,0x21,0x8b,0x5c,0x7b,0x3b,0xa4,0x43, + 0x87,0x40,0x27,0x26,0xa0,0x66,0x6d,0x32,0x89,0x9,0x8f,0x7,0x6f,0xd4,0xd5,0x39, + 0xb1,0xd4,0x3a,0x8,0x21,0x97,0x37,0x37,0x37,0xff,0x3a,0x1c,0xe,0x87,0xc,0x15, + 0x60,0x92,0xaa,0x9,0x6e,0x57,0x57,0xd7,0x35,0x84,0x90,0x6f,0x97,0xca,0x63,0xc5, + 0x5,0x1e,0x1b,0x1b,0x43,0x38,0x1c,0xce,0xdb,0xe6,0x1,0xf0,0x0,0x80,0xf3,0xee, + 0xbb,0xf,0xa4,0xa5,0xc5,0x91,0x1b,0xdd,0x90,0x30,0xb9,0xc0,0x16,0xb3,0xc7,0x61, + 0x9f,0xd5,0xee,0xa9,0x23,0x37,0x85,0x2c,0x92,0xc6,0x46,0x88,0x7b,0xf7,0x42,0x8b, + 0x8b,0xe3,0x71,0xbc,0xae,0xa,0x17,0x33,0x42,0x85,0xba,0xe1,0x25,0x84,0x9c,0x13, + 0xa,0x85,0x7e,0x66,0xea,0xe0,0x6,0xa9,0x8a,0xe0,0x6,0x2,0x81,0x79,0xc8,0x36, + 0x25,0x34,0x69,0xfd,0x6e,0xd5,0x67,0x43,0x2c,0x16,0xd3,0x9c,0x6a,0xf1,0x1f,0x12, + 0x9,0xfc,0xd5,0xa7,0x3e,0x5,0xcf,0xc5,0x17,0xbb,0x46,0x0,0xd8,0x67,0xb5,0xb3, + 0x2,0x50,0xb1,0x30,0xd9,0x64,0x4b,0x25,0xd7,0xc5,0xcd,0x23,0x1,0x49,0x6b,0x2b, + 0xa4,0xa3,0x47,0x41,0x23,0x11,0xa8,0xe1,0x0,0x5c,0x16,0x8b,0xe1,0xd9,0xc6,0x46, + 0xc4,0x15,0x91,0xb,0x55,0x8c,0x5a,0x58,0xd1,0xd2,0xd2,0x72,0x3c,0x14,0xa,0xed, + 0xd6,0x5d,0x98,0x49,0xaa,0x22,0xb8,0x9d,0x9d,0x9d,0x77,0x1,0xb8,0x41,0xeb,0x37, + 0xab,0x3e,0x1b,0x4,0x41,0x40,0x7f,0x7f,0x3f,0x24,0x29,0xbf,0xfd,0xfb,0xba,0x74, + 0x1a,0x5f,0xdd,0xb8,0x11,0xfe,0x4f,0x7e,0x52,0x2e,0xc4,0x11,0x1,0x60,0x9f,0xd5, + 0xe,0x89,0x81,0xc6,0x71,0xd8,0x48,0x40,0x87,0xea,0xa8,0xa1,0x21,0x6f,0x30,0x84, + 0x92,0x5a,0x49,0xc2,0xfa,0x44,0x2,0x4f,0xcf,0x9f,0x9f,0xd7,0x89,0x56,0x6a,0xa5, + 0x8,0x2b,0x9b,0x1c,0x8,0x21,0x97,0xb5,0xb4,0xb4,0x3c,0x68,0xf7,0x2,0x94,0xb6, + 0xb,0x6e,0x57,0x57,0xd7,0x7a,0x42,0xc8,0xcf,0xa1,0x5a,0x8,0x12,0xb0,0xf6,0x82, + 0x1d,0x3b,0x76,0x2c,0x6f,0x24,0x19,0x90,0xed,0x24,0x7b,0xb0,0xbe,0x1e,0x8d,0xdf, + 0xff,0x7e,0x76,0x70,0x43,0x95,0x6e,0x2e,0xf6,0x59,0xed,0x80,0x18,0x54,0x5a,0x17, + 0x2e,0xaf,0xa3,0xd9,0x10,0xb2,0x48,0x9a,0x9b,0x21,0x1d,0x38,0x0,0xc4,0xb4,0xe7, + 0x8f,0xe9,0x10,0x4,0xcc,0x93,0x24,0x6c,0x9f,0xee,0x44,0x93,0xc5,0xb6,0x4a,0x51, + 0xb,0x75,0x84,0x90,0x5,0xa1,0x50,0xe8,0x77,0xba,0xb,0x36,0x81,0xed,0x82,0xdb, + 0xd9,0xd9,0xf9,0x10,0x21,0xe4,0x74,0xf5,0x76,0x2b,0x2f,0x58,0x28,0x14,0x82,0x7a, + 0xa4,0x9e,0x1f,0xc0,0x4f,0xa7,0xa6,0x70,0xda,0x57,0xbf,0xa,0xee,0xb4,0xd3,0x6c, + 0xbd,0xb9,0xd8,0x67,0xb5,0x7b,0x4,0xc0,0xcd,0x9f,0xd5,0x7a,0x6d,0x99,0xcd,0x13, + 0xec,0x10,0xbf,0x1f,0xd2,0x9b,0x6f,0xa2,0x18,0x6b,0x93,0x49,0xbc,0xed,0xf7,0x63, + 0xa0,0xc8,0x44,0x37,0x36,0x47,0x2d,0x9c,0xd3,0xda,0xda,0xfa,0x74,0x28,0x14,0x2a, + 0x6c,0x97,0xb4,0x8,0xbe,0x7c,0x16,0xf3,0x74,0x75,0x75,0xdd,0x48,0x8,0xd9,0xa2, + 0xdc,0x66,0xf5,0x5,0x4b,0xa5,0x52,0x9a,0xeb,0x91,0xfd,0x73,0x3c,0x8e,0xd,0xd7, + 0x5d,0x7,0x8f,0x7a,0x22,0xf1,0x53,0x5,0x17,0xa6,0xcd,0x8a,0xab,0x1d,0x69,0x9b, + 0x8f,0xc3,0x86,0x28,0xbb,0xa7,0x8e,0xe6,0xd2,0x10,0x65,0xee,0xac,0xb3,0x40,0xfe, + 0xf8,0x47,0xcd,0x88,0x5,0x20,0x3b,0xe4,0xfe,0x73,0x43,0x43,0x38,0x58,0x5b,0x5b, + 0x30,0xe7,0x42,0xde,0x31,0xca,0x60,0x52,0x67,0x8,0xa5,0xf4,0x1e,0x64,0x23,0xa9, + 0x8c,0x15,0xa0,0x13,0xdb,0x3c,0xdc,0xad,0x5b,0xb7,0xfa,0x5,0x41,0xf8,0x3d,0x80, + 0x16,0x79,0x9b,0xd5,0x62,0x4b,0x29,0xc5,0xc0,0xc0,0x40,0xde,0xc,0x60,0x0,0x70, + 0x65,0x26,0x83,0x2f,0xd6,0xd4,0xa0,0xf6,0x1b,0xdf,0xc8,0x8e,0x76,0xa9,0xc0,0x1b, + 0x60,0x9f,0xd5,0xd6,0xda,0x52,0x49,0x7a,0x36,0x7c,0x56,0xcf,0xf9,0x58,0x6a,0x42, + 0x80,0x4c,0x6,0xd2,0xf4,0xa0,0x24,0x2d,0x7c,0x94,0xe2,0xac,0x64,0x12,0x4f,0x35, + 0x35,0xe5,0xa9,0x9e,0x1d,0x73,0x2d,0x68,0xe4,0x5d,0xda,0xd2,0xd2,0x72,0x38,0x14, + 0xa,0x69,0x37,0x36,0x57,0x88,0x6d,0x82,0xbb,0x64,0xc9,0x92,0x7f,0x0,0xf0,0x5e, + 0xf9,0x6f,0x3b,0x62,0xea,0xc6,0xc6,0xc6,0x72,0x93,0xd2,0xc8,0xb4,0x49,0x12,0x1e, + 0x9c,0x9a,0x42,0xcb,0x97,0xbf,0xc,0xcf,0x99,0x67,0x5a,0x77,0x13,0xb9,0xe4,0x46, + 0xd7,0x63,0xb,0xfb,0xac,0x76,0x4f,0x1d,0xb1,0x91,0x80,0x85,0x69,0xd2,0xd2,0x2, + 0xf1,0xb5,0xd7,0xf2,0x8f,0xa5,0x62,0x61,0x26,0x83,0x24,0xc7,0xa1,0x57,0x63,0x5d, + 0xb4,0x52,0x58,0xa4,0x33,0x97,0x2c,0x5a,0xb4,0xe8,0x47,0x63,0x63,0x63,0x96,0x4f, + 0x6e,0x63,0x8b,0xe0,0x5e,0x71,0xc5,0x15,0x8b,0x8,0x21,0x8f,0x21,0xdb,0x94,0x6a, + 0xd5,0x45,0xc8,0x23,0x91,0x48,0x68,0x86,0x80,0xdd,0x13,0x8b,0xe1,0xdc,0x4b,0x2f, + 0x85,0xff,0xc3,0x1f,0x2e,0x7b,0x73,0xb1,0xde,0x6a,0x6b,0x6d,0xa9,0x58,0x98,0x5c, + 0x62,0x4b,0x25,0xd7,0x85,0x4d,0xb0,0x53,0xde,0x16,0xe2,0xf5,0x82,0xe,0xd,0x81, + 0xaa,0xe2,0xe5,0xd5,0x9c,0x17,0x8f,0x63,0x47,0x7d,0x3d,0xc6,0xa7,0x9b,0x16,0x94, + 0x1d,0x68,0x5a,0x3a,0x61,0xa1,0xce,0x34,0xa,0x82,0x20,0x85,0xc3,0xe1,0x17,0x74, + 0x17,0xa8,0x13,0x5b,0x4,0x77,0xd5,0xaa,0x55,0xf7,0x0,0xb8,0x14,0xb0,0x47,0x6c, + 0xe5,0xa6,0x4,0x41,0x10,0xf2,0xb6,0xff,0x55,0x3a,0xd8,0x75,0xce,0xf9,0x0,0x0, + 0x20,0x0,0x49,0x44,0x41,0x54,0x8d,0x8f,0x48,0x12,0x6a,0xbf,0xf5,0x2d,0x90,0x79, + 0xf3,0x9c,0x17,0x26,0x2b,0x1f,0xba,0x4a,0x85,0xc9,0x6,0x5b,0xcc,0x5e,0x97,0x39, + 0xff,0x59,0x6d,0x83,0x2d,0x95,0x5c,0x17,0x27,0x3a,0x7d,0x89,0xd7,0x5b,0xb2,0xf3, + 0xc,0xc8,0x86,0x35,0x9d,0x93,0x48,0xe0,0xf,0xf3,0xe7,0x43,0xd2,0x88,0xcf,0x95, + 0xed,0xb6,0xa3,0x23,0x8d,0x10,0x72,0x71,0x7b,0x7b,0xfb,0x43,0xc1,0x60,0xb0,0x30, + 0x70,0xb8,0x2,0x2c,0x17,0xdc,0xae,0xae,0xae,0xb3,0x0,0xfc,0x88,0xda,0xb8,0x64, + 0x8e,0x56,0x53,0xc2,0x62,0x4a,0xf1,0xa3,0xa9,0x29,0xd4,0xdf,0x7a,0x2b,0xbc,0xdd, + 0xdd,0xc6,0x84,0xc9,0xa5,0x2,0xc0,0x3e,0xab,0xad,0xb7,0xa5,0x92,0xeb,0xc2,0x46, + 0x2,0x5a,0x67,0xb,0x69,0x6a,0x82,0xb4,0x77,0x2f,0xa0,0xea,0x7f,0x51,0xd3,0x24, + 0x8a,0xf0,0x2,0x78,0x4d,0x31,0xdf,0x2,0x90,0x15,0x5d,0x49,0x92,0xc,0xe9,0x86, + 0x41,0x61,0xe6,0x25,0x49,0x6a,0xa,0x87,0xc3,0x96,0x86,0x89,0x59,0x2e,0xb8,0x2b, + 0x56,0xac,0xf8,0x21,0xa5,0x74,0x9d,0xde,0xfc,0x46,0xdf,0x4e,0xc9,0x64,0x12,0x27, + 0x4e,0x9c,0xc8,0xdb,0x8f,0x23,0x4,0x3f,0x98,0x9a,0xc2,0xe9,0x6d,0x6d,0xa8,0xf9, + 0xd2,0x97,0xb2,0x73,0x25,0x64,0xb,0x77,0xc5,0xcd,0xa5,0x37,0x3d,0x1b,0xbc,0xd7, + 0xbc,0xf3,0x70,0x81,0x2d,0xb6,0x8,0x53,0x95,0x6d,0xa9,0xe4,0xba,0x54,0xb5,0xd3, + 0xd7,0xc8,0xb5,0x0,0x40,0x27,0x26,0xf2,0xd6,0x3e,0x2b,0xc6,0xd9,0x89,0x4,0x76, + 0xd5,0xd7,0x63,0x44,0x63,0xe8,0xaf,0xcd,0x51,0xb,0x1b,0x9a,0x9a,0x9a,0x7e,0x17, + 0x89,0x44,0x46,0xc,0xed,0x5c,0x2,0x4b,0x5,0x77,0xf3,0xe6,0xcd,0x17,0x51,0x4a, + 0xbf,0xd,0x9d,0x2b,0x49,0x98,0x79,0x3b,0xd,0xe,0xe,0x22,0x9d,0x3e,0xd5,0x96, + 0x4d,0x8,0xc1,0xbb,0x52,0x29,0x7c,0x38,0x99,0x84,0xff,0xce,0x3b,0xc1,0xad,0x5e, + 0x2d,0xef,0xa0,0xdc,0xf9,0xd4,0xff,0x2e,0x11,0x0,0xc7,0xbd,0x57,0x65,0xba,0x82, + 0xe3,0xb3,0xcf,0xea,0x2a,0xd5,0x57,0xa5,0x75,0xe1,0xc6,0x3a,0xe2,0xb8,0xec,0x40, + 0x88,0x32,0x10,0x0,0xeb,0x13,0x9,0x3c,0xde,0xdc,0xc,0x51,0x35,0xa,0x4d,0x8f, + 0x86,0x54,0xe0,0x5,0x13,0x42,0x48,0x5b,0x38,0x1c,0x7e,0x4c,0x77,0x1,0x65,0xb0, + 0x54,0x70,0x3b,0x3b,0x3b,0x7f,0x0,0x60,0xb5,0x9e,0xbc,0x66,0x2e,0x42,0x24,0x12, + 0xc9,0xd,0x70,0x90,0x1b,0xd0,0xdb,0x24,0x9,0xf7,0x4f,0x4d,0xa1,0xee,0x8c,0x33, + 0xf2,0x87,0xef,0xca,0xff,0xbb,0xe4,0xe6,0x62,0x9f,0xd5,0xee,0x11,0x0,0xb7,0x7c, + 0x56,0x57,0x7a,0x5d,0x66,0x7c,0xc8,0xe2,0xbc,0x79,0x10,0xf7,0xec,0xc9,0x5b,0x11, + 0xa2,0x18,0x4d,0xa2,0x8,0x91,0x10,0xec,0xae,0x3f,0xb5,0x48,0xc,0x21,0x4,0x1c, + 0xc7,0x15,0xc,0xe7,0x57,0x62,0x41,0x93,0xc3,0xda,0xb6,0xb6,0xb6,0xff,0x9,0x85, + 0x42,0xe5,0x5d,0x71,0x1d,0x58,0x36,0xf0,0x61,0xd3,0xa6,0x4d,0x97,0xa0,0xc8,0x7c, + 0x9,0x6a,0xcc,0x5c,0x4,0x41,0x10,0x30,0x3c,0xfd,0xf9,0xa1,0x8c,0xc7,0xfb,0x42, + 0x3c,0x8e,0x26,0x4a,0xe1,0xfb,0xf0,0x87,0xe5,0x1d,0xcc,0xdf,0x14,0x16,0xa6,0xf5, + 0x4,0x81,0x57,0x3d,0x6d,0xf6,0x1c,0x5c,0x60,0x8b,0x25,0x75,0xe1,0x2,0x5b,0xcc, + 0x5e,0x17,0x47,0x6,0x79,0xd8,0x5d,0x17,0x84,0x80,0x5b,0xb9,0x12,0xd2,0xc1,0x83, + 0xd0,0xc3,0xff,0x19,0x1f,0xc7,0x9f,0x1a,0x1b,0x71,0xd4,0xef,0x3f,0xb5,0x36,0x21, + 0x21,0xf0,0x78,0x3c,0x5,0x73,0x5f,0x17,0x1c,0xab,0xc,0x25,0xf2,0x12,0x49,0x92, + 0xee,0x2,0xf0,0x4e,0xdd,0x85,0x95,0xc0,0x32,0xf,0x77,0xc5,0x8a,0x15,0xf,0x0, + 0x28,0x18,0xc2,0xab,0xc6,0xec,0x45,0x18,0x19,0x19,0x41,0x3c,0x1e,0xcf,0x13,0xdb, + 0xab,0xd3,0x69,0x7c,0x2a,0x91,0x0,0xb7,0x7a,0x35,0x7c,0xb7,0xdf,0x2e,0xef,0xa4, + 0x2c,0x40,0x7f,0xba,0x82,0xb7,0x3e,0xfb,0xac,0xb6,0xde,0x16,0xb3,0xd7,0x65,0xc6, + 0x7d,0x56,0x17,0xb1,0x65,0xce,0x74,0xfa,0xa,0x2,0xa4,0x23,0x47,0xa0,0x7,0xf, + 0x80,0x35,0xc9,0x24,0x9e,0x6c,0x6e,0x6,0x2d,0xd1,0xb4,0x60,0x43,0xd4,0xc2,0x9a, + 0xa6,0xa6,0xa6,0xa7,0x22,0x91,0x48,0xc5,0x43,0x7e,0x2d,0xf1,0x70,0xbb,0xba,0xba, + 0xba,0x0,0x5c,0x5b,0x2a,0x4f,0x25,0x17,0x21,0x99,0x4c,0x22,0x12,0x89,0xe4,0x89, + 0xad,0x9f,0x52,0x7c,0x7e,0x7a,0xd9,0xe,0xdf,0x87,0x3e,0x64,0xcd,0xcd,0xa2,0x33, + 0xcd,0xbc,0x57,0x6b,0x6d,0xb1,0xa4,0x2e,0x5c,0x60,0x8b,0xd9,0xeb,0x32,0x2b,0xbd, + 0x57,0x9d,0x69,0x6e,0xc9,0x12,0x18,0x61,0x5d,0x22,0x81,0xad,0x91,0x8,0x9e,0x68, + 0x6e,0xce,0x6d,0x93,0x9b,0x16,0x44,0x51,0x34,0xa4,0x33,0x46,0xf2,0x72,0x1c,0xf7, + 0x45,0x0,0x7f,0x61,0xc4,0x56,0x2d,0xac,0x6a,0x52,0xf8,0x97,0x52,0x3f,0x56,0x7a, + 0x11,0x46,0x46,0x46,0xa,0xb6,0x7f,0x34,0x99,0xc4,0x52,0x49,0x82,0x67,0xfd,0x7a, + 0x78,0xce,0x3f,0xbf,0xf4,0x8d,0x54,0xe5,0x9b,0xa8,0x64,0xda,0xa1,0x87,0xbe,0xa8, + 0xf7,0xea,0x80,0x2d,0x66,0xaf,0xcb,0x9c,0x9c,0xc7,0xa2,0x8a,0x76,0x19,0x49,0x5b, + 0x56,0x17,0x35,0x35,0x20,0x4d,0x4d,0x9a,0xf3,0xe4,0x16,0xe3,0x13,0x23,0x23,0x78, + 0xa9,0xb1,0x11,0x13,0x9e,0x53,0x1f,0xe8,0x1e,0x8f,0xc7,0x50,0x98,0x98,0x9,0x4d, + 0xda,0xba,0x6a,0xd5,0xaa,0xb,0x8f,0x1c,0x39,0xb2,0x4b,0xf7,0x8e,0x1a,0x54,0xdc, + 0xa4,0x70,0xc5,0x15,0x57,0x5c,0x4c,0x8,0xf9,0x7a,0xb1,0xdf,0x2b,0x15,0xdb,0xa9, + 0xa9,0x29,0x8c,0x8f,0x8f,0xe7,0x6d,0x5b,0x2a,0x49,0xb8,0x37,0x16,0x3,0xf,0xc0, + 0xff,0x89,0x4f,0x64,0xdf,0x92,0x94,0xe6,0xdf,0x98,0x26,0x6f,0x52,0xdb,0x3f,0xab, + 0xd,0xd8,0x52,0xf4,0xa1,0x2b,0x93,0xb6,0xb5,0x53,0xc8,0xa0,0x2d,0x95,0x5c,0x17, + 0x36,0x12,0xd0,0x2,0xbb,0x2c,0x3a,0xbe,0x9d,0x9d,0xbe,0x34,0x18,0x4,0x55,0x3d, + 0xe3,0xa5,0xf0,0x53,0xa,0x2f,0xa5,0x78,0x55,0x15,0x9b,0x2b,0x7b,0xb9,0xe5,0x30, + 0xa9,0x49,0x4,0x40,0x7b,0x38,0x1c,0xfe,0xb5,0xee,0x9d,0x35,0xb0,0xc2,0xc3,0xbd, + 0xb3,0xd8,0xf,0x95,0x8a,0xad,0x24,0x49,0xb9,0x8e,0x32,0x25,0xff,0x14,0x8f,0xc3, + 0x4f,0xb3,0x9f,0x23,0x9e,0x8b,0x2e,0x2,0xe4,0x5e,0x4a,0x2b,0xc4,0xd5,0xaa,0xb4, + 0x9d,0x65,0xab,0xd2,0xec,0xb3,0xda,0x3d,0x75,0xc4,0xbc,0x57,0xe3,0x69,0x6e,0xd1, + 0xa2,0xb2,0xa3,0xce,0xd4,0xfc,0x65,0x28,0x84,0xc7,0x9b,0x9b,0x71,0xd4,0xef,0x7, + 0x70,0x2a,0x6a,0xa9,0x58,0x7,0xda,0xa9,0xc3,0x55,0xa4,0x49,0x37,0xad,0x58,0xb1, + 0x62,0x4d,0x7f,0x7f,0xbf,0x31,0x63,0x15,0x54,0x24,0xb8,0x57,0x5e,0x79,0x65,0xa7, + 0x20,0x8,0x37,0xab,0xb7,0x5b,0xd5,0x68,0x1d,0x8d,0x46,0xf3,0x62,0x6e,0x1,0xe0, + 0x62,0x41,0xc0,0x3b,0xa6,0xb7,0xf1,0x37,0xdd,0x64,0xe8,0x86,0x65,0x9f,0xd5,0xee, + 0x11,0x0,0xc3,0xde,0xab,0x8d,0xb6,0x98,0xbd,0x2e,0x8e,0xbc,0x24,0x8a,0xd8,0xe2, + 0xc8,0x4b,0xc2,0x22,0xbb,0x48,0x6b,0x2b,0x8c,0xe2,0xa1,0x14,0x7f,0x37,0x34,0x84, + 0x3b,0x57,0xac,0xc8,0xeb,0xdb,0xe1,0x79,0xbe,0xa8,0xe0,0x5a,0xd0,0xbe,0xcb,0x71, + 0x1c,0xf7,0x49,0x0,0x1f,0x33,0x66,0xed,0x29,0x2a,0x12,0xdc,0x4c,0x26,0xf3,0x49, + 0x42,0x48,0x5e,0x19,0x56,0x35,0x5a,0x4b,0x92,0x84,0xb1,0xb1,0xb1,0xbc,0x6d,0x1c, + 0x80,0xcf,0x4f,0xcf,0x16,0x4f,0x1a,0x1a,0xc0,0x5f,0x75,0xd5,0x29,0xef,0x36,0x5b, + 0xa0,0x76,0xd9,0x33,0xe0,0xa6,0x67,0xc2,0xe4,0xfe,0x3a,0xb2,0x6c,0x82,0x1d,0xb, + 0x6c,0xb1,0xe4,0x3c,0x5c,0x60,0xb,0x28,0x5,0x69,0x68,0x0,0x78,0x1e,0x50,0xcd, + 0x8d,0x52,0x8e,0x8b,0x62,0x31,0x5c,0x36,0x35,0x85,0xed,0xd,0xd,0xb9,0x6d,0x5a, + 0x5e,0xae,0xc5,0x51,0xb,0x1f,0x38,0xf3,0xcc,0x33,0xbf,0x70,0xe8,0xd0,0x21,0xfd, + 0x6d,0x20,0xa,0x4c,0xb,0x6e,0x20,0x10,0x68,0x92,0x24,0xe9,0x76,0xe5,0x36,0x2b, + 0x7b,0x8,0x43,0xa1,0x50,0xc1,0xe4,0x34,0x37,0xa6,0xd3,0x58,0x37,0x7d,0x21,0xf9, + 0x2d,0x5b,0x40,0xbc,0xde,0x5c,0xe5,0xb1,0xcf,0x6a,0xf7,0x8,0x0,0xfb,0xac,0x76, + 0x4f,0x1d,0x39,0xed,0xbd,0xea,0x16,0xdd,0xa6,0x26,0x43,0xed,0xb8,0x32,0x1f,0x1b, + 0x19,0xc1,0xab,0xd,0xd,0x50,0xe,0x7d,0x50,0x7a,0xb9,0x36,0x44,0x2d,0xd4,0x9, + 0x82,0xf0,0x31,0x0,0x77,0x1b,0xb1,0x33,0x67,0x9b,0x99,0x9d,0x0,0x40,0x92,0xa4, + 0xbf,0x1,0x90,0x7b,0xb5,0x58,0x79,0x62,0x92,0x24,0x15,0x2c,0x99,0xe3,0x3,0xf0, + 0xa9,0xe9,0x30,0x30,0x10,0x2,0xfe,0xda,0x6b,0x91,0xd7,0x90,0x9f,0x2d,0xd8,0xda, + 0x74,0xb5,0x3c,0xd,0x17,0xd8,0x62,0xf6,0xba,0x38,0x2e,0x4c,0x4e,0xbf,0x24,0x6c, + 0xb6,0xcb,0x92,0xf3,0x70,0xba,0x8e,0x74,0xd8,0x62,0x56,0x70,0x57,0x26,0x93,0xb8, + 0x26,0x12,0xc1,0xd3,0x4d,0xa7,0x16,0x4,0x97,0xbd,0x5c,0xb5,0xc3,0x56,0xa,0x83, + 0xfa,0xf5,0xf1,0xa5,0x4b,0x97,0x7e,0x73,0x70,0x70,0x30,0x61,0xc8,0x58,0x98,0x14, + 0xdc,0xb,0x2e,0xb8,0xc0,0x8b,0xe9,0xce,0x32,0x1b,0x82,0x8c,0x11,0xc,0x6,0xb, + 0xda,0x61,0xde,0x9d,0x4a,0x61,0xc9,0x74,0xf3,0x1,0xb7,0x7a,0x35,0xc8,0xe2,0xc5, + 0xda,0xcd,0x9,0x4e,0xdf,0x50,0x45,0x6c,0x61,0xc2,0x64,0xbd,0x2d,0x96,0x9c,0x87, + 0xb,0x6c,0x31,0x7b,0x5d,0x66,0x53,0xa7,0x2f,0x99,0x3f,0x1f,0x66,0xf9,0xd0,0xe8, + 0x28,0x9e,0x9b,0x3f,0x3f,0x6f,0x9e,0x5,0x9f,0xcf,0xa7,0x5b,0x70,0x4d,0x38,0x8b, + 0xb,0xbc,0x5e,0xef,0x5f,0x3,0xf8,0xb1,0x31,0x4b,0x4d,0xa,0xee,0xbc,0x79,0xf3, + 0xde,0x49,0x29,0x5d,0x62,0x87,0xd8,0x8a,0xa2,0x88,0x50,0x28,0x94,0xb7,0xcd,0xf, + 0xe0,0x13,0x89,0x53,0x2f,0x13,0x3e,0x10,0x30,0x1d,0x99,0x50,0xad,0x9b,0x8b,0x7d, + 0x56,0xbb,0x47,0x0,0x98,0xf7,0xea,0x9e,0x3a,0x2a,0x56,0x17,0xc4,0xe0,0xca,0xe, + 0x4a,0x96,0xa4,0xd3,0xb8,0x6e,0x7a,0x30,0x84,0xb2,0x3,0xcd,0xeb,0xf5,0x16,0x2c, + 0xbf,0xa5,0xa6,0x82,0x2f,0xf3,0xff,0x8b,0x6a,0x9,0xae,0x24,0x49,0x86,0x7a,0xe9, + 0x8c,0x9c,0x54,0x28,0x14,0xca,0xf3,0x6e,0x9,0x21,0xb8,0x39,0x99,0xc4,0x62,0x59, + 0x60,0xbd,0x5e,0xf0,0x97,0x5d,0x56,0xb4,0xb3,0xcc,0x89,0x9b,0xcb,0x71,0x61,0x72, + 0xfa,0x25,0x61,0x83,0x2d,0x96,0x9c,0x87,0xb,0x6c,0x31,0x7b,0x5d,0x66,0x93,0xf7, + 0xaa,0xcb,0x96,0xa,0x4,0x17,0x98,0xf6,0x72,0x9b,0x9b,0xa1,0x94,0xd7,0x52,0x82, + 0x6b,0x81,0xb3,0xb8,0x7e,0xe5,0xca,0x95,0x57,0x1c,0x3d,0x7a,0xf4,0x25,0x23,0xe5, + 0x18,0x16,0xdc,0x4d,0x9b,0x36,0x9d,0x9,0x60,0xb3,0xde,0xfc,0x46,0x4e,0x4c,0x14, + 0xc5,0xbc,0xb6,0x5b,0x42,0x8,0xfc,0x94,0xe6,0x79,0xb7,0x9e,0x73,0xcf,0xcd,0x56, + 0x8e,0x99,0x9b,0x87,0x9,0x13,0x13,0x26,0x97,0xd6,0xd1,0x5c,0xef,0xf4,0x25,0x45, + 0x96,0x45,0xd7,0xcb,0xc2,0x4c,0x6,0x5b,0xc3,0x61,0xfc,0xbe,0xa5,0x25,0x6f,0x3b, + 0xcf,0xf3,0x5,0x4d,0xb,0x16,0x7e,0x99,0xdf,0xe,0xc0,0x5e,0xc1,0x25,0x84,0xfc, + 0xd,0x6c,0x9a,0xef,0x36,0x12,0x89,0x40,0x92,0xa4,0xbc,0xcf,0x82,0xf7,0xa4,0x52, + 0x58,0xa0,0xf0,0x66,0xf9,0xcb,0x2e,0xcb,0x56,0x54,0x95,0x6e,0x2e,0xc7,0xbd,0x57, + 0x65,0xda,0xe9,0x97,0x84,0x45,0xb6,0x58,0x7e,0x1e,0x4e,0xd7,0x8b,0x41,0x5b,0x58, + 0xc8,0xa2,0x46,0xda,0xef,0x7,0x38,0x2e,0xff,0xcb,0xd5,0x20,0x7f,0x3d,0x36,0x86, + 0x27,0x9b,0x9b,0x21,0xa8,0x9a,0x15,0x94,0x82,0x6b,0x71,0xd4,0xc2,0x5f,0x2e,0x5d, + 0xba,0xf4,0xce,0xc1,0xc1,0xc1,0x50,0xb9,0x8c,0x32,0x86,0x4,0x77,0xeb,0xd6,0xad, + 0xfe,0xa9,0xa9,0xa9,0xf,0xe9,0xc9,0x6b,0xf4,0xc4,0x28,0xa5,0x8,0x85,0x42,0xf9, + 0x6d,0x30,0x0,0x3e,0xae,0xf0,0x6e,0xe1,0xf5,0xc2,0x73,0xe1,0x85,0xb6,0x76,0x96, + 0x31,0xef,0xd5,0x3d,0x2,0xc0,0xbc,0x57,0xf7,0xd4,0x51,0x55,0x5e,0x12,0x5e,0x2f, + 0x90,0x4a,0xc1,0x2c,0x8b,0xd2,0x69,0x5c,0x13,0x89,0xe0,0x49,0xd5,0xc4,0x36,0xb2, + 0x97,0x6b,0x43,0x88,0x58,0xad,0xd7,0xeb,0x7d,0x3f,0x80,0xef,0xeb,0x2d,0xd7,0x90, + 0xe0,0xc6,0x62,0xb1,0x9b,0x0,0xb4,0x95,0xca,0x63,0xd6,0x5d,0x9f,0x9c,0x9c,0x2c, + 0x70,0xfd,0xb7,0xa6,0x52,0x58,0xa8,0x10,0x57,0xcf,0x99,0x67,0x66,0x2b,0x85,0x52, + 0x4b,0x2a,0x9a,0x79,0xaf,0xd6,0xdb,0xc2,0x84,0xc9,0x3d,0xb6,0x38,0x72,0x4f,0x55, + 0x70,0x4c,0xc2,0xf3,0xa0,0x15,0x8,0x2e,0x0,0xbc,0x6f,0x6c,0xc,0x4f,0x37,0x37, + 0xe7,0xe2,0x72,0x9,0x21,0xba,0x3a,0xcf,0x94,0x18,0x14,0xe6,0xdb,0x61,0x97,0xe0, + 0x4e,0x17,0x5e,0xea,0x77,0x23,0x65,0xe5,0xfd,0xad,0x8e,0x4c,0x20,0x0,0xee,0x48, + 0xe4,0x87,0xb9,0x71,0xe7,0x9e,0x5b,0x51,0x67,0xd9,0xac,0x16,0x26,0xa7,0x5,0xc8, + 0xa0,0x2d,0xec,0xb3,0xda,0x3d,0x75,0xe4,0xb8,0xe3,0x21,0xff,0xcf,0x57,0x3e,0xb5, + 0x4b,0x67,0x2a,0x85,0x4b,0x26,0x27,0xb1,0xbd,0xa1,0x21,0xf7,0xb5,0xcc,0x71,0x9c, + 0x66,0x5b,0xae,0x16,0x26,0x34,0x6c,0xfd,0x8a,0x15,0x2b,0x2e,0xed,0xef,0xef,0xdf, + 0xa1,0x67,0x1f,0xdd,0x67,0x18,0x8,0x4,0x4e,0x17,0x45,0x71,0x4b,0x99,0x83,0xeb, + 0x42,0x9d,0x37,0x91,0x48,0x20,0x99,0x4c,0xe6,0x6d,0xdb,0x98,0xc9,0x60,0x8d,0x2a, + 0x16,0xd7,0xb3,0x61,0x83,0xb9,0x87,0xda,0xe9,0x1b,0x4a,0x99,0x76,0xfa,0x25,0x51, + 0x81,0x2d,0xb6,0xa,0x93,0xd3,0xf5,0xa2,0xc3,0x16,0xe6,0xbd,0xda,0x7c,0xce,0x16, + 0x8,0x2e,0x0,0xfc,0xd5,0xd8,0x18,0x76,0x34,0x36,0xe6,0x6d,0x53,0xb7,0xe5,0xaa, + 0xa9,0xb0,0x23,0xed,0x76,0x0,0xd6,0xa,0xae,0x20,0x8,0xef,0x27,0xca,0x6,0xd6, + 0xe2,0x7,0x2f,0x89,0x56,0x5e,0xb5,0x77,0xb,0x0,0x7f,0xa3,0xf2,0x6e,0x49,0x73, + 0x33,0xb8,0x62,0x83,0x1d,0xd4,0xe5,0xba,0xf4,0x46,0x37,0xfd,0x30,0x38,0x2d,0x40, + 0x6,0x6d,0x61,0xc2,0xe4,0x9e,0xfa,0x72,0xdc,0x7b,0x55,0xa6,0xcb,0xfd,0xae,0x2d, + 0x2f,0x86,0x39,0x2f,0x16,0xc3,0xda,0x78,0x1c,0x6f,0x28,0x42,0xcd,0x3c,0x1e,0x4f, + 0xd1,0xf5,0xcf,0x2c,0x68,0xdb,0xbd,0x79,0xe9,0xd2,0xa5,0x9f,0xd0,0x33,0xf2,0x4c, + 0xb7,0xe0,0x12,0x42,0xde,0x67,0xc0,0x0,0x4d,0xb4,0xf2,0xa,0x82,0x80,0xa9,0xa9, + 0xa9,0xbc,0x6d,0x6b,0x4,0x1,0x9b,0x55,0x6d,0x2e,0xdc,0xda,0xb5,0x4c,0x98,0x5c, + 0x2a,0x0,0xec,0xb3,0xda,0x3d,0x75,0x34,0xa3,0x3b,0x7d,0x2b,0x88,0x50,0x50,0x73, + 0xcb,0xf8,0x38,0xee,0x5a,0xbe,0x3c,0x6f,0x9b,0xd7,0xeb,0x45,0x4a,0xd5,0x46,0x6c, + 0x51,0x47,0x5a,0x83,0xd7,0xeb,0xbd,0x1,0xc0,0xa3,0xe5,0xca,0xd0,0x25,0xb8,0x97, + 0x5d,0x76,0xd9,0xb9,0x0,0xce,0xd4,0x79,0x70,0x4d,0x8a,0xe5,0x8f,0x44,0x22,0x5, + 0xbf,0xdd,0xa6,0xd1,0x70,0xce,0xad,0x5a,0x5,0x5b,0xe6,0x4e,0xa8,0xe2,0xd,0xc5, + 0x3e,0xab,0xdd,0x53,0x47,0xcc,0x7b,0x75,0x4f,0x1d,0x69,0x36,0xfd,0x55,0x48,0x57, + 0x34,0x8a,0xb6,0x4c,0x6,0xe3,0x5e,0x6f,0x6e,0x1b,0xcf,0xf3,0x48,0xa7,0xd3,0xb9, + 0xe3,0x59,0x3c,0xff,0xcb,0xcd,0xb0,0x4a,0x70,0x3d,0x1e,0x4f,0xde,0x9c,0xb7,0x56, + 0x19,0x4a,0x29,0x45,0x34,0x1a,0xcd,0xdb,0xd6,0x48,0x29,0xde,0xa5,0x25,0xb8,0x2b, + 0x57,0x5a,0x3b,0x9c,0xb7,0x92,0xb4,0x9d,0xf,0xb4,0xd,0xb6,0x30,0x61,0x72,0x8f, + 0x2d,0x8e,0xd4,0x85,0xd,0xb6,0x58,0x7e,0x1e,0x94,0x5a,0xea,0xe1,0xf2,0x94,0xe2, + 0x86,0x50,0x8,0x3f,0xed,0xe8,0xc8,0x6d,0x93,0x3b,0xcf,0xd4,0x73,0x6c,0x97,0x43, + 0x8f,0xde,0x11,0x42,0xae,0x5f,0xb7,0x6e,0xdd,0xbc,0xbe,0xbe,0xbe,0xa9,0x52,0xf9, + 0xf4,0x36,0x29,0xdc,0x6a,0xe4,0xe0,0x7a,0xf3,0xc6,0xe3,0xf1,0x82,0x70,0x8d,0x1b, + 0xd3,0x69,0xf8,0xd5,0xfb,0xf1,0x3c,0xb8,0xa5,0x4b,0xb3,0x95,0xe2,0xd2,0x9b,0x8b, + 0x7d,0x56,0xbb,0x47,0x0,0x66,0xf4,0x67,0xb5,0xd6,0x79,0xb8,0xc0,0x16,0xb3,0xd7, + 0xc5,0xf4,0x73,0x61,0x1,0xef,0x8,0x85,0xf0,0xb3,0x5,0xb,0x20,0x4d,0xaf,0x6, + 0x1,0x64,0x9b,0x15,0x8c,0x8,0xae,0x1,0xbd,0xab,0x8b,0xc5,0x62,0xef,0x0,0xf0, + 0x48,0xa9,0x4c,0x65,0x5,0xf7,0x8a,0x2b,0xae,0x38,0x1f,0xc0,0x2a,0x83,0x7,0xd7, + 0x95,0x37,0xa2,0x5a,0x38,0x8e,0x10,0x82,0xf7,0xa9,0xa2,0x15,0x0,0x80,0x5b,0xbe, + 0x3c,0x7f,0x14,0x8a,0xc3,0x37,0x17,0xfb,0xac,0x76,0x8f,0x0,0x38,0xfe,0x92,0x50, + 0xa6,0x9d,0x7e,0x49,0x58,0x64,0x8b,0xe5,0xe7,0xa1,0xb3,0xc,0x6a,0xd0,0xf3,0x2c, + 0x47,0x7b,0x26,0x83,0x4b,0xa6,0xa6,0xf2,0x22,0x16,0x4a,0x75,0x9e,0x29,0x31,0xd9, + 0x64,0x7a,0xb,0x2a,0x15,0x5c,0x42,0xc8,0x2d,0xe5,0x8c,0x2b,0x72,0xf0,0x92,0xa8, + 0x3b,0xcb,0x8,0x21,0x38,0x5b,0x10,0xb0,0x5a,0x23,0x74,0x83,0x5b,0xb6,0xac,0x74, + 0xe5,0x39,0x71,0x13,0x39,0x64,0x8b,0xd9,0x87,0xce,0x71,0x61,0x72,0xfa,0x25,0x61, + 0x83,0x2d,0x96,0x9c,0x87,0xb,0x6c,0x31,0x7b,0x5d,0x2c,0xbf,0xa7,0x2c,0x16,0x5c, + 0x0,0xb8,0x21,0x14,0x2a,0x8,0x11,0xf3,0xf9,0x7c,0x5,0x61,0xa8,0x4a,0x2a,0x70, + 0x2c,0xb7,0x9e,0x7e,0xfa,0xe9,0x8d,0x87,0xf,0x1f,0x9e,0x28,0x96,0xbf,0x9c,0xe0, + 0x12,0x49,0x92,0x6e,0x31,0x79,0xf0,0x92,0x4c,0x4c,0x4c,0x80,0x52,0x9a,0x37,0x94, + 0xf7,0xbd,0x45,0x2e,0x2,0x59,0xb0,0xc0,0xde,0xd9,0xc1,0x98,0x30,0x31,0x61,0x9a, + 0x49,0xc2,0x54,0x81,0x2d,0xb6,0xde,0x53,0x95,0x1c,0x27,0x93,0xb1,0xb4,0xd,0x57, + 0x66,0xe3,0xc4,0x4,0x5a,0x33,0x19,0x4,0x15,0x9d,0x67,0x5e,0xaf,0xb7,0xa8,0xe0, + 0x56,0xf8,0x15,0x5f,0x93,0xc9,0x64,0x6e,0x0,0xf0,0xab,0x62,0xfb,0x94,0x14,0xdc, + 0xcb,0x2e,0xbb,0xec,0x1c,0x0,0x2b,0x4d,0x1e,0xbc,0x24,0xd1,0x68,0x34,0x4f,0x6c, + 0xeb,0x29,0xc5,0x4d,0x45,0x86,0xf5,0x91,0xd6,0xd6,0x6c,0xe5,0x38,0x71,0x13,0x15, + 0x4b,0x3b,0xfd,0xd0,0x2b,0xd2,0x8e,0xbf,0x24,0x94,0x69,0xa7,0x5f,0x12,0x16,0xd9, + 0x62,0xf9,0x79,0x38,0x5d,0x2f,0x6,0x6d,0xa9,0x76,0xa7,0xaf,0xd5,0xcd,0x9,0x32, + 0x1e,0x4a,0xb1,0x35,0x1c,0xc6,0x2f,0x17,0x2c,0xc8,0x6d,0x53,0xce,0xaf,0xa0,0xc4, + 0xa2,0x26,0xd3,0x77,0xc2,0xac,0xe0,0x72,0x1c,0xf7,0x8e,0xa,0xf,0xae,0x99,0x37, + 0x9d,0x4e,0x17,0x34,0x5c,0x5f,0x95,0x4e,0xa3,0xae,0x48,0x39,0xa4,0xad,0xcd,0xbc, + 0x87,0xeb,0xc4,0x4d,0xa4,0xc3,0x16,0xc7,0x85,0xc9,0xe9,0x6b,0x1,0xc5,0x79,0xb8, + 0xc0,0x16,0xb3,0xd7,0x85,0x79,0xaf,0x16,0xa5,0xa7,0x17,0x87,0xb5,0x83,0xab,0x55, + 0x82,0xb,0xe4,0x8f,0x3c,0xb3,0x2a,0xc4,0x75,0x9a,0x6b,0xd7,0xad,0x5b,0xe7,0xeb, + 0xeb,0xeb,0xd3,0x7c,0x83,0x94,0x6b,0x52,0xd8,0x5a,0xe1,0xc1,0x35,0xf3,0xaa,0x7, + 0x3a,0x0,0xc0,0x5f,0x14,0x9b,0xb4,0x82,0x10,0xd3,0x1e,0xee,0x6c,0xf0,0x5e,0xb3, + 0x49,0x17,0xda,0xc5,0x84,0xc9,0x71,0x5b,0xcc,0x5e,0x17,0x37,0x76,0xfa,0x52,0x79, + 0xbd,0x42,0x1b,0x58,0x91,0x4c,0xe2,0xb4,0x44,0x2,0x6f,0xd7,0xd6,0xe6,0x45,0x2b, + 0x24,0x93,0xc9,0xb2,0x9d,0x67,0x4a,0x74,0x6a,0x5d,0xc3,0xd4,0xd4,0xd4,0xe5,0x0, + 0x5e,0xd0,0xfa,0xb1,0xa8,0xe0,0x6e,0xdc,0xb8,0xb1,0x5,0xc0,0x25,0x16,0x18,0x50, + 0x90,0x77,0x62,0x22,0xbf,0x4d,0xb9,0x89,0x52,0x5c,0x51,0xe4,0x93,0x82,0xd4,0xd7, + 0x67,0x57,0xe7,0x2d,0xe3,0xe1,0x3a,0xee,0xbd,0x2a,0xd3,0x76,0x3e,0xd0,0x55,0xb4, + 0xc5,0xf2,0xf3,0x70,0xba,0x5e,0xc,0xda,0x32,0x27,0x63,0xa9,0x9d,0xaa,0x17,0x1b, + 0x5,0x17,0x0,0xba,0x23,0x11,0x1c,0x51,0xc,0xf5,0x95,0x17,0x9a,0xd4,0x2b,0xb8, + 0x46,0xb4,0x8e,0x10,0x72,0x1d,0x8c,0xa,0x2e,0xc7,0x71,0x57,0x1,0xf0,0x54,0x7a, + 0x70,0x75,0xfe,0x54,0x2a,0x55,0xd0,0x9c,0x70,0x65,0x2a,0x5,0xaf,0x7a,0x27,0x99, + 0xfa,0x7a,0xcd,0x70,0x30,0xf6,0x59,0xed,0x1e,0x1,0x60,0xde,0xab,0x7b,0xea,0xc8, + 0x8d,0xde,0xab,0x9e,0xb4,0x9d,0x1e,0x2e,0x0,0x6c,0x89,0x44,0xf0,0xc0,0xe2,0xc5, + 0x79,0xdb,0xf4,0x4e,0xdb,0x68,0xd4,0xb1,0xa4,0x94,0x6e,0x5,0xf0,0x19,0xad,0xdf, + 0x4b,0x35,0x29,0x68,0x36,0x27,0x54,0xda,0xb0,0xac,0xd9,0x9c,0x50,0xa2,0xc1,0x9c, + 0xd4,0xd6,0x82,0x3a,0xbd,0x7e,0x59,0xb1,0x34,0x13,0x26,0xc7,0x6d,0x99,0x6b,0xc2, + 0xa4,0x4e,0xcf,0x86,0x66,0x33,0x4a,0xa9,0xed,0x82,0xbb,0x38,0x9d,0xc6,0x99,0x89, + 0x4,0xe,0xd5,0xd6,0xe6,0xb6,0xf9,0x7c,0x3e,0x24,0x12,0x89,0x92,0x9a,0x66,0x52, + 0xef,0xd6,0xaf,0x5a,0xb5,0x6a,0xf9,0x91,0x23,0x47,0x8e,0xa9,0xf3,0x14,0x13,0x5c, + 0x32,0xed,0x16,0x5b,0x71,0xf0,0x3c,0x26,0x27,0x27,0xf3,0xfe,0x6e,0xa6,0x14,0x97, + 0x95,0xea,0xa1,0xac,0xa9,0xa9,0xfc,0x26,0x71,0xe8,0x86,0x62,0x9f,0xd5,0xee,0xa9, + 0xa3,0x19,0xf1,0x59,0x5d,0xc6,0x16,0xc7,0x9b,0xcd,0xec,0xaa,0x8b,0x54,0xaa,0xa2, + 0x95,0x1e,0xf4,0x12,0x8,0x87,0xf3,0x4,0x17,0xc8,0xce,0xaf,0x60,0xc5,0x42,0x93, + 0xea,0xbc,0xa2,0x28,0x5e,0x3,0xe0,0x7e,0x75,0x3e,0x4d,0xc1,0x9d,0xe,0x7,0x5b, + 0x68,0xd5,0xc1,0x65,0x32,0x99,0x4c,0x41,0x73,0xc2,0xd5,0xe9,0x74,0xf1,0xe6,0x4, + 0x4c,0x2f,0x9f,0xec,0x84,0x87,0x5b,0x2d,0x4f,0xc3,0x6,0x5b,0x6c,0x15,0x26,0xa7, + 0x1f,0x7a,0x1d,0xb6,0x30,0xef,0xd5,0x3d,0x75,0xa4,0xe7,0x1c,0xe8,0x44,0xd1,0x71, + 0x2,0x96,0xd2,0x1d,0x89,0xe0,0xc7,0x8b,0x17,0x43,0xa9,0x4e,0x5a,0xcd,0xa,0x56, + 0x44,0x2d,0x50,0x4a,0xaf,0x83,0x5e,0xc1,0xf5,0x78,0x3c,0xd7,0x98,0x99,0x51,0xa7, + 0x5c,0xfe,0x98,0x2a,0xf4,0x83,0x10,0x82,0x2d,0xe5,0xe2,0xef,0x7c,0xbe,0xd2,0x37, + 0x92,0x43,0x37,0x14,0x13,0x26,0xf7,0x88,0xc1,0x5c,0x11,0xa6,0x99,0x50,0x47,0x66, + 0xce,0x83,0xaa,0xbe,0x7a,0xed,0x62,0x51,0x3a,0x8d,0x95,0xc9,0x24,0x8e,0x4c,0xaf, + 0x10,0x2c,0x2f,0xbf,0xa3,0xc4,0xc2,0xe9,0xb,0xae,0x44,0xb6,0xf,0x2c,0x6f,0x15, + 0x5,0x4d,0xc1,0xa5,0x94,0x6,0x8c,0x1e,0x5c,0x4f,0x7e,0xa5,0xe0,0xca,0x4b,0xa0, + 0x97,0x6c,0x4e,0x90,0xa9,0xd2,0x28,0x33,0xc7,0x85,0xc9,0xe9,0x97,0x44,0x15,0x6d, + 0x31,0x7b,0x5d,0x1c,0x17,0x26,0xa7,0x5f,0x12,0x36,0xd8,0x62,0xc9,0x79,0x54,0x52, + 0x5e,0x95,0x4,0x17,0x0,0x2e,0x8d,0x46,0x71,0xa4,0xa6,0x26,0x6f,0xf9,0x1d,0x8f, + 0xc7,0x3,0x51,0x14,0xad,0x14,0x5b,0x0,0x68,0x5e,0xbe,0x7c,0xf9,0xb9,0xc7,0x8e, + 0x1d,0xeb,0x51,0x6e,0xd4,0x12,0x5c,0xe,0xc0,0x46,0xab,0x27,0xaa,0xa1,0x94,0x22, + 0x3e,0xdd,0x30,0x2e,0x9f,0xec,0x85,0x99,0xc,0x6a,0xcb,0xed,0x2b,0x8,0xd9,0xca, + 0x71,0xe2,0x26,0x2a,0x96,0xc7,0x5,0x37,0x7a,0x39,0x5b,0x98,0xf7,0xea,0x9e,0x3a, + 0x72,0xfc,0x25,0xa1,0x4c,0x3b,0xfd,0x92,0x50,0xdb,0x92,0x4e,0x83,0xda,0x38,0xe8, + 0x41,0xcd,0xa5,0x93,0x93,0x78,0x78,0x61,0x5e,0x6b,0x69,0xd9,0xe5,0x77,0xd4,0x18, + 0xd0,0xc6,0xcb,0x1,0x94,0x16,0xdc,0xae,0xae,0xae,0x75,0xa2,0x28,0x36,0x59,0x7d, + 0xf0,0xc4,0xf4,0x92,0x39,0xca,0xe1,0xbc,0x9b,0xf5,0x7a,0xb7,0x16,0x8c,0x32,0x63, + 0xc2,0x54,0x3d,0x5b,0x98,0x30,0xb9,0xc7,0x16,0xcb,0xcf,0xc3,0xea,0x3a,0x57,0xcd, + 0x87,0x6d,0x37,0xeb,0x62,0x31,0xcc,0x13,0x45,0x4c,0x79,0x4e,0x45,0xbc,0xf2,0x6, + 0xd6,0x52,0x33,0xe8,0x88,0x5e,0xe,0xe0,0x7b,0xca,0x6d,0x5,0x47,0x12,0x45,0xf1, + 0x72,0x3b,0xe,0xae,0x6e,0xbf,0x5,0x74,0xa,0xae,0xc5,0x1e,0x2e,0xfb,0xac,0x76, + 0x8f,0x0,0xb0,0xcf,0x6a,0xf7,0xd4,0x91,0x53,0x9d,0xbe,0x54,0x35,0x45,0xab,0xdd, + 0x78,0x28,0xc5,0xf9,0x93,0x93,0x78,0xb1,0xe9,0x94,0x4f,0xc9,0xf3,0x3c,0x8,0x21, + 0x65,0xf5,0xcc,0xc4,0x57,0xff,0x26,0xf5,0x76,0x2d,0x69,0xd7,0x25,0xb8,0x46,0xf, + 0x1e,0x57,0xc5,0xd9,0x2d,0x17,0x45,0xac,0x52,0xad,0xca,0xab,0x89,0x28,0x96,0xf7, + 0x70,0x9d,0xb8,0x89,0xc,0xda,0xe2,0x88,0x30,0x39,0xfd,0xd0,0x2b,0xd2,0x8e,0xbf, + 0x24,0x94,0x69,0xa7,0x5f,0x12,0x16,0xd9,0x62,0xf9,0x79,0x54,0xdb,0x16,0x49,0xaa, + 0x5a,0x87,0x99,0x92,0x4b,0x26,0x26,0xf2,0x4,0x57,0xee,0x3c,0x2b,0x36,0x31,0x79, + 0x5,0x7d,0x59,0x8b,0x57,0xac,0x58,0xb1,0xa2,0xbf,0xbf,0xbf,0x5f,0xde,0x60,0x58, + 0x70,0xcd,0x1c,0x5c,0x10,0x84,0x82,0x93,0xe9,0xd2,0x39,0x3b,0x10,0x8d,0xc5,0xb2, + 0x95,0x63,0xf5,0xc3,0xe0,0xf4,0x43,0x5f,0xc4,0x16,0xc7,0x85,0xc9,0xe9,0x97,0x84, + 0xd,0xb6,0xcc,0x78,0x61,0x2a,0x95,0x76,0xe2,0x25,0x51,0x81,0x2d,0x79,0x76,0x45, + 0x22,0xb6,0x4c,0xc9,0x58,0x8e,0x4b,0x26,0x26,0x40,0x80,0x5c,0x78,0x18,0x21,0x4, + 0x3e,0x9f,0x4f,0x53,0x70,0x2b,0xed,0xcb,0x12,0x4,0x61,0x13,0x80,0x7e,0xf9,0xef, + 0x3c,0xc1,0xbd,0xfc,0xf2,0xcb,0x17,0xa3,0xc4,0x74,0x8c,0x66,0xf,0xae,0x35,0xf7, + 0xe4,0x25,0x3a,0x86,0xd4,0x1,0xc8,0xbe,0x1,0xed,0x1a,0xda,0x5b,0x49,0x9a,0x9, + 0x93,0xf6,0x79,0xb8,0xc0,0x16,0xd3,0x2,0xe0,0x22,0x5b,0x6c,0xbd,0xa7,0x9c,0xae, + 0x97,0xe9,0x34,0xd,0x85,0xe0,0x4,0xad,0x99,0xc,0x96,0xa5,0x52,0x38,0xe6,0xf7, + 0xe7,0xfa,0x94,0x3c,0x9e,0xc2,0x59,0xc,0xac,0x8,0x1c,0x20,0x84,0x5c,0xe,0xe0, + 0x97,0xf2,0xdf,0xbc,0xfa,0xc7,0x62,0x3b,0x56,0x72,0x70,0x2d,0xc1,0xbd,0xd0,0x88, + 0xe0,0x52,0x6a,0xfe,0x61,0x70,0xc9,0xcd,0x95,0xfd,0xcf,0x3d,0xb6,0x38,0xfe,0x92, + 0xb0,0xc8,0x16,0xcb,0xcf,0xc3,0xe9,0x7a,0x31,0x68,0x8b,0x5b,0xbd,0xd7,0xb2,0xcf, + 0x42,0x26,0x3,0xaa,0x31,0xcc,0xbf,0x5a,0xac,0x9f,0x9a,0xc2,0xf1,0xe9,0x78,0x5c, + 0xa0,0xb0,0x1d,0xd7,0xc2,0x28,0xad,0xbc,0x16,0x83,0x3c,0xc1,0x95,0x24,0xe9,0x2, + 0x65,0x14,0x81,0xce,0x2,0xcb,0xe6,0x55,0xb,0xee,0x72,0x51,0x44,0x9b,0xde,0x4f, + 0x89,0x74,0x1a,0x34,0x99,0xcc,0x1f,0x0,0x91,0x3d,0x90,0x7d,0xe9,0x6a,0x79,0x1a, + 0x55,0xb4,0xc5,0x92,0xf3,0x70,0x81,0x2d,0x66,0xaf,0xb,0xf3,0x5e,0xdd,0x53,0x47, + 0x94,0x52,0xd0,0x70,0x18,0x4e,0xb2,0x3e,0x16,0xc3,0x93,0x6d,0x6d,0x79,0xdb,0x6c, + 0x5a,0xd1,0x77,0xed,0xe2,0xc5,0x8b,0xeb,0x4e,0x9e,0x3c,0x19,0x7,0xa,0x3d,0xdc, + 0x73,0xc,0x16,0x56,0xf6,0xe0,0x94,0x52,0xa4,0x54,0xe3,0xa4,0x2f,0x30,0x10,0xf3, + 0x6,0x0,0x74,0x62,0x2,0xa4,0xa5,0x45,0x59,0x68,0x61,0xda,0xe9,0x9b,0xb,0x4c, + 0x98,0x98,0x30,0x59,0x2f,0x4c,0x6e,0xb1,0xc5,0xd2,0xba,0x70,0x81,0xe0,0xae,0xd3, + 0xf0,0xae,0x8d,0x8,0xae,0x1,0x6d,0xf4,0x70,0x1c,0x77,0x36,0x80,0x9d,0x40,0x61, + 0xa7,0xd9,0x6,0x13,0x5,0x96,0xcc,0x9f,0x4c,0x26,0x73,0xbf,0xc9,0xde,0xf3,0xf9, + 0x3a,0x9b,0x13,0x72,0x65,0x8f,0x8e,0x82,0x34,0x37,0xbb,0xea,0xe6,0x62,0x9f,0xd5, + 0xee,0x11,0x80,0x99,0xfa,0x59,0xad,0x4e,0xcf,0x95,0x4e,0x5f,0x1a,0x89,0x64,0xd7, + 0x30,0x73,0x90,0x25,0xa9,0x14,0x9a,0x5,0x1,0x61,0x45,0xc,0xae,0x7a,0x98,0x6f, + 0x31,0x8c,0x6a,0x23,0x80,0xf5,0x50,0xb,0x6e,0x20,0x10,0x68,0xcb,0x64,0x32,0x8b, + 0x8d,0x16,0x58,0x2e,0xaf,0xdc,0x9c,0xa0,0x6c,0xaa,0xb8,0xc0,0xa8,0xe0,0xe,0xf, + 0x3,0x67,0x9c,0x21,0x1f,0x50,0x79,0xf0,0xaa,0xa5,0x99,0xf7,0xea,0x1e,0x1,0x60, + 0xde,0xab,0x7b,0xea,0xc8,0xd4,0xdc,0x9,0xe,0x7b,0xb7,0x0,0x40,0x0,0xac,0x9d, + 0x9a,0xc2,0x2b,0x6,0xe3,0x71,0x4d,0x6a,0xe3,0xfa,0xdc,0x31,0xe4,0x44,0x26,0x93, + 0x59,0x5f,0x41,0x81,0x45,0x49,0x26,0x93,0x79,0x62,0x3b,0x5f,0x92,0x70,0xba,0xc1, + 0x26,0x5,0x69,0x74,0x14,0x1e,0x4a,0x99,0x30,0x31,0x61,0x72,0xd4,0x96,0x6a,0xb, + 0x93,0x5d,0xb6,0x98,0x4d,0x5b,0x52,0x17,0xb1,0x58,0x55,0xa6,0x62,0xd4,0xc3,0xfa, + 0x58,0x2c,0x4f,0x70,0xe5,0x79,0x15,0x8a,0xd,0xf3,0xad,0x40,0x1b,0x73,0x2d,0x7, + 0x39,0xc1,0x25,0x84,0x6c,0xb0,0x61,0x7d,0x9f,0x82,0x36,0x91,0x75,0x82,0x80,0xc2, + 0x6e,0xb9,0x32,0xc7,0x1a,0x19,0xd1,0xc,0xd,0xb3,0xf5,0x61,0x70,0xd1,0x8d,0xee, + 0xf8,0x4b,0xc2,0xa0,0x2d,0x55,0x13,0x26,0xa7,0xeb,0xa5,0x88,0x2d,0x8e,0x47,0xa3, + 0x38,0xfd,0x92,0x28,0x66,0x8b,0x24,0x41,0x1a,0x1b,0x83,0x5b,0x58,0x33,0x3d,0xfa, + 0x55,0xe9,0x10,0x6a,0xad,0xe6,0xb,0x54,0x24,0xb6,0x80,0x96,0x87,0x2b,0x8a,0xe2, + 0x7a,0xad,0x8,0x5,0x9d,0x5,0x6a,0x22,0x8a,0x62,0x81,0xf1,0x67,0x19,0xf4,0x6e, + 0x1,0x80,0x46,0xa3,0xa0,0xc9,0x24,0x88,0xcf,0xa7,0x34,0x22,0xff,0x7f,0x9d,0x69, + 0xe6,0xbd,0xba,0x47,0x0,0x98,0xf7,0xea,0x9e,0x3a,0xaa,0x46,0x5d,0xd0,0xc9,0x49, + 0xc7,0xdb,0x6e,0x95,0x9c,0x96,0x48,0x80,0x23,0x24,0x6f,0x7e,0x5c,0xf5,0xbc,0xa, + 0x16,0xf5,0x65,0xb5,0x2d,0x5b,0xb6,0x6c,0xf1,0xf1,0xe3,0xc7,0x4f,0x2a,0x3d,0xdc, + 0xf5,0x5a,0x39,0x2b,0x39,0xb8,0x56,0x8f,0xdf,0x6a,0x13,0x82,0xb,0x0,0x74,0x70, + 0x10,0x64,0xe5,0x4a,0x26,0x4c,0x4c,0x98,0x1c,0x4d,0x3b,0xee,0xbd,0x2a,0xd3,0x4e, + 0xd4,0x85,0x59,0x5b,0xa8,0x3b,0xda,0x6e,0x95,0xd4,0x8b,0x22,0xda,0xd3,0x69,0x8c, + 0x2a,0x1c,0x39,0xe5,0x0,0x8,0x8b,0x9b,0x57,0xd7,0x3,0xc8,0x9,0x2e,0x1,0xb0, + 0xb6,0xc2,0x2,0xb,0xf2,0x6a,0x9,0xee,0x99,0x26,0x5,0x57,0x3a,0x7a,0x14,0x5c, + 0x67,0xa7,0x7c,0x0,0xe5,0xc1,0xb4,0x6d,0x74,0xe9,0x8d,0x6e,0xf9,0xc3,0xe0,0xf4, + 0x43,0x5f,0xc4,0x16,0xc7,0x85,0xc9,0xe9,0x97,0x84,0xd,0xb6,0x58,0x72,0x1e,0x4e, + 0x1d,0x3f,0x1c,0xce,0x4e,0x44,0xe5,0x32,0x56,0x25,0x12,0x79,0x82,0x2b,0x7b,0xb8, + 0x56,0xf7,0x65,0x1,0x58,0x7,0xe0,0x19,0x1e,0x0,0x2e,0xbf,0xfc,0xf2,0x45,0x94, + 0xd2,0x79,0x15,0x16,0x58,0x90,0x57,0x2d,0xb8,0x5e,0x0,0xa7,0xeb,0x99,0xb0,0x46, + 0x3,0x69,0x60,0x20,0x5b,0x81,0x46,0x1e,0x6,0x17,0xdc,0xe8,0xe5,0x6c,0x61,0xde, + 0xab,0x7b,0xea,0xc8,0xf1,0x97,0x84,0x32,0xed,0xf4,0x4b,0xc2,0x22,0x5b,0x40,0x69, + 0x76,0x54,0x59,0x95,0x96,0xd1,0x31,0xca,0xca,0x44,0x2,0x3b,0xe6,0xcf,0xcf,0xfd, + 0xcd,0x71,0x9c,0xa1,0xfd,0xd,0x68,0xe3,0x19,0xc0,0x74,0x1b,0xae,0x28,0x8a,0x2b, + 0x8b,0x1d,0xa8,0x12,0xa5,0x57,0xb,0xee,0xa,0x51,0x84,0xcf,0x40,0x79,0x79,0x65, + 0x87,0x42,0xd9,0xb9,0x33,0x1b,0x1a,0x5c,0x7b,0xa3,0x33,0x61,0x62,0xc2,0x64,0x69, + 0x79,0x3a,0xd3,0x6e,0xef,0xf4,0xa5,0xa1,0x50,0xfe,0x76,0x17,0xb1,0x72,0x7a,0x9e, + 0x6e,0x25,0xa5,0x66,0xe,0x53,0x62,0x44,0x1b,0x45,0x51,0x5c,0x1,0x4c,0xb,0xae, + 0xc7,0xe3,0x59,0x51,0x6c,0x94,0x98,0x5e,0xb4,0xf2,0x2a,0x8d,0x26,0x84,0x98,0x6e, + 0xbf,0x95,0x91,0x8e,0x1f,0x7,0xb7,0x66,0x8d,0xf2,0xa0,0xf9,0xff,0xbb,0x21,0x6d, + 0xe7,0x3,0x5d,0x81,0x2d,0x8e,0xb,0x93,0xd3,0xd7,0x2,0x8a,0xf3,0x70,0x81,0x2d, + 0x66,0xaf,0xcb,0x4c,0xeb,0xf4,0xa5,0x2e,0xa,0x3,0xd3,0xe2,0x34,0x95,0xe0,0x12, + 0x42,0xca,0x8e,0x38,0x33,0xd3,0x91,0x46,0x8,0x59,0x9,0x4c,0xb,0x2e,0xa5,0x74, + 0xa5,0x3a,0x83,0xd1,0x2,0xd5,0x8,0x82,0x0,0x39,0xcc,0x4c,0x8e,0x7e,0x30,0x1a, + 0x7f,0xab,0x46,0x7a,0xeb,0x2d,0x70,0xab,0x57,0xbb,0xf7,0xe6,0x72,0x91,0x2d,0xa6, + 0xbd,0x11,0x17,0xd9,0xe2,0xf8,0x4b,0xc2,0x22,0x5b,0x2c,0x3f,0xf,0xa7,0xeb,0x45, + 0xa7,0x2d,0x34,0x93,0xa9,0xfa,0x4,0xe3,0x46,0x59,0x92,0x4c,0x82,0xa7,0x14,0x2, + 0x21,0x39,0x9d,0x2a,0xb5,0x2,0x44,0x5,0xda,0xd8,0x9,0x80,0xf0,0x8a,0x3f,0xc, + 0x17,0x58,0x2a,0xaf,0x1c,0xe,0xa6,0xc,0x35,0xeb,0x34,0xd9,0x7e,0x2b,0x23,0x1d, + 0x3f,0x9e,0xd,0x9c,0xae,0xad,0x75,0xfc,0x46,0x63,0xc2,0x64,0xbd,0x2d,0x73,0x55, + 0x98,0x4a,0x9e,0x83,0x43,0xb6,0x54,0x5c,0x17,0x74,0x3a,0x2a,0xc1,0xa0,0x40,0x55, + 0x1b,0x2f,0xa5,0x58,0x90,0x4e,0x63,0x48,0x31,0x73,0x98,0x1d,0xcd,0xab,0x0,0x6a, + 0x3a,0x3b,0x3b,0x17,0xca,0x82,0xbb,0xd2,0x82,0x2,0xf3,0x10,0x4,0x1,0xea,0xb8, + 0xde,0xa5,0x15,0xa,0x2e,0x24,0x9,0xd2,0xd1,0xa3,0xda,0xcd,0xa,0xc5,0xd2,0x76, + 0x3e,0xd0,0x46,0xd3,0x4e,0x3f,0xf4,0x50,0x9c,0x87,0xb,0x6c,0x31,0x7b,0x5d,0x66, + 0xda,0x67,0xb5,0xe9,0xf3,0x70,0xba,0x5e,0x74,0xd8,0x52,0xf4,0x1c,0x26,0x26,0x5c, + 0x19,0x95,0xa0,0xc5,0x42,0x95,0xe0,0xda,0x35,0x37,0x6e,0x26,0x93,0x59,0x29,0xb, + 0xee,0xa,0xab,0xc3,0x20,0xb4,0x46,0x6b,0x2c,0xa9,0x54,0x70,0x1,0x88,0x87,0xe, + 0x59,0xd7,0xac,0x50,0x24,0xcd,0xbc,0x57,0xeb,0x6d,0xb1,0xfc,0x3c,0x9c,0xae,0x17, + 0x83,0xb6,0xcc,0x2a,0xef,0xb5,0x5c,0xfe,0x78,0x1c,0x54,0xb5,0xa4,0x96,0x9b,0x59, + 0x94,0x4e,0x63,0xb7,0xe2,0x6f,0xb5,0xe0,0x5a,0xa5,0x8d,0x1c,0xc7,0xad,0xe0,0x6f, + 0xbe,0xf9,0x66,0xcf,0xe0,0xe0,0xe0,0x72,0x2b,0xa,0x54,0xa2,0x16,0xdc,0x1a,0x4a, + 0xd1,0x6a,0xc1,0x72,0x1a,0x74,0x78,0x38,0x3b,0x5d,0xe3,0xbc,0x79,0xd5,0xbd,0x89, + 0x5c,0x2a,0x46,0x9a,0xe7,0xe1,0x2,0x5b,0xcc,0x5e,0x17,0xe6,0xbd,0xba,0xa7,0x8e, + 0x4c,0xd5,0x85,0xc3,0x13,0x8b,0x9b,0x61,0xa1,0xaa,0x53,0x8f,0x10,0x2,0x8e,0xe3, + 0x20,0x1a,0x74,0x10,0xcb,0x69,0x23,0xa5,0x74,0x25,0x7f,0xf2,0xe4,0xc9,0xe,0x64, + 0x43,0x64,0x2b,0x2a,0x4c,0x4d,0x46,0x35,0x84,0x6f,0xa9,0x28,0x1a,0x9e,0x43,0xa1, + 0x88,0x21,0x90,0xde,0x78,0x3,0x9e,0xb,0x2f,0xcc,0xdb,0x66,0x24,0xcd,0x84,0xc9, + 0x3d,0x62,0x30,0x67,0x85,0xc9,0x26,0x5b,0x6c,0xad,0x8b,0x72,0xb6,0x48,0x52,0x36, + 0xde,0xd6,0xa0,0x56,0x38,0x8d,0x5a,0x70,0x81,0xac,0x97,0xab,0x57,0x70,0xd,0x68, + 0xe3,0x32,0x9e,0x52,0xba,0xc0,0xc2,0x2,0x73,0xf9,0xd5,0x1e,0xae,0x15,0xcd,0x9, + 0x32,0xe2,0x9b,0x6f,0x82,0xdb,0xb0,0x1,0x44,0xd9,0x9b,0x58,0xad,0x87,0xc1,0xa1, + 0x87,0x9e,0x7d,0x56,0xbb,0xa7,0x8e,0xd8,0x48,0x40,0x8d,0xb4,0x24,0x65,0xe3,0xe4, + 0x1d,0x58,0x14,0xb2,0x52,0xb4,0x3c,0x5c,0xad,0x76,0x5c,0x2d,0xc,0x6a,0x63,0x3b, + 0x4f,0x29,0x6d,0xb5,0xaa,0x40,0x65,0x5e,0xf5,0xdb,0x61,0x99,0x95,0x15,0x91,0x4e, + 0x43,0x3a,0x7c,0x18,0x9e,0xd5,0xab,0xe5,0x3,0x17,0xda,0xe0,0xf4,0xcd,0xad,0x4c, + 0x57,0xcb,0xd3,0xb0,0xc1,0x16,0x5b,0x85,0xc9,0xe9,0x7a,0xd1,0x61,0xb,0xf3,0x5e, + 0x75,0xe4,0x95,0x97,0x3b,0x9f,0x81,0x62,0xb,0x64,0xdb,0x70,0x65,0x4a,0x2d,0x2a, + 0xa9,0xc6,0x84,0x36,0xb6,0xf1,0x94,0xd2,0xb6,0x62,0xb3,0x84,0x99,0x15,0x5b,0x49, + 0x92,0xf2,0xfe,0x26,0x84,0xa0,0xdd,0xe2,0xca,0x90,0xde,0x7c,0x13,0x9c,0x3c,0x29, + 0x79,0xd6,0x0,0x6b,0xd3,0x4c,0x98,0x98,0x30,0xb9,0xf4,0x7e,0x29,0x97,0xae,0x6a, + 0x5d,0x48,0x52,0x76,0x70,0x83,0x85,0x5f,0xb0,0xd5,0x66,0x7e,0x26,0x3,0x8e,0x52, + 0x50,0x45,0x38,0x58,0xb9,0x21,0xbe,0x26,0xb5,0xb1,0x95,0xe7,0x38,0xae,0xd5,0xea, + 0x51,0x66,0x4a,0xef,0x56,0x16,0xf3,0x66,0x8b,0x5,0x97,0x46,0x22,0x90,0x8e,0x1c, + 0x1,0xb7,0x62,0x85,0xd2,0x10,0x67,0xd3,0x76,0x3e,0xd0,0x36,0xd8,0x52,0x35,0x61, + 0x72,0xba,0x5e,0x8a,0xd8,0xe2,0x78,0x34,0x8a,0xd3,0x2f,0x89,0x4a,0x6d,0xa1,0x74, + 0xc6,0x8b,0x2d,0x0,0x70,0xc8,0x2e,0x8c,0x10,0xd1,0x29,0xb8,0x15,0x68,0x63,0x5b, + 0x41,0x93,0x82,0x15,0xa3,0xcc,0x44,0x51,0x2c,0x88,0xc1,0x6d,0xb2,0xe1,0x73,0x43, + 0xda,0xb3,0x7,0xdc,0xb2,0x65,0x0,0xc7,0xb9,0x4a,0x8c,0xc,0x3d,0xc,0x4e,0x3f, + 0xf4,0x3a,0x6c,0x61,0xde,0xab,0x7b,0xea,0xc8,0xf1,0x97,0x84,0x9c,0xa6,0x34,0x1b, + 0xfa,0x35,0xc3,0xc5,0x56,0xa6,0x31,0x93,0x41,0x44,0xd1,0x27,0xa4,0x25,0xb8,0x16, + 0x68,0x63,0x4b,0x5e,0x93,0x82,0x55,0xf1,0x66,0x5a,0x2b,0x47,0x58,0xed,0xe1,0x2, + 0x0,0x8d,0xc5,0x20,0xbd,0xfd,0x36,0xb8,0xd3,0x4e,0x93,0x8d,0x52,0xfc,0xc8,0x84, + 0xc9,0x6c,0x9a,0x9,0x93,0x7b,0xea,0xc8,0x95,0x9d,0xbe,0xb2,0xd8,0xce,0xd0,0x36, + 0x5b,0x2d,0x1a,0x55,0x2f,0xe,0xb5,0xe0,0x5a,0xa4,0x8d,0xde,0x5c,0x93,0x82,0x95, + 0x3,0x1f,0xb4,0x4,0xd7,0xe,0xf,0x17,0x0,0xa4,0xbe,0xbe,0xec,0x3c,0xb9,0xca, + 0xb,0x54,0x25,0x1,0x60,0x9f,0xd5,0x2e,0x11,0x0,0x58,0x74,0x1e,0x4e,0x5f,0xb, + 0x28,0xce,0xc3,0x5,0xb6,0x68,0x5e,0x17,0x51,0x4,0x4d,0xa5,0x66,0x95,0xd8,0x2, + 0x40,0xa3,0x2a,0xaa,0x4a,0x29,0xb8,0x56,0x6a,0x23,0x4f,0x29,0x6d,0xb3,0x7a,0x94, + 0x59,0x35,0x5,0x97,0xc6,0xe3,0x10,0x7b,0x7b,0xe1,0x39,0xe7,0x1c,0x5b,0x5,0x80, + 0x79,0xaf,0xee,0x11,0x0,0xc7,0x5f,0x12,0xca,0xb4,0xd3,0x2f,0x9,0x8b,0x6c,0xd1, + 0x65,0xaf,0x20,0x0,0xe9,0x74,0xfe,0xef,0xb3,0x84,0x46,0xd5,0xb8,0x1,0x59,0x70, + 0xad,0xd6,0x46,0x9e,0x52,0x3a,0xbf,0x6c,0x2e,0x3,0x5,0x2,0x45,0x9a,0x14,0x6c, + 0xac,0x24,0xe9,0xf0,0x61,0x70,0xcb,0x97,0x83,0xcc,0x9f,0xcf,0x84,0x49,0x91,0x66, + 0xc2,0x64,0xbd,0x2d,0x96,0x9f,0x87,0xd3,0xf5,0xa2,0xd3,0x16,0x2a,0x8a,0x59,0xb1, + 0x9d,0xa5,0x28,0x3d,0x5c,0x32,0x3d,0x73,0x98,0xd5,0x62,0xb,0x64,0x5,0xb7,0xa6, + 0xdc,0xe2,0x91,0x46,0x1b,0x8b,0xd5,0x31,0xb8,0xb5,0x94,0xc2,0x6b,0xe7,0x5b,0x51, + 0x92,0x20,0xf6,0xf4,0x80,0xdf,0xbc,0x19,0x90,0xcf,0xc5,0xc0,0xcd,0xe5,0xb8,0x30, + 0x39,0xfd,0x92,0xb0,0xc1,0x16,0x4b,0xce,0xc3,0x5,0xb6,0x98,0xbd,0x2e,0xb3,0x2a, + 0x96,0x3a,0x93,0x99,0x35,0x9d,0x63,0xc5,0x90,0xdb,0x70,0x95,0x5a,0xc8,0x71,0x9c, + 0xa6,0xf3,0xa8,0xc4,0xa8,0x36,0xf2,0x84,0x10,0x5f,0xa9,0xc,0x56,0x44,0x2d,0xd4, + 0x1a,0x2a,0xc1,0x1c,0x34,0x1c,0xce,0x76,0xa0,0xad,0x5a,0xa5,0x34,0x46,0x33,0xcd, + 0xbc,0x57,0xf7,0x8,0x0,0xf3,0x5e,0xdd,0x53,0x47,0x5,0xe7,0x20,0x8b,0xad,0x41, + 0xd,0x98,0x89,0xf8,0x24,0xa9,0x20,0xb2,0xca,0x6a,0x47,0x94,0x52,0xa,0x1e,0x40, + 0x51,0xc1,0xad,0x64,0xe0,0x83,0xc,0x21,0x4,0x7c,0x95,0x1a,0xd8,0xc5,0xbe,0x3e, + 0x90,0xa6,0x26,0x90,0xa6,0x26,0x4d,0xbb,0xdc,0x7a,0xa3,0x57,0x4d,0x98,0x9c,0xbe, + 0x16,0x50,0x9c,0x87,0xb,0x6c,0xb1,0x4c,0x98,0x1c,0xb4,0xc5,0xb6,0x7b,0x4a,0x92, + 0x66,0xcc,0xf4,0x8a,0x56,0xa0,0xf5,0x5,0x5e,0x4a,0x70,0xcd,0x6a,0x23,0xf,0xc0, + 0x6f,0x65,0x81,0x32,0x4a,0x63,0x35,0xf,0x60,0x7,0x92,0x4,0x71,0xd7,0x2e,0x78, + 0xba,0xba,0x0,0xaf,0xd7,0xb5,0x37,0xfa,0x8c,0x15,0x26,0x27,0x5e,0x12,0x16,0xd9, + 0x62,0xeb,0xcb,0xce,0xe9,0x7a,0xd1,0x61,0x8b,0xa1,0xba,0x10,0xc5,0x59,0x17,0x85, + 0x50,0xe,0xad,0xb5,0x16,0xad,0x1e,0x81,0xb,0x40,0xdb,0xc3,0xb5,0xba,0xb1,0xd8, + 0xd6,0xf6,0x5b,0x15,0x34,0x91,0xc8,0x46,0x2d,0x9c,0x77,0xde,0xf4,0x6,0x77,0x8a, + 0x91,0xad,0xc2,0xe4,0xf4,0x4b,0xc2,0x5,0xb6,0x98,0xbd,0x2e,0x73,0xc2,0x7b,0x2d, + 0x66,0xb,0xa5,0xb3,0xbe,0xad,0xb6,0x18,0x1e,0x9d,0x2f,0x98,0x4a,0xb5,0x31,0x4f, + 0x70,0xad,0x68,0xaf,0xd5,0xda,0x5e,0x76,0xee,0x47,0x8b,0xa1,0x43,0x43,0x90,0xe6, + 0xcf,0xd7,0x1e,0xf6,0xeb,0xf4,0x43,0xf,0xc5,0xf5,0x71,0x81,0x2d,0x4c,0x98,0xdc, + 0x63,0x8b,0xd9,0xeb,0x62,0x49,0x5d,0x48,0x52,0xfe,0xf6,0x39,0x46,0x39,0xf,0xd7, + 0x2a,0x6d,0xcc,0x35,0x29,0xd8,0x11,0x2,0x21,0x63,0x76,0x69,0xf4,0x4a,0x90,0xe, + 0x1e,0x4,0xa9,0xa9,0x1,0x59,0xa0,0x98,0x7d,0xd2,0x1,0x1,0x60,0x9f,0xd5,0xee, + 0x79,0x61,0xb0,0x58,0xea,0x22,0xdb,0xe6,0xb0,0xd0,0xca,0x78,0x4b,0x78,0xb8,0x96, + 0xe,0x7c,0x0,0xe0,0xb3,0x7b,0xe0,0x43,0x35,0x9b,0x14,0x72,0x50,0x9a,0x6b,0x5a, + 0x20,0xcd,0xcd,0x79,0xdb,0xed,0x4c,0xb3,0xcf,0x6a,0xf7,0xbc,0x30,0x98,0xf7,0x6a, + 0xe0,0x9c,0xe7,0x38,0xbc,0xea,0x5a,0xc8,0xab,0x3e,0xd8,0x31,0xf0,0xa1,0xf4,0x3c, + 0x64,0x6,0xb,0x4,0xa,0x1b,0x9b,0x2d,0x59,0xe9,0xc1,0xc,0x92,0x4,0x71,0xdf, + 0x3e,0x78,0xce,0x3f,0x1f,0xa4,0xbe,0xde,0xf2,0x87,0x8e,0x79,0xaf,0xee,0x79,0x61, + 0x30,0xef,0xd5,0xe0,0x7e,0x8c,0x3c,0xb8,0xe9,0x6b,0x63,0xb6,0x19,0x41,0xf7,0xc0, + 0x7,0x0,0x69,0x0,0x35,0xe5,0x32,0x1a,0x6d,0x46,0x50,0x22,0x94,0x89,0x67,0xb3, + 0x95,0x74,0x1a,0x62,0x4f,0x4f,0xd6,0xd3,0xd5,0x23,0xba,0x25,0xd2,0x4c,0x98,0xe6, + 0xa0,0x30,0xd9,0x98,0xae,0x6a,0x5d,0x30,0x4a,0x92,0xe1,0xb8,0x2,0x47,0x51,0xaf, + 0xe6,0x19,0xd1,0x46,0x5d,0x82,0x5b,0x89,0xd2,0x13,0x42,0x90,0x71,0x52,0x70,0x1, + 0x20,0x93,0x81,0xb8,0x67,0xf,0x3c,0x1b,0x36,0xe8,0x16,0x5d,0xf6,0x59,0xed,0x9e, + 0x17,0x6,0x8b,0xa5,0x36,0x68,0xb,0xc3,0x30,0x66,0x9c,0x42,0xb3,0x3,0x1f,0x8a, + 0xe,0x90,0x36,0xdb,0x33,0xc7,0xa9,0xde,0x16,0x8e,0x7a,0xb8,0x32,0xe9,0x74,0xb6, + 0x79,0xe1,0xec,0xb3,0x41,0xea,0xea,0xb2,0xdb,0x8c,0x3c,0xc,0x4e,0x3f,0xf4,0x3a, + 0x6c,0x61,0xde,0xab,0x7b,0xea,0x88,0x79,0xaf,0x33,0x8b,0x8c,0xc1,0xf9,0x6f,0xcd, + 0x6a,0x23,0xf,0xa0,0x70,0xc9,0x4a,0x83,0x5,0x6a,0x79,0xb5,0x4a,0x34,0xf,0xe0, + 0x4,0xa9,0x14,0xc4,0xbd,0x7b,0xb3,0x6b,0xa1,0xc9,0xa3,0xd1,0x98,0x30,0x39,0x9a, + 0x76,0xdc,0x7b,0x55,0xa6,0x9d,0xa8,0xb,0xa3,0xb6,0x30,0x6c,0x41,0xcb,0x29,0xd4, + 0x1b,0xf6,0x5a,0xa,0xad,0x81,0xf,0x5,0x1e,0xae,0xd5,0x8d,0xc5,0x8e,0x37,0x29, + 0x28,0x11,0x4,0x88,0x6f,0xbc,0x91,0x9d,0x5d,0x6c,0xf1,0xe2,0x53,0xdb,0x5d,0x28, + 0x46,0x8e,0x7b,0xaf,0x45,0x6c,0x71,0x5c,0x98,0x9c,0xbe,0x16,0x50,0x9c,0x7,0xf3, + 0x5e,0x67,0x5,0x7a,0x3d,0x5c,0x2b,0x6,0x3e,0xa4,0xcb,0x65,0x32,0x52,0x20,0x50, + 0xe8,0xe1,0xba,0xa2,0x49,0x41,0x9,0xa5,0x90,0x6,0x6,0x40,0x52,0x29,0x70,0xcb, + 0x97,0xeb,0x9f,0x61,0xac,0x58,0x9a,0x79,0xaf,0xcc,0x7b,0x65,0xde,0xeb,0x8c,0x46, + 0x8f,0x53,0x68,0x85,0x36,0xe6,0x9a,0x14,0xac,0x1a,0x49,0x1,0x14,0xa,0xae,0x5b, + 0x67,0xd1,0xa4,0xc3,0xc3,0x90,0x26,0x26,0xc0,0x9d,0x7e,0x3a,0xe0,0x9f,0x9e,0xf1, + 0x81,0x9,0x93,0xe9,0x32,0xd8,0x10,0x65,0xe6,0xbd,0xce,0x54,0xd4,0x4e,0x21,0x21, + 0x24,0x37,0x9e,0xc0,0x4a,0x6d,0xe4,0x1,0xa4,0xad,0x6e,0x42,0x50,0xb,0x6e,0x9c, + 0xe3,0x20,0x21,0xbb,0x3a,0xa6,0xdb,0xa0,0xf1,0x78,0xb6,0x89,0x61,0xe5,0x4a,0x90, + 0xc6,0x46,0xc5,0xf,0xf6,0x3d,0x74,0xec,0xb3,0xda,0x3d,0x2f,0xc,0x36,0xb0,0x80, + 0x1,0x0,0xf1,0xe9,0x5,0x24,0xcd,0x86,0x86,0xe9,0xcd,0xcb,0x53,0x4a,0xe3,0x56, + 0x16,0x8,0x14,0x2e,0xc0,0x26,0x12,0x82,0x29,0x8e,0x43,0xa3,0x5b,0x67,0x20,0x12, + 0x4,0x48,0x6f,0xbd,0x5,0xd2,0xdc,0xc,0x6e,0xe9,0x52,0x40,0x5e,0xbd,0x93,0x79, + 0xaf,0x8a,0xa4,0x7b,0x6c,0x61,0xde,0x2b,0xc3,0x6a,0xa2,0x3c,0x5f,0x30,0xe8,0x41, + 0xbd,0x90,0x42,0x29,0x74,0xf,0x7c,0x20,0x84,0x8c,0xeb,0xc9,0x6c,0x44,0xe9,0x95, + 0x82,0x2b,0x9f,0x44,0xd8,0xcd,0x82,0x3b,0xd,0xd,0x87,0x21,0xc6,0x62,0xe0,0x96, + 0x2d,0x3,0x99,0x37,0x6f,0x7a,0x23,0x13,0x26,0xa7,0x6d,0x31,0x7b,0x5d,0x58,0x68, + 0x16,0x43,0x2f,0x93,0xde,0xfc,0x29,0xb6,0xca,0xad,0xf4,0xa0,0xc4,0xd0,0xc0,0x7, + 0x49,0x92,0xc6,0xad,0x9c,0xd9,0x9c,0x52,0x5a,0x10,0x87,0xb,0x0,0x11,0x8e,0x43, + 0xa7,0xee,0x52,0x1c,0x24,0x9d,0x86,0xf4,0xf6,0xdb,0x20,0x2d,0x2d,0x20,0x1d,0x1d, + 0x20,0x65,0xbc,0x5d,0xf6,0x59,0xed,0x9e,0x17,0x46,0xd5,0x62,0xa9,0x19,0xb3,0x8e, + 0xa8,0xfc,0x9c,0x4f,0xa3,0xd7,0xbb,0x35,0xaa,0x8d,0x3c,0xc7,0x71,0x21,0xab,0x2, + 0x7c,0x95,0x3,0x1f,0xd4,0x84,0x35,0xb6,0xb9,0x19,0x1a,0xa,0x81,0x46,0x22,0x59, + 0xe1,0x6d,0x6f,0x7,0x51,0x4f,0x64,0x31,0xc3,0xc4,0x88,0x79,0xaf,0x4c,0x60,0x19, + 0xc5,0x99,0x50,0x9,0xae,0x1e,0xf,0xd7,0x84,0x36,0xd2,0xa2,0x1e,0x6e,0x25,0x3d, + 0x73,0x5a,0x82,0x1b,0x9d,0x61,0x82,0xb,0x0,0x90,0x24,0xd0,0xf1,0x71,0xd0,0x89, + 0x9,0x70,0xed,0xed,0x40,0x63,0xe3,0x8c,0x10,0x23,0xe6,0xbd,0x32,0x71,0x65,0x18, + 0x63,0xc2,0x40,0x93,0x42,0x5,0xda,0x38,0xc1,0x13,0x42,0xc6,0x2b,0x29,0x50,0x2b, + 0xaf,0x96,0x80,0xcf,0x34,0xf,0x37,0x8f,0x74,0x1a,0xd2,0x89,0x13,0xc0,0xe8,0x68, + 0xd6,0xe3,0x9d,0xaf,0x5a,0x59,0x7e,0x2e,0xa,0x93,0x8d,0x82,0xcd,0xbc,0x57,0x46, + 0xb5,0x51,0x7b,0xb8,0xc5,0x9a,0x14,0x2a,0xd4,0xc6,0x71,0x1e,0xc0,0x78,0x99,0x4c, + 0x46,0xa,0x4,0x30,0x3b,0x9a,0x14,0x34,0xc9,0x64,0x40,0x47,0x46,0x40,0xc3,0xe1, + 0xac,0xf0,0xd6,0xd7,0x57,0x3e,0x68,0xa2,0x58,0xda,0x69,0xef,0xd5,0xa0,0x2d,0xb6, + 0xbe,0x24,0xac,0xb2,0x85,0xc1,0xd0,0x20,0xc9,0x71,0x48,0xa9,0xf4,0xc9,0x8e,0x51, + 0x66,0x0,0x82,0x3c,0x21,0x24,0x28,0xff,0x68,0x55,0xcc,0x99,0x3c,0x79,0xaf,0xd2, + 0x2d,0x3f,0xa1,0x7a,0x83,0xcc,0x68,0xd2,0x69,0xd0,0xe1,0x61,0x50,0x9e,0x7,0x69, + 0x6c,0xcc,0xc6,0xef,0x72,0x9c,0xf3,0xc2,0xe4,0xb4,0xc7,0xaa,0xc3,0x16,0xe6,0xbd, + 0x32,0xdc,0xc6,0x88,0xff,0xd4,0x32,0xb7,0xf2,0xd7,0xb9,0xda,0xc3,0xb5,0x48,0x1b, + 0xc7,0x79,0x8e,0xe3,0xc6,0x5,0x83,0xcb,0x21,0xeb,0x39,0xb8,0xc7,0xe3,0xc9,0x9, + 0x2e,0x21,0x4,0x27,0x67,0x93,0xe0,0xca,0x8,0xc2,0xa9,0xce,0xb5,0xfa,0x7a,0x90, + 0x86,0x6,0xc0,0xe7,0x9b,0x79,0xc2,0x64,0xa3,0x60,0xb3,0x9,0xb5,0x19,0x6e,0x67, + 0xb8,0x26,0x3b,0x3b,0xad,0xb2,0x29,0x34,0x93,0xc9,0x0,0x30,0x26,0xb4,0xe5,0xf2, + 0x13,0x42,0x82,0xfc,0xc4,0xc4,0xc4,0x70,0x9d,0x3c,0x5d,0x61,0x5,0x85,0xa9,0xf1, + 0x78,0x3c,0xc8,0x64,0x32,0xb9,0x93,0x98,0x55,0x1e,0xae,0x1a,0x49,0x2,0x9d,0x9c, + 0x4,0x9d,0x9c,0x4,0xbc,0xde,0xac,0xf8,0xd6,0xd5,0x1,0x1e,0x4f,0xf6,0x77,0x37, + 0x7d,0x56,0xdb,0x28,0xd2,0xcc,0x7b,0x65,0xcc,0x44,0x86,0xfd,0xfe,0xc2,0xf9,0x5f, + 0x4,0xc1,0xb2,0x2f,0x7e,0x19,0x49,0x92,0x86,0xf8,0xbe,0xbe,0xbe,0xa9,0x8b,0x2e, + 0xba,0x68,0x14,0xc0,0x82,0x52,0x99,0x8d,0x2a,0xbd,0xc7,0xe3,0xc9,0x3b,0x89,0x20, + 0xc7,0x21,0x41,0x8,0x6a,0x67,0xfb,0x43,0x93,0xc9,0x80,0x46,0x22,0xa0,0x91,0x8, + 0xe0,0xf7,0x83,0xd4,0xd6,0x2,0x35,0x35,0x20,0x8a,0x36,0x22,0xe6,0xbd,0x32,0x71, + 0x65,0xb8,0x87,0x91,0x9a,0xc2,0xf5,0x17,0x64,0xf,0x57,0xf,0x6,0xb4,0xf1,0x88, + 0xec,0x76,0xf6,0xa3,0x84,0xe0,0x9a,0x51,0x7a,0x5e,0xc3,0xa3,0x3d,0xc9,0xf3,0x38, + 0xcd,0xc0,0x89,0xcc,0x78,0x52,0x29,0xd0,0x54,0x76,0x36,0x60,0xea,0xf3,0x81,0xd4, + 0xd4,0x64,0x9b,0x1c,0xf4,0xe,0x1d,0x76,0xda,0x7b,0x55,0xa4,0x99,0xf7,0xca,0x98, + 0xad,0x28,0xdb,0x70,0x81,0x6c,0xfb,0xad,0x1d,0xcb,0xeb,0x0,0xe8,0x97,0x55,0xf1, + 0x28,0x80,0x8b,0x2b,0x2d,0xb0,0x5c,0x2c,0xee,0xa0,0xc7,0x33,0xb7,0x4,0x57,0x49, + 0x3a,0xd,0x9a,0x9e,0x9e,0x37,0xcd,0xe3,0x1,0xf1,0xf9,0x4e,0x89,0xaf,0x7c,0xad, + 0x5c,0xe4,0xc9,0xb2,0xe5,0x60,0x18,0x73,0x85,0x61,0x95,0xe0,0xea,0xf5,0x6e,0x8d, + 0x6a,0xa3,0x24,0x49,0x47,0x95,0x1e,0x6e,0xc5,0x5,0x2a,0xd1,0xf2,0x70,0x87,0x66, + 0x73,0x3b,0xae,0x11,0x44,0x11,0x34,0x91,0x0,0x12,0x89,0xec,0xdf,0x1e,0x4f,0xb6, + 0xed,0x97,0xe7,0xad,0x17,0x60,0x1d,0x69,0xe6,0xbd,0x32,0xe6,0x32,0x6a,0xf,0x57, + 0x4f,0x10,0x81,0x9,0x6d,0x94,0x9a,0x9a,0x9a,0x6,0x78,0x0,0x20,0x84,0xf4,0x2b, + 0xb,0xb0,0xa2,0x67,0x4e,0xcb,0xc3,0x3d,0xcc,0x4,0x57,0x1b,0x51,0xcc,0x8a,0xb0, + 0xfc,0x37,0xc7,0x65,0x45,0xd8,0xe3,0x1,0xf1,0x78,0xb2,0x7f,0xab,0x45,0xd8,0x69, + 0xef,0x55,0x8f,0x2d,0xc,0x86,0xcb,0x9,0xf9,0x7c,0x88,0xa9,0x74,0xa9,0x94,0xe0, + 0x56,0xa0,0x8d,0xc3,0x87,0xf,0x1f,0x4e,0xf1,0xd3,0x1b,0xfb,0xcd,0x14,0x58,0x2e, + 0x16,0xd7,0xe3,0xf1,0xe4,0xe2,0xd9,0x8,0x21,0x78,0xcb,0xe7,0x33,0x64,0xec,0x9c, + 0x45,0x92,0xb2,0xff,0x32,0x99,0x53,0x22,0x4c,0xc8,0x29,0xe1,0x9d,0x4e,0xe7,0x3a, + 0xe2,0xca,0xc,0xbe,0x60,0xcb,0xc1,0x30,0x18,0xda,0x1c,0x55,0x45,0x68,0x11,0x42, + 0x8a,0x36,0x29,0x54,0xa8,0x8d,0x47,0x81,0xec,0x4,0xe4,0xa0,0x94,0x1e,0x25,0x84, + 0x58,0x26,0xb6,0x32,0x3c,0xcf,0x43,0x14,0xc5,0x5c,0xb4,0xc2,0x21,0xaf,0x17,0x14, + 0x80,0xcb,0x16,0xdc,0x99,0x19,0x50,0x9a,0xf3,0x84,0x73,0x9b,0x94,0xbf,0xcb,0x42, + 0xc,0x64,0xff,0x57,0x86,0xb9,0x10,0x92,0xdd,0xdf,0xcc,0xa8,0x38,0x26,0xae,0x8c, + 0x59,0x8c,0x52,0x70,0x65,0x9d,0x4a,0xa7,0xb,0xd7,0xa8,0xb1,0x40,0x1b,0xfb,0x81, + 0x69,0xc1,0xf5,0x7a,0xbd,0xc7,0x32,0x99,0x8c,0x6e,0x2d,0xd4,0x3d,0xd9,0x2e,0xcf, + 0xe7,0x19,0x3f,0xc5,0x71,0x18,0xf6,0x78,0xb0,0xc8,0xc0,0xc4,0xbe,0xc,0x9d,0x98, + 0x9d,0x6b,0xb8,0x94,0x18,0x33,0x18,0xb3,0x9c,0xfe,0x69,0xc1,0x95,0xc5,0x96,0x52, + 0x5a,0xe0,0xe1,0x5a,0xe1,0x88,0xca,0xad,0x8,0x1c,0x0,0x6c,0xdf,0xbe,0x3d,0x1, + 0xe0,0x48,0x25,0x5,0x6a,0xa1,0xd5,0x71,0x76,0x88,0x35,0x2b,0xb8,0xb,0xa5,0x27, + 0xcb,0xc4,0x96,0x31,0xc7,0x38,0x5a,0x57,0x57,0x30,0xc2,0x4c,0x39,0xd5,0x81,0x55, + 0x5f,0xfd,0x1c,0xc7,0xf5,0x1,0x8a,0x65,0xc6,0x28,0xa5,0xbd,0x95,0x14,0xa8,0x95, + 0x57,0x53,0x70,0x55,0xd3,0xa0,0x31,0x18,0xc,0x86,0x13,0x8,0x84,0x60,0x50,0xd5, + 0x86,0x2b,0x7f,0x91,0x1b,0xd5,0x3a,0x1d,0xf9,0xf7,0x1,0xa,0xc1,0x25,0x84,0x14, + 0x15,0x5c,0xb3,0x4a,0xaf,0x1e,0x6d,0x6,0x0,0x6f,0x31,0xc1,0x65,0x30,0x18,0x2e, + 0xe0,0x64,0x6d,0x2d,0x32,0xaa,0x9d,0x4,0x1c,0xaf,0x0,0x0,0x20,0x0,0x49,0x44, + 0x41,0x54,0x68,0xaa,0x54,0x2a,0x65,0x79,0x5f,0x16,0x80,0xf4,0xc8,0xc8,0xc8,0x41, + 0x20,0x7f,0x21,0xdd,0x7d,0x15,0x14,0x98,0xcb,0x5b,0x2e,0x1e,0xf7,0x4d,0x26,0xb8, + 0xc,0x6,0xc3,0x5,0xbc,0x5d,0x5f,0x5f,0xb0,0x4d,0xab,0xc3,0xac,0x18,0x6,0xb4, + 0xf1,0x0,0x80,0xc,0xa0,0x10,0x5c,0x8e,0xe3,0xa,0x4,0xd7,0xa,0xa5,0x57,0xb, + 0xee,0x80,0xcf,0x87,0x90,0x3c,0xa9,0xb,0x83,0xc1,0x60,0x38,0x44,0x5f,0x63,0x63, + 0xc1,0xb6,0xd4,0xf4,0x50,0xfc,0x72,0x18,0xd1,0x46,0x49,0x92,0x72,0xad,0x7,0x39, + 0xc1,0xdd,0xb9,0x73,0xe7,0x61,0x0,0x31,0x33,0x5,0x96,0xca,0xeb,0x9d,0xf6,0x68, + 0x9,0x21,0x20,0x84,0x80,0x2,0xd8,0xcb,0x3a,0xce,0x18,0xc,0x86,0xc3,0xf4,0x35, + 0x34,0xe4,0xfd,0x9d,0xc9,0x64,0x74,0x2d,0x1e,0x69,0x62,0x51,0xdd,0x9c,0x33,0xab, + 0x6c,0x52,0x90,0x0,0xf4,0x59,0xd9,0x33,0x7,0x64,0x3d,0x5c,0x75,0x3b,0xee,0x6e, + 0xd5,0x50,0x3a,0x6,0x83,0xc1,0xa8,0x26,0x93,0x3c,0x8f,0x63,0xaa,0xe,0xb3,0x64, + 0x32,0x59,0x72,0x1f,0xb3,0xda,0x48,0x29,0xd5,0x14,0xdc,0xbc,0x1f,0xf4,0x14,0xa6, + 0x77,0x22,0x72,0x8f,0xaa,0x9,0x61,0x2f,0x13,0x5c,0x6,0x83,0xe1,0x20,0x7,0x1b, + 0x1a,0xf2,0x6,0xe,0x11,0x42,0x90,0x90,0xe7,0x36,0xd1,0xa0,0x92,0xbe,0x2c,0x65, + 0x4,0x98,0x7a,0xc2,0x83,0xb2,0xa1,0x61,0x46,0xf,0xe,0x14,0xb6,0xe3,0xf6,0xf9, + 0x7c,0x48,0x69,0x2c,0x34,0xc9,0x60,0x30,0x18,0xd5,0xe0,0xd,0x45,0x73,0x82,0xfc, + 0x5,0x5e,0xac,0xfd,0xb6,0xd2,0x85,0x23,0xc7,0xc7,0xc7,0x4f,0xca,0x7f,0xe4,0x9, + 0x2e,0x21,0xe4,0x25,0x13,0x5,0x96,0xcc,0xab,0x15,0x8f,0x9b,0x26,0x4,0x7,0x58, + 0x3b,0x2e,0x83,0xc1,0x70,0x88,0xbe,0x86,0x86,0x5c,0xbf,0x12,0x90,0x9d,0x3,0xd7, + 0xa6,0x21,0xbd,0x79,0x9a,0x9a,0x27,0xb8,0x2b,0x57,0xae,0xec,0x5,0x30,0x69,0xb0, + 0xc0,0xb2,0x79,0xb5,0x6,0x40,0xb0,0x76,0x5c,0x6,0x83,0xe1,0x4,0x19,0x8e,0xc3, + 0x5b,0xaa,0xe,0x33,0x75,0x73,0x82,0x55,0x7d,0x59,0x94,0xd2,0x57,0x94,0x7f,0xe7, + 0x9,0xee,0x63,0x8f,0x3d,0x26,0x52,0x4a,0x5f,0x35,0x52,0xa0,0x9e,0xbc,0xea,0x36, + 0x5c,0x42,0x8,0x5e,0xaa,0xad,0xd5,0x5d,0x1e,0x83,0xc1,0x60,0x58,0xc5,0xfe,0xc6, + 0x46,0xa4,0x54,0x9a,0xa4,0x6c,0x4e,0xb0,0x72,0xe1,0x48,0x8f,0xc7,0x53,0x5c,0x70, + 0x1,0x80,0xe3,0xb8,0xbc,0xc,0x56,0x28,0x3d,0x21,0x4,0xbe,0xe9,0x26,0x4,0xd9, + 0x85,0xdf,0x5b,0x53,0x83,0x49,0x8d,0x39,0x73,0x19,0xc,0x6,0xc3,0x4e,0x76,0x35, + 0x37,0x17,0x6c,0x8b,0xc5,0xb2,0x11,0xb1,0x16,0xf,0xe9,0x8d,0x8f,0x8c,0x8c,0xf4, + 0x28,0x37,0x14,0x28,0x1e,0x21,0xe4,0x65,0x65,0x81,0x56,0x1d,0xdc,0xe7,0xf3,0xe5, + 0x85,0x87,0x9,0x0,0x5e,0xd5,0x58,0xbc,0x8d,0xc1,0x60,0x30,0xec,0x44,0x2d,0xb8, + 0x82,0x20,0x20,0x9d,0x4e,0xdb,0x31,0xa4,0x77,0x17,0xa6,0x47,0x98,0xc9,0x14,0x8, + 0x6e,0x3c,0x1e,0xdf,0x1,0x40,0xb0,0xfa,0xe0,0x5e,0x8d,0x21,0xbd,0x2f,0xb3,0x66, + 0x5,0x6,0x83,0x51,0x45,0x86,0x6a,0x6a,0x30,0xa8,0xd2,0x9d,0x58,0x2c,0x66,0x87, + 0xd8,0x2,0xc0,0xcb,0xea,0xd,0x5,0x82,0xdb,0xd7,0xd7,0x37,0x65,0x34,0x1e,0x57, + 0xf,0x1c,0xc7,0x15,0xb4,0xe5,0xbe,0x5c,0x5b,0xb,0x63,0xad,0x25,0xc,0x6,0x83, + 0x61,0x9e,0xd7,0x35,0x9a,0x13,0xe2,0xf1,0xb8,0xee,0xfd,0xd,0xb6,0xef,0xbe,0xa2, + 0xde,0x50,0xac,0x11,0xf5,0x7f,0xad,0x3e,0x38,0xa5,0xb4,0xc0,0xcb,0x1d,0xf3,0x78, + 0xd8,0xb2,0x3b,0xc,0x6,0xa3,0x6a,0xec,0x6a,0x6a,0x2a,0xd8,0xa6,0x47,0x70,0x4d, + 0xf4,0x65,0x49,0xa9,0x54,0x6a,0x87,0x7a,0x7b,0x31,0xc1,0x7d,0x46,0x8f,0x1,0x6, + 0xe,0xe,0x40,0x3b,0x3c,0x8c,0x35,0x2b,0x30,0x18,0x8c,0x6a,0x90,0xe6,0x38,0xf4, + 0xce,0x9f,0x9f,0xfb,0x9b,0x10,0x82,0x64,0x32,0x9,0xa9,0xcc,0x6a,0x29,0x26,0xfb, + 0xb2,0x76,0x4d,0x4c,0x4c,0x84,0xd4,0xbf,0x6b,0xa,0xae,0x20,0x8,0x7f,0x2,0xa0, + 0x39,0xec,0xa2,0x92,0xa8,0x5,0xe5,0xbc,0xa,0x72,0xd0,0xf1,0xd3,0x1a,0x53,0xa4, + 0x31,0x18,0xc,0x86,0xd5,0xec,0x6c,0x69,0x41,0x72,0xba,0x59,0x53,0xd6,0x21,0x39, + 0x3a,0xa1,0x18,0x15,0xb4,0xed,0x3e,0xa5,0x95,0x47,0x53,0x70,0x7b,0x7b,0x7b,0x63, + 0xd0,0x68,0xf0,0xad,0x34,0x6a,0x81,0x10,0x2,0xaf,0xd7,0x9b,0x17,0xad,0x70,0xc8, + 0xe7,0xc3,0x11,0x36,0x47,0x2e,0x83,0xc1,0xb0,0x99,0x97,0x5a,0x5b,0x1,0x20,0x4f, + 0x7f,0x26,0x27,0x8b,0x8e,0xf3,0xaa,0xa8,0x23,0x4d,0x92,0xa4,0xa7,0xb5,0xf2,0x15, + 0xd,0x84,0x25,0x84,0xe4,0x29,0xb4,0x55,0xbd,0x78,0x3e,0x8d,0x36,0xdb,0xe7,0x99, + 0x97,0xcb,0x60,0x30,0x6c,0x24,0xe9,0xf1,0xe0,0xb5,0x96,0x96,0x3c,0xb1,0x4d,0x26, + 0x93,0xb6,0x2c,0x89,0x4e,0x8,0x9,0x86,0x42,0xa1,0xd7,0xb4,0xf2,0x16,0x15,0x5c, + 0x41,0x10,0x72,0xa,0x6d,0x65,0xc8,0x84,0xda,0xc3,0x5,0x80,0x67,0x55,0xd3,0xa4, + 0x31,0x18,0xc,0x86,0x95,0xec,0x6c,0x69,0x41,0x5a,0x15,0x25,0x35,0x35,0x35,0x55, + 0x90,0xcf,0x8a,0x81,0x5e,0x94,0xd2,0x67,0x1,0x68,0x4e,0xac,0x5b,0x54,0x70,0xf7, + 0xee,0xdd,0xdb,0x47,0x29,0x1d,0xb0,0x23,0x3e,0x4d,0x1d,0xad,0x70,0xd8,0xe7,0xc3, + 0xdb,0xac,0x59,0x81,0xc1,0x60,0xd8,0xc4,0xcb,0x6d,0x6d,0x5,0xdb,0x26,0x26,0x26, + 0xf2,0xfe,0xb6,0x6a,0xa0,0x17,0xa5,0x54,0xb3,0x39,0x1,0x28,0x21,0xb8,0xd3,0x3b, + 0x96,0x8d,0x56,0x28,0x77,0x70,0x2d,0xb4,0xa2,0x15,0x9e,0x63,0xcd,0xa,0xc,0x6, + 0xc3,0x6,0xe2,0x1e,0x4f,0xc1,0xe8,0xb2,0x64,0x32,0x9,0x41,0x10,0x72,0x7f,0x5b, + 0xe8,0x58,0x4a,0x5e,0xaf,0x57,0xb3,0xc3,0xc,0x28,0x23,0xb8,0x28,0xd2,0xd3,0x66, + 0xe0,0xe0,0x5,0x79,0xe5,0x78,0x5c,0x4e,0x31,0x8f,0x2,0x21,0x4,0xcf,0xcf,0x9b, + 0xa7,0xbb,0x1c,0x6,0x83,0xc1,0xd0,0xcb,0xab,0x2d,0x2d,0x48,0xab,0xe6,0x6d,0x51, + 0x7a,0xb7,0x16,0x7f,0xc5,0xef,0x1e,0x1e,0x1e,0x1e,0x2b,0xf6,0x63,0x49,0xc1,0x4d, + 0x24,0x12,0x7f,0x4,0x50,0x74,0x1a,0xf4,0x4a,0xc,0x95,0xbd,0x5c,0xb9,0x3d,0xf7, + 0x6d,0xaf,0x17,0xaf,0xb3,0xb9,0x15,0x18,0xc,0x86,0xc5,0x3c,0xb5,0x68,0x51,0xc1, + 0x36,0x79,0x38,0xaf,0xd,0x4d,0xa6,0x7f,0x28,0xf5,0x63,0x49,0xc1,0x3d,0x78,0xf0, + 0xe0,0x24,0x21,0x44,0xb3,0x80,0x4a,0xd,0x55,0x4f,0x66,0x3,0x0,0xff,0xa5,0x9a, + 0xa3,0x92,0xc1,0x60,0x30,0x2a,0xe1,0x58,0x5d,0x1d,0xde,0x50,0xad,0xce,0x1b,0x8b, + 0xc5,0xc,0x2f,0x87,0x6e,0x40,0xef,0x1e,0x2a,0xf5,0x63,0xd9,0xf9,0x11,0x25,0x49, + 0x7a,0x4c,0xcb,0x0,0xbd,0x14,0xcb,0xab,0xb5,0xd6,0xd9,0xf3,0xf5,0xf5,0x88,0xb2, + 0x29,0x1b,0x19,0xc,0x86,0x45,0x3c,0xdb,0xd1,0x51,0xb0,0x2d,0x1a,0x8d,0xea,0xde, + 0xdf,0xe0,0xdc,0x9,0x7b,0xc7,0xc7,0xc7,0xf,0x95,0xca,0x50,0x56,0xdd,0x3c,0x1e, + 0xcf,0x13,0x0,0xa6,0xe4,0x83,0x5b,0x1d,0x22,0xa6,0x24,0x45,0x8,0x9e,0x60,0x6d, + 0xb9,0xc,0x6,0xc3,0x2,0x32,0x1c,0x87,0x3f,0xa9,0x4,0x57,0x92,0x24,0xcd,0x70, + 0x30,0x2d,0x4c,0xf4,0x4f,0x15,0x38,0xa7,0x6a,0xca,0xa,0x6e,0x4f,0x4f,0x4f,0x1c, + 0xc0,0x13,0x16,0x4f,0xcc,0xb,0x40,0x3b,0x5a,0x81,0x35,0x2b,0x30,0x18,0xc,0x2b, + 0xd8,0xde,0xd2,0x82,0x9,0x45,0x5f,0x11,0x21,0x4,0xd1,0x68,0x54,0x97,0x36,0x99, + 0x71,0x2c,0x3d,0x1e,0xcf,0x23,0xe5,0xf2,0xea,0xfa,0x7e,0x97,0x24,0xe9,0x51,0xa3, + 0x7,0xd7,0x83,0x3c,0xd4,0x57,0xc9,0x11,0xbf,0x1f,0xbd,0xac,0xf3,0x8c,0xc1,0x60, + 0x54,0xc8,0xb3,0xb,0x17,0x2,0xc8,0x1f,0xca,0x1b,0x89,0x44,0xca,0xee,0x67,0xf2, + 0x2b,0x7e,0xf7,0xe8,0xe8,0xe8,0xdb,0xe5,0xf2,0xeb,0x12,0xdc,0xe6,0xe6,0xe6,0x27, + 0x1,0x4c,0x94,0xcb,0x57,0xc9,0xc,0x62,0xca,0x15,0x34,0x1f,0x63,0x5e,0x2e,0x83, + 0xc1,0xa8,0x80,0x13,0xb5,0xb5,0xe8,0x6d,0x6a,0xca,0x13,0xdb,0x44,0x22,0x51,0xb2, + 0xb3,0xac,0xc2,0x26,0x53,0x5d,0x4e,0xa9,0x2e,0xc1,0xdd,0xb6,0x6d,0x5b,0x12,0x65, + 0xc2,0x1d,0xcc,0x1a,0xea,0xf1,0x78,0xf2,0x62,0x72,0x1,0xe0,0xe9,0x79,0xf3,0x30, + 0xac,0xd1,0xdc,0xc0,0x60,0x30,0x18,0x7a,0xf8,0xaf,0xa5,0x4b,0x41,0x55,0x51,0x50, + 0xa5,0xbc,0xdb,0xa,0x9b,0x4c,0xa9,0x20,0x8,0xbf,0xd6,0xb3,0xaf,0xee,0x90,0x0, + 0x49,0x92,0x34,0xdb,0x27,0x2a,0xed,0x48,0xd3,0x6a,0x56,0x10,0x9,0xc1,0x23,0x8a, + 0x79,0x2b,0x19,0xc,0x6,0x43,0x2f,0x61,0x9f,0xf,0x2f,0x2c,0x58,0x90,0xb7,0x4d, + 0x10,0x84,0x82,0xa1,0xbc,0x32,0x16,0x4,0x2,0xbc,0x16,0x8d,0x46,0x8f,0xea,0xd9, + 0x5f,0xb7,0xe0,0xf6,0xf6,0xf6,0x3e,0x1,0x60,0x40,0xc7,0xc1,0x8b,0x52,0x2c,0xbf, + 0x56,0x4c,0xee,0x6f,0x1b,0x1a,0x30,0xc5,0x42,0xc4,0x18,0xc,0x86,0x41,0x9e,0x5c, + 0xb4,0x8,0x19,0x95,0x76,0x84,0xc3,0xe1,0x62,0x13,0xcd,0xe8,0x2e,0xb7,0xc4,0xdc, + 0x9,0x3f,0xd4,0x5b,0x86,0x11,0x45,0x93,0x0,0x3c,0x58,0xee,0xe0,0x45,0xc,0x2a, + 0x9b,0x5f,0x1d,0xb1,0x10,0xe3,0x38,0xfc,0x5e,0x15,0xb0,0xcc,0x60,0x30,0x18,0xa5, + 0x48,0x79,0x3c,0x78,0x62,0xf1,0xe2,0xbc,0x6d,0x92,0x24,0x15,0x34,0x27,0x58,0x18, + 0xe2,0x3a,0xe1,0xf5,0x7a,0x75,0x35,0x27,0x0,0xc6,0x4,0x17,0x92,0x24,0xdd,0xf, + 0x40,0xac,0xc6,0xc,0x62,0x84,0x10,0x3c,0x34,0x7f,0x3e,0x44,0x95,0xe7,0xcb,0x60, + 0x30,0x18,0xc5,0xf8,0xe3,0x82,0x5,0x98,0x54,0x39,0x6f,0xd1,0x68,0x14,0xa2,0x78, + 0x6a,0xb6,0x44,0x2b,0x9d,0x45,0x4a,0xe9,0xc3,0x23,0x23,0x23,0xa5,0x97,0x8d,0x50, + 0x60,0x48,0x70,0x7b,0x7b,0x7b,0x7,0x29,0xa5,0xcf,0xe9,0xcd,0x6f,0x34,0x44,0x4c, + 0x3d,0xbf,0xc2,0x10,0xcf,0xe3,0x5,0x36,0x8b,0x18,0x83,0xc1,0xd0,0x81,0x4,0xe0, + 0x71,0x95,0x77,0x4b,0x29,0x45,0x28,0x14,0xca,0xfb,0x5b,0x2f,0x7a,0xf2,0x72,0x1c, + 0x77,0xbf,0xee,0x2,0x61,0x50,0x70,0xa7,0xf9,0xb1,0x9e,0x4c,0x66,0x4e,0x4c,0x6b, + 0x72,0xf2,0xfb,0x5a,0x5a,0x98,0x97,0xcb,0x60,0x30,0xca,0xb2,0x6d,0xc1,0x2,0xc, + 0xaa,0x16,0x33,0x98,0x9c,0x9c,0xcc,0xad,0xea,0x60,0xc3,0x97,0xf9,0xee,0xf1,0xf1, + 0xf1,0x5d,0x6,0x4c,0x34,0x2e,0xb8,0xcd,0xcd,0xcd,0xbf,0x7,0x30,0x54,0xec,0xf7, + 0x4a,0xda,0x46,0x38,0x8e,0x2b,0x98,0x5f,0x61,0xc0,0xeb,0xc5,0xd3,0x6c,0xb8,0x2f, + 0x83,0xc1,0x28,0x41,0x86,0x10,0xfc,0xaa,0xb3,0xb3,0x60,0x7b,0x38,0x1c,0x6,0x60, + 0x8b,0xd8,0x2,0xc0,0x3,0xba,0xb,0x9d,0xc6,0xb0,0xe0,0x6e,0xdb,0xb6,0x4d,0x0, + 0xf0,0x73,0xad,0xdf,0xac,0x68,0x1b,0x51,0xb7,0xe5,0x2,0xc0,0x8f,0x9a,0x9b,0x21, + 0x30,0x2f,0x97,0xc1,0x60,0x14,0xe1,0x4f,0x1d,0x1d,0x18,0x55,0x8c,0x50,0x25,0x84, + 0x20,0x16,0x8b,0x21,0x1e,0x8f,0xdb,0x25,0xb6,0x71,0x49,0x92,0x7e,0x69,0xcc,0x4a, + 0x73,0x4d,0xa,0x10,0x45,0xf1,0xc7,0x50,0xad,0xd9,0x63,0xd5,0x49,0x69,0x79,0xb9, + 0x83,0x5e,0x2f,0x9e,0x60,0xa3,0xcf,0x18,0xc,0x86,0x6,0x19,0x8e,0xc3,0xaf,0x97, + 0x2f,0xcf,0xfd,0x2d,0x37,0x4b,0x8e,0x8c,0x8c,0xe8,0x2e,0xc3,0xc4,0x97,0xf9,0xaf, + 0xc3,0xe1,0xb0,0xfe,0x69,0xc7,0xa6,0x31,0x25,0xb8,0xfb,0xf7,0xef,0x7f,0x1b,0xc0, + 0x6f,0x14,0x7,0xd7,0xbd,0xaf,0x9e,0xbc,0x5a,0x11,0xb,0x3f,0x6e,0x69,0x41,0x9a, + 0x79,0xb9,0xc,0x6,0x43,0xc5,0xb3,0xb,0x17,0x62,0xcc,0xef,0x7,0x70,0x4a,0x6c, + 0x27,0x27,0x27,0x91,0x4a,0xa5,0x74,0xed,0x6f,0xe2,0xcb,0x5c,0xe2,0x38,0xee,0xdf, + 0x8c,0x5b,0x6a,0x52,0x70,0x1,0x80,0xe3,0xb8,0x6f,0xc9,0x6,0xe8,0x45,0x6f,0x5e, + 0x8e,0xe3,0xc0,0x71,0x5c,0xde,0xfc,0xa,0xc3,0x3c,0x8f,0xff,0x61,0x71,0xb9,0xc, + 0x6,0x43,0x41,0x8a,0xe3,0xf0,0xe8,0xb2,0x65,0x0,0xf2,0x27,0xa9,0x19,0x1d,0x1d, + 0xd5,0xb5,0xbf,0x19,0xfd,0xa2,0x94,0xfe,0x61,0x7c,0x7c,0xfc,0xa0,0x1,0x33,0x73, + 0x98,0x16,0xdc,0xdd,0xbb,0x77,0xef,0x92,0x24,0x69,0x9b,0xde,0xfc,0x46,0x4f,0xcc, + 0xe7,0xf3,0x15,0x6c,0xff,0x49,0x73,0x33,0x92,0x6c,0xf4,0x19,0x83,0xc1,0x98,0xe6, + 0x89,0xc5,0x8b,0x11,0xf6,0xfb,0xf3,0xc4,0x36,0x1a,0x8d,0xea,0xf2,0x6e,0x2b,0x70, + 0x16,0xbf,0x69,0xc0,0xc4,0x3c,0x2a,0x52,0x2f,0x8e,0xe3,0xbe,0x5d,0x2e,0x8f,0xd9, + 0xa8,0x5,0x42,0x48,0x41,0x5b,0xee,0x18,0xcf,0xe3,0xc7,0xaa,0xd5,0x37,0x19,0xc, + 0xc6,0xdc,0x24,0xe4,0xf3,0xe1,0x11,0x55,0x64,0x2,0xa5,0x14,0x63,0x63,0x45,0xd7, + 0x70,0xcc,0xe5,0xa9,0x40,0x6c,0xb7,0x87,0xc3,0xe1,0x97,0xd,0x98,0x99,0x47,0x45, + 0x82,0xbb,0x77,0xef,0xde,0x27,0x0,0xf4,0x15,0xfb,0xbd,0xd2,0xa8,0x5,0xad,0x9, + 0xca,0x1f,0x6a,0x6a,0xc2,0x31,0x8d,0x48,0x6,0x6,0x83,0x31,0xb7,0xf8,0xd9,0xca, + 0x95,0x48,0xaa,0x9c,0xb2,0x68,0x34,0x5a,0x76,0xa,0x46,0x23,0x68,0xe4,0x2f,0xeb, + 0x64,0x96,0xa2,0xd2,0xef,0x73,0xa,0xe0,0xbb,0x9a,0x3f,0x58,0xd0,0xb6,0xab,0x1c, + 0x7d,0x26,0x93,0x21,0x4,0xdf,0x6b,0x6b,0xd3,0x6f,0x21,0x83,0xc1,0x98,0x75,0x1c, + 0x6c,0x68,0xc0,0x36,0xd5,0xf2,0x39,0xa2,0x28,0x96,0x8c,0x4c,0xb0,0x20,0x6c,0xf5, + 0xad,0x50,0x28,0xf4,0xdf,0x6,0xcc,0x2c,0xa0,0xe2,0x6,0xd1,0xfa,0xfa,0xfa,0x87, + 0x0,0xe4,0xb5,0x50,0x5b,0xd9,0x91,0xc6,0xf3,0x7c,0xae,0x7d,0x46,0xee,0x44,0xfb, + 0xf3,0xbc,0x79,0xd8,0xa1,0x1a,0x51,0xc2,0x60,0x30,0xe6,0x6,0x14,0xc0,0xfd,0xa7, + 0x9d,0x6,0xb5,0x72,0x4,0x83,0xc1,0xbc,0x39,0x13,0xf2,0xf6,0xb1,0xc6,0x1,0xfc, + 0x3e,0xb2,0x23,0x88,0x4d,0x53,0xb1,0xe0,0x6e,0xdf,0xbe,0x3d,0x1,0xe0,0x6b,0x80, + 0xf5,0x8b,0x4c,0xca,0x28,0x45,0x57,0xe6,0xbb,0xed,0xed,0x6c,0xc8,0x2f,0x83,0x31, + 0x7,0xd9,0xd6,0xd1,0x81,0x83,0xaa,0x88,0xa5,0x74,0x3a,0x8d,0x60,0x30,0xa8,0x99, + 0xdf,0x22,0x4d,0x3a,0x1e,0xc,0x6,0x7f,0xa4,0xbb,0xa0,0x22,0x58,0xd2,0xe5,0x3f, + 0x31,0x31,0xf1,0x43,0x4a,0xe9,0xa0,0xde,0xfc,0x46,0x85,0x59,0x19,0x1e,0x26,0x73, + 0xc4,0xe7,0xc3,0x7f,0xb1,0x49,0xca,0x19,0x8c,0x39,0x45,0xc2,0xe3,0xc1,0x2f,0x56, + 0xac,0x28,0xd8,0x3e,0x3a,0x3a,0x5a,0xa0,0x29,0x56,0x3a,0x80,0x94,0xd2,0xaf,0x2, + 0xd0,0x17,0xd8,0x5b,0x2,0x4b,0x4,0xb7,0xbf,0xbf,0x3f,0x49,0x8,0xf9,0x9a,0x9e, + 0xbc,0x66,0x1a,0xad,0xb5,0xda,0x72,0x1,0xe0,0x7b,0x6d,0x6d,0x18,0x64,0x1d,0x68, + 0xc,0xc6,0x9c,0xe1,0x81,0x55,0xab,0x30,0x3e,0x3d,0xc8,0x41,0x66,0x6a,0x6a,0xaa, + 0x60,0x35,0x7,0x8b,0xe7,0xeb,0x3e,0x12,0xe,0x87,0x7f,0x62,0xc0,0xcc,0xa2,0x58, + 0x16,0xd4,0xea,0xf5,0x7a,0xef,0x7,0x50,0x72,0x99,0x89,0x4a,0x2e,0x82,0x96,0x97, + 0x9b,0x24,0x4,0x5f,0x5d,0xb0,0xa0,0xa0,0x2d,0x87,0xc1,0x60,0xcc,0x3e,0xf6,0x36, + 0x37,0xe3,0xb9,0x45,0x8b,0xa,0xb6,0xab,0xc3,0xc0,0x6c,0x68,0xd6,0xfc,0x2a,0x80, + 0x8c,0xee,0x42,0x4b,0xe0,0x29,0x9f,0x45,0x1f,0x43,0x43,0x43,0xd2,0xc2,0x85,0xb, + 0x63,0x0,0x6e,0xd4,0xfa,0xdd,0x8a,0x8b,0xc0,0x71,0x1c,0x24,0xe9,0x54,0x9b,0x35, + 0x21,0x4,0x43,0x3e,0x1f,0x96,0x64,0x32,0x38,0x53,0xe7,0x30,0x3e,0x6,0x83,0x31, + 0xf3,0x48,0x73,0x1c,0xbe,0x7c,0xf6,0xd9,0x98,0x54,0x7d,0xd1,0x6,0x83,0xc1,0xbc, + 0xd5,0x1c,0x6c,0x10,0xdb,0x83,0xa1,0x50,0xe8,0x23,0x80,0x35,0x7e,0x9d,0xa5,0xc3, + 0xb6,0xbc,0x5e,0xef,0xcf,0x0,0x14,0xac,0xcd,0x6e,0xd5,0x45,0xd0,0x9a,0xa4,0x1c, + 0xc8,0x76,0xa0,0x5,0x3d,0x96,0xbd,0x3b,0x18,0xc,0x86,0xcb,0x78,0xb8,0xb3,0x13, + 0x27,0x6b,0x6b,0xf3,0xb6,0x65,0x32,0x99,0xdc,0x10,0x5e,0xbb,0x3a,0xec,0x29,0xa5, + 0x5f,0x81,0x6a,0xa2,0xae,0x4a,0xb0,0x54,0x70,0x7b,0x7a,0x7a,0x32,0x84,0x90,0xbb, + 0xe5,0xbf,0xed,0xb8,0x8,0xf2,0x3c,0xb,0x4a,0x26,0x3c,0x1e,0x7c,0x5b,0xb5,0x4a, + 0x27,0x83,0xc1,0x98,0x1d,0x1c,0x9e,0x37,0xf,0xbf,0x5b,0xba,0x34,0x6f,0x1b,0x21, + 0x4,0x27,0x4f,0x9e,0x34,0xac,0x31,0x80,0x21,0x7,0xf0,0x40,0x38,0x1c,0x7e,0xd8, + 0x50,0xe1,0x65,0xb0,0x7c,0x62,0x82,0x96,0x96,0x96,0x87,0x0,0xbc,0x69,0xf5,0x22, + 0x93,0x4a,0xd4,0x43,0x7e,0x1,0xe0,0xf9,0x86,0x6,0xbc,0xc4,0x96,0xe3,0x61,0x30, + 0x66,0x15,0x2,0x21,0xb8,0xef,0x8c,0x33,0x72,0x21,0xa0,0x72,0x5f,0x4e,0x24,0x12, + 0x41,0x2c,0x16,0xb3,0x7c,0x31,0x5b,0x15,0x5f,0x82,0x85,0xde,0x2d,0x60,0x83,0xe0, + 0x6e,0xdb,0xb6,0x4d,0x90,0x24,0xe9,0xe3,0x7a,0xf3,0x9b,0xbd,0x60,0x6a,0x2f,0x17, + 0x0,0xee,0x5a,0xb8,0x10,0x23,0x1a,0xd1,0xc,0xc,0x6,0x63,0x66,0xf2,0x8b,0x95, + 0x2b,0x71,0x78,0x7a,0x2e,0x6c,0xb9,0x19,0x51,0x10,0x4,0xc,0xf,0xf,0xdb,0x35, + 0xb1,0x38,0x28,0xa5,0x90,0x24,0xe9,0xb9,0x50,0x28,0xa4,0x7b,0x35,0x5e,0xbd,0xd8, + 0x32,0xf5,0x56,0x5f,0x5f,0xdf,0x9f,0x28,0xa5,0xff,0x53,0x2e,0x5f,0x25,0x17,0x4c, + 0x9e,0xbe,0x51,0xc9,0x14,0xcf,0xe3,0x2b,0xb,0x17,0xb2,0xa8,0x5,0x6,0x63,0x16, + 0xb0,0xb7,0xa9,0x9,0xff,0x33,0xdd,0x94,0xa0,0x7c,0xd6,0x47,0x46,0x46,0x20,0x8, + 0x82,0xee,0x72,0x4c,0xe8,0x8c,0xc0,0x71,0xdc,0xdf,0xeb,0xde,0xc9,0x0,0xb6,0xcd, + 0x75,0xc8,0x71,0xdc,0x3f,0xa0,0x44,0xa0,0xb0,0x15,0x6f,0x27,0x65,0xd3,0x82,0x5c, + 0x21,0x3b,0xeb,0xeb,0xf1,0x6b,0x36,0xa3,0x18,0x83,0x31,0xa3,0x99,0xf4,0x7a,0xf1, + 0xdd,0xd5,0xab,0x41,0x55,0xe1,0xa0,0xd1,0x68,0x34,0xb7,0x4e,0x99,0x1e,0x4c,0xea, + 0xcc,0xfd,0xa1,0x50,0xa8,0xe8,0xa4,0x5c,0x95,0x60,0x5b,0xd7,0xfe,0xe8,0xe8,0x68, + 0xb8,0xbd,0xbd,0x7d,0x1e,0x21,0x64,0x93,0xfa,0x37,0xbb,0x3e,0x5,0x64,0x5e,0xaf, + 0xab,0x43,0xd7,0xd4,0x14,0x5a,0x8a,0x8c,0xab,0x66,0x30,0x18,0xee,0xe6,0x3b,0x6b, + 0xd6,0xe0,0xb0,0x6a,0x24,0x69,0x3a,0x9d,0xc6,0xb1,0x63,0xc7,0x74,0x69,0x42,0x5, + 0x1d,0x69,0x41,0x51,0x14,0xdf,0x95,0x4a,0xa5,0x12,0x86,0xa,0xd0,0x89,0xad,0xb3, + 0x79,0xb,0x82,0xf0,0x55,0x28,0x56,0xf8,0xb5,0x2b,0x6a,0x41,0xdd,0xb4,0x90,0x26, + 0x4,0x9f,0x5b,0xb4,0x8,0x29,0x36,0xd7,0x2,0x83,0x31,0xe3,0xf8,0x53,0x47,0x7, + 0x76,0xb4,0xb7,0xe7,0x6d,0xa3,0x94,0xe2,0xc4,0x89,0x13,0x45,0x27,0xa7,0x51,0xe7, + 0xd5,0x8b,0x5a,0x93,0x28,0xa5,0x5f,0x99,0x98,0x98,0x8,0xe9,0xb7,0xd6,0x18,0xb6, + 0x6,0xaf,0x6,0x83,0xc1,0x74,0x47,0x47,0x47,0x8,0xc0,0x4d,0x76,0x7b,0xb5,0xea, + 0x7d,0x22,0x3c,0x8f,0x38,0xc7,0x61,0x63,0x2c,0x66,0xb8,0x2c,0x6,0x83,0xe1,0xc, + 0x27,0x6b,0x6b,0xf1,0xaf,0xeb,0xd6,0x21,0xa3,0xea,0x14,0x1f,0x1b,0x1b,0xcb,0x1b, + 0xe0,0x50,0x8c,0xa,0x75,0x66,0x7f,0x24,0x12,0xf9,0x30,0x2a,0x9c,0x11,0xac,0x14, + 0xb6,0xaf,0x57,0xb3,0x66,0xcd,0x9a,0x9f,0x3,0x78,0x5d,0x6f,0x7e,0xb3,0x6f,0x27, + 0xb5,0x97,0xb,0x0,0x8f,0xb6,0xb4,0xe0,0xf1,0xa6,0x26,0xdd,0xe5,0x31,0x18,0xc, + 0xe7,0x88,0xf3,0x3c,0xbe,0xb2,0x7e,0x3d,0xe2,0xaa,0x48,0xa3,0x78,0x3c,0x5e,0x76, + 0x15,0x7,0xc0,0x92,0xa6,0xca,0xcf,0x2,0xd0,0xdf,0x1b,0x67,0x2,0xdb,0x5,0xf7, + 0xb1,0xc7,0x1e,0x13,0x1,0x7c,0x8,0x3a,0xc6,0x22,0x57,0x72,0xc1,0xd4,0x82,0x2b, + 0xff,0xfd,0xad,0x8e,0xe,0x1c,0x50,0xac,0x57,0xcf,0x60,0x30,0xdc,0x7,0x5,0xf0, + 0xdd,0x35,0x6b,0x70,0x42,0x35,0x9a,0x4c,0x92,0x24,0x9c,0x38,0x71,0xa2,0xac,0x36, + 0x58,0x20,0xb6,0xf,0x87,0xc3,0xe1,0x3f,0xe8,0x2e,0xc4,0x24,0x55,0x19,0xf,0x3b, + 0x3a,0x3a,0x3a,0xb2,0x60,0xc1,0x82,0x7a,0x0,0x5,0x1d,0x68,0x32,0x56,0xad,0x10, + 0xa1,0xfc,0x1f,0x0,0x44,0x42,0xb0,0xa3,0xbe,0x1e,0xd7,0x4d,0x4c,0xa0,0xd6,0x44, + 0x53,0x5,0x83,0xc1,0xb0,0x9f,0xdf,0x2e,0x5f,0x8e,0xa7,0x16,0x2f,0x2e,0xd8,0x7e, + 0xfc,0xf8,0x71,0xc4,0xe3,0xf1,0xa2,0xfb,0x59,0x34,0xca,0x6c,0x5c,0x10,0x84,0x77, + 0xa4,0xd3,0xe9,0xe2,0x7,0xb2,0x88,0xaa,0x2d,0x81,0xdb,0xd8,0xd8,0xf8,0x25,0x0, + 0x87,0xd5,0xdb,0xad,0xee,0x48,0xd3,0x6a,0x5a,0x18,0xf1,0x7a,0xf1,0xf9,0xc5,0x8b, + 0xad,0x1d,0x32,0xc2,0x60,0x30,0x2c,0xe1,0xf5,0x96,0x16,0xfc,0x6a,0xe5,0xca,0x82, + 0xed,0x63,0x63,0x63,0x5,0xd3,0x2e,0x2a,0xb1,0x6a,0x94,0x19,0xa5,0xf4,0x9f,0x26, + 0x27,0x27,0xc7,0x75,0x17,0x56,0x1,0x55,0x9b,0xf1,0x65,0x70,0x70,0x50,0xe8,0xe8, + 0xe8,0xd8,0x7,0xe0,0x3,0x0,0x8,0x60,0xd9,0xdb,0x49,0x17,0x27,0x7d,0x3e,0x10, + 0x0,0x17,0x94,0x78,0x5b,0x32,0x18,0x8c,0xea,0x32,0xee,0xf7,0xe3,0xee,0xf5,0xeb, + 0x91,0x50,0xd,0xd7,0x9f,0x9c,0x9c,0xc4,0x89,0x13,0x27,0x8a,0xee,0x67,0xe1,0xc4, + 0xe2,0xcf,0x47,0x22,0x91,0x4f,0xe9,0x2e,0xac,0x42,0xaa,0x3a,0xc5,0xd6,0xe8,0xe8, + 0x68,0xff,0x82,0x5,0xb,0x56,0x2,0x38,0xd7,0xee,0xa8,0x5,0x2d,0xf6,0xd4,0xd7, + 0xa3,0x55,0x14,0x71,0x56,0x32,0x69,0x49,0x79,0xc,0x6,0xc3,0x3c,0x53,0x3c,0x8f, + 0xcf,0x9d,0x7b,0x2e,0x46,0x55,0x7d,0x2c,0x99,0x4c,0x6,0xfd,0xfd,0xfd,0xa5,0x3c, + 0x52,0xdd,0xc7,0x28,0x93,0x37,0x21,0x49,0xd2,0xd,0xa9,0x54,0x4a,0x7b,0x6d,0x1e, + 0x1b,0xa8,0x5a,0x93,0x82,0x82,0x7f,0xa0,0x94,0x8e,0x96,0xcf,0x96,0xc5,0xaa,0xcf, + 0x6,0xb9,0xa9,0xe1,0x3b,0x1d,0x1d,0xd8,0xc9,0x26,0xb9,0x61,0x30,0x1c,0x25,0xc3, + 0x71,0xf8,0xda,0xba,0x75,0x38,0xae,0x5a,0xc,0x96,0x52,0x8a,0x81,0x81,0x1,0xcd, + 0x78,0x5b,0x1b,0xe2,0xf8,0xbf,0x32,0x31,0x31,0xf1,0x96,0xee,0x2,0x2d,0xa0,0xea, + 0x93,0xc8,0x8e,0x8d,0x8d,0x25,0x16,0x2c,0x58,0x30,0x6,0xe0,0x9d,0xe5,0xf2,0x5a, + 0x39,0x8f,0xae,0x8c,0x44,0x8,0x5e,0x6a,0x68,0xc0,0x65,0x6c,0x24,0x1a,0x83,0xe1, + 0x8,0x14,0xc0,0x3d,0x6b,0xd6,0x60,0x57,0x6b,0x6b,0xc1,0x6f,0x27,0x4f,0x9e,0xc4, + 0xd4,0xd4,0x54,0xe1,0x3e,0xd6,0x7f,0x11,0xbf,0x11,0xe,0x87,0x3f,0x8,0x8b,0x67, + 0x3,0x2b,0x87,0x23,0xb3,0x76,0x8f,0x8d,0x8d,0xed,0x6d,0x6f,0x6f,0x3f,0x13,0xc0, + 0xfa,0x62,0x79,0xac,0xbe,0xc0,0x4a,0xd1,0xcd,0x10,0x82,0x97,0x1b,0x1a,0x70,0xd5, + 0xe4,0x24,0xea,0x25,0xdb,0x62,0x9c,0x19,0xc,0x86,0x6,0x8f,0x76,0x76,0xe2,0xf, + 0x4b,0x96,0x14,0x6c,0x1f,0x1d,0x1d,0xd5,0x5c,0x79,0xd7,0x6,0xb1,0x4d,0x10,0x42, + 0xae,0x4e,0x24,0x12,0xc3,0xba,0xb,0xb6,0x8,0x27,0x9a,0x14,0x0,0x0,0xc9,0x64, + 0xf2,0x63,0x0,0xfa,0xd5,0xdb,0xed,0x9a,0xb9,0x5d,0xcd,0x18,0xcf,0xe3,0x1f,0x97, + 0x2e,0x45,0x52,0x63,0x9a,0x47,0x6,0x83,0x61,0xf,0x2f,0x74,0x74,0xe0,0x61,0x8d, + 0x55,0x77,0xa3,0xd1,0x68,0x6e,0xf5,0x6,0x25,0x36,0x69,0xc1,0x3f,0x85,0x42,0xa1, + 0x37,0x74,0x17,0x6c,0x21,0x8e,0xa9,0xcd,0x91,0x23,0x47,0xa2,0x84,0x90,0xbf,0x26, + 0x84,0xe4,0x5c,0x7a,0x3b,0x27,0x13,0xd6,0xca,0x7b,0xa8,0xb6,0x16,0x5f,0x5c,0xb2, + 0x4,0x2,0x9b,0x73,0x81,0xc1,0xb0,0x9d,0xde,0xa6,0x26,0xdc,0x77,0xe6,0x99,0x5, + 0xd3,0xa7,0xc6,0x62,0x31,0xc,0xe,0xe,0xe6,0x6d,0xb3,0xd1,0xf1,0x7a,0x3c,0x1c, + 0xe,0xff,0x87,0xee,0x82,0x2d,0xc6,0xd1,0x85,0xc0,0xc6,0xc6,0xc6,0x8e,0xb7,0xb5, + 0xb5,0xf1,0x84,0x90,0xcd,0x76,0x4e,0x26,0xac,0x44,0x3d,0x38,0xe2,0x98,0xdf,0x8f, + 0xc3,0x35,0x35,0xe8,0x9e,0x9c,0x74,0xee,0xed,0xc3,0x60,0xcc,0x72,0xf6,0x35,0x35, + 0xe1,0xcb,0xeb,0xd7,0x23,0xad,0xfa,0xa2,0x4c,0xa7,0xd3,0x18,0x18,0x18,0xc8,0x5b, + 0x1c,0xd6,0xc6,0x70,0xd1,0xa1,0x4c,0x26,0xb3,0x35,0x9d,0x4e,0x3b,0x36,0xc1,0x8a, + 0xe3,0x1a,0xd3,0xd1,0xd1,0x71,0x37,0xa5,0x74,0xbb,0xde,0xfc,0x95,0x88,0x6d,0xb1, + 0x79,0x17,0x5e,0x6a,0x68,0xc0,0x17,0x97,0x2c,0xc9,0x2d,0xe3,0xc1,0x60,0x30,0xac, + 0xe3,0x8d,0xf9,0xf3,0xb,0xc4,0x96,0x10,0x2,0x49,0x92,0xd0,0xdf,0xdf,0x9f,0x37, + 0x99,0xb8,0x8d,0x5f,0xb9,0x54,0x92,0xa4,0xf,0x4e,0x4d,0x4d,0x95,0x9f,0x94,0xc1, + 0x46,0x1c,0x5f,0xea,0xb6,0xbf,0xbf,0x5f,0x6a,0x69,0x69,0x79,0x81,0xe3,0xb8,0xf, + 0x1,0xf0,0x97,0xca,0x6b,0x85,0x17,0x4c,0x29,0xcd,0xad,0x8b,0x94,0x67,0x87,0xdf, + 0x8f,0x61,0xaf,0x17,0x57,0x4c,0x4e,0x82,0xc9,0x2e,0x83,0x61,0xd,0x6f,0x37,0x34, + 0xe0,0xae,0xf5,0xeb,0x91,0x54,0x2d,0x16,0x20,0x49,0x12,0x6,0x6,0x6,0x90,0x54, + 0xc4,0xc4,0xdb,0xfc,0x95,0xfb,0xbd,0x68,0x34,0xea,0x58,0x53,0x82,0x8c,0xe3,0x82, + 0xb,0x0,0xc1,0x60,0x30,0xbc,0x60,0xc1,0x82,0x51,0x0,0x37,0x15,0xcb,0x63,0x65, + 0x65,0x14,0x13,0xdd,0xc3,0x35,0x35,0x98,0xe0,0x79,0x6c,0xd4,0x8,0x4b,0x61,0x30, + 0x18,0xc6,0x38,0x5e,0x5f,0x8f,0xcf,0x6f,0xd8,0x80,0x29,0xaf,0x37,0xb7,0x4d,0xe9, + 0xd9,0xc6,0x14,0x53,0xa7,0xda,0x2c,0xb6,0xfb,0xe7,0xcd,0x9b,0x77,0xeb,0xc4,0xc4, + 0x84,0xad,0x33,0x81,0xe9,0xc1,0x15,0x82,0xb,0x0,0x63,0x63,0x63,0xbb,0xdb,0xdb, + 0xdb,0xdb,0x1,0x5c,0xac,0xdc,0x6e,0x57,0x7b,0x8e,0x96,0xe8,0x12,0x42,0x70,0xa0, + 0xb6,0x16,0x19,0x8e,0xc3,0x85,0x6c,0x1e,0x5d,0x6,0xc3,0x34,0x27,0x6a,0x6b,0xf1, + 0xc5,0xd,0x1b,0x10,0xf6,0xf9,0x0,0x9c,0x5a,0x6d,0x57,0x1e,0xd8,0x20,0x8b,0xad, + 0x9d,0xc3,0xfb,0xa7,0xf3,0x8e,0x3,0x8,0x8c,0x8e,0x8e,0x56,0x65,0xae,0x84,0x72, + 0xb8,0x46,0x70,0x1,0xa0,0xb3,0xb3,0xf3,0xb9,0x4c,0x26,0x13,0x0,0xd0,0x9,0xd8, + 0xbb,0x14,0x8f,0xdc,0xfe,0x43,0x8,0x29,0x58,0x35,0xa2,0xb7,0xae,0xe,0xe3,0x5e, + 0x2f,0x2e,0x63,0xcd,0xb,0xc,0x86,0x61,0xe,0x35,0x34,0xe0,0x73,0xe7,0x9e,0x8b, + 0x88,0x42,0x6c,0x81,0xec,0x33,0x77,0xec,0xd8,0x31,0x4c,0x4e,0x4e,0xe6,0xfe,0xd6, + 0x8b,0x49,0x61,0x16,0x29,0xa5,0xef,0x8e,0x46,0xa3,0xba,0xe7,0xe3,0xb6,0x1b,0x57, + 0x9,0xee,0xd0,0xd0,0x90,0xd4,0xd1,0xd1,0xf1,0x14,0xa5,0xf4,0x7d,0x94,0xd2,0x6, + 0xbd,0xfb,0x55,0xda,0x91,0xa6,0xb5,0x4c,0xcf,0xc1,0xda,0x5a,0xc,0xfa,0xfd,0xb8, + 0x82,0x45,0x2f,0x30,0x18,0xba,0x39,0xd0,0xd8,0x88,0x2f,0x6d,0xd8,0x80,0xd8,0xf4, + 0x24,0xe2,0x4a,0xb1,0x3d,0x7e,0xfc,0x78,0x6e,0xf6,0xaf,0x2a,0x45,0x25,0xdd,0x1d, + 0x8d,0x46,0x7f,0xa2,0x7b,0xe7,0x2a,0xe0,0x2a,0xc1,0x5,0x80,0xb1,0xb1,0xb1,0xa9, + 0xb6,0xb6,0xb6,0x1d,0x0,0x6e,0x83,0xe,0xfb,0xac,0xa8,0x38,0x49,0x92,0x34,0x45, + 0xf7,0x48,0x4d,0xd,0xe,0xd5,0xd4,0x60,0xf3,0xc4,0x84,0xfb,0x2e,0x14,0x83,0xe1, + 0x32,0xf6,0x36,0x37,0xe3,0xee,0xf5,0xeb,0x91,0xd4,0x10,0xdb,0x93,0x27,0x4f,0xe6, + 0x96,0xc8,0xa9,0x92,0xd8,0x3e,0x11,0x89,0x44,0x3e,0xa,0x14,0x84,0xfd,0x3a,0x8a, + 0x2b,0x75,0x64,0x7c,0x7c,0xfc,0x78,0x5b,0x5b,0x5b,0x1c,0xc0,0xb5,0xa5,0xf2,0x59, + 0x59,0x71,0xc5,0x44,0x77,0xb0,0xa6,0x6,0x7,0x6b,0x6b,0x11,0x98,0x9c,0x84,0x87, + 0x4d,0x60,0xce,0x60,0x68,0xb2,0xb3,0xad,0xd,0xff,0xba,0x6e,0x1d,0xd2,0x1e,0x4f, + 0x5e,0xdf,0x88,0xdc,0x8c,0x10,0x89,0x44,0xaa,0xd1,0x5e,0x2b,0xf3,0x36,0xa5,0x74, + 0xab,0x5d,0x2b,0xef,0x56,0x82,0x2b,0x5,0x17,0x0,0xc6,0xc7,0xc7,0xb7,0xb7,0xb6, + 0xb6,0x9e,0x45,0x8,0x39,0x5b,0xfd,0x9b,0x9d,0x1d,0x69,0x40,0xe1,0xe0,0x88,0x41, + 0xbf,0x1f,0x6f,0xd4,0xd6,0xe2,0x8a,0x89,0x9,0xf8,0x98,0xe8,0x32,0x18,0x79,0xbc, + 0xd2,0xde,0x8e,0xef,0x9c,0x75,0x16,0x32,0x2a,0x87,0x45,0xee,0x20,0x9b,0x9c,0x9c, + 0xac,0xa6,0xd8,0xc6,0x9,0x21,0xd7,0x44,0x22,0x91,0x1,0x43,0x7,0xac,0x12,0x6e, + 0x6f,0x9e,0xbc,0x1d,0x40,0xaf,0x72,0x83,0x9d,0x15,0x27,0x49,0x12,0x4,0x41,0xc8, + 0x75,0xa6,0x29,0x79,0x6d,0xde,0x3c,0x7c,0xf8,0xf4,0xd3,0x71,0xdc,0x5f,0x32,0x54, + 0x98,0xc1,0x98,0x33,0x50,0x0,0xf,0x77,0x76,0xe2,0x9b,0x6b,0xd7,0x22,0xad,0x12, + 0x5b,0x49,0x92,0x70,0xf4,0xe8,0x51,0xc3,0x62,0x5b,0xe1,0x90,0x5e,0x4a,0x8,0xb9, + 0x23,0x1c,0xe,0xf7,0x16,0xcb,0xef,0x34,0xae,0xef,0x84,0x5f,0xb7,0x6e,0xdd,0x42, + 0x51,0x14,0x77,0x0,0xe8,0xac,0x42,0xaf,0x26,0x80,0xac,0x67,0xcb,0xf3,0x3c,0x38, + 0x8d,0x89,0x6d,0xe6,0x8b,0x22,0xfe,0x75,0x60,0x0,0x1b,0xd8,0xca,0x11,0x8c,0x39, + 0x4c,0x86,0x10,0xdc,0xb7,0x7a,0x35,0xfe,0xd4,0xd1,0x51,0xe0,0x9c,0x8,0x82,0x80, + 0xfe,0xfe,0x7e,0x24,0x12,0x89,0x6a,0xb5,0xd7,0xca,0xdb,0xfe,0x39,0x1a,0x8d,0xfe, + 0x9b,0xee,0x42,0x1c,0xc0,0xf5,0x82,0xb,0x0,0xeb,0xd6,0xad,0x5b,0x2b,0x8,0xc2, + 0x2b,0x0,0x74,0xad,0x79,0x6e,0x55,0x25,0x7b,0xbd,0x5e,0x4d,0xd1,0xf5,0x3,0xf8, + 0x97,0xc1,0x41,0x6c,0x99,0xee,0x4,0x60,0x30,0xe6,0x12,0x31,0x9e,0xc7,0xd7,0xd7, + 0xad,0x43,0x6f,0x53,0x93,0xa6,0xd8,0xe,0xc,0xc,0x20,0x1e,0x8f,0x57,0x5b,0x6c, + 0xef,0x8b,0x46,0xa3,0x1f,0xd7,0x5d,0x88,0x43,0xb8,0xb6,0xd,0x57,0xc9,0xd8,0xd8, + 0xd8,0x58,0x7b,0x7b,0xfb,0xab,0x0,0xde,0x87,0x32,0x36,0x5b,0xdd,0x91,0x6,0x20, + 0x4f,0x74,0x9,0x21,0x10,0x9,0xc1,0x8b,0x8d,0x8d,0x68,0x12,0x45,0x9c,0x95,0x70, + 0x5d,0xbb,0x3c,0x83,0x61,0x1b,0x21,0xbf,0x1f,0x5f,0xdc,0xb0,0x1,0x7,0x1b,0x1b, + 0xb,0xc4,0x36,0x95,0x4a,0xe1,0xe8,0xd1,0xa3,0x48,0x18,0x7c,0x26,0x2c,0x78,0x66, + 0x1f,0x8f,0x46,0xa3,0x1f,0x84,0xcb,0x22,0x12,0xb4,0x98,0x11,0x82,0xb,0x0,0xe3, + 0xe3,0xe3,0xfd,0x6d,0x6d,0x6d,0x27,0x50,0xa5,0xe1,0xbf,0xca,0x7c,0x94,0x52,0xf0, + 0x3c,0x9f,0xdf,0x21,0x40,0x8,0xb6,0x37,0x34,0xe0,0xb8,0xdf,0x8f,0x4b,0xa7,0xa6, + 0xc0,0xb3,0xce,0x34,0xc6,0x2c,0x67,0x77,0x4b,0xb,0xbe,0xb0,0x61,0x3,0x46,0x6a, + 0x6b,0xb,0xc4,0x36,0x16,0x8b,0xe1,0xe8,0xd1,0xa3,0xc8,0x64,0x32,0xba,0xcb,0xb3, + 0xa8,0x3f,0x66,0xf,0xcf,0xf3,0x37,0xc4,0xe3,0xf1,0x19,0xb1,0x50,0xe1,0x8c,0x11, + 0x5c,0x0,0x8,0x6,0x83,0x7b,0xda,0xda,0xda,0xbc,0x0,0xba,0x94,0xdb,0xed,0xee, + 0x1,0xa5,0x94,0x42,0x92,0x24,0x78,0xa6,0x43,0x5e,0x94,0x1c,0xa9,0xa9,0xc1,0xff, + 0x36,0x36,0xe2,0xa2,0xa9,0x29,0x34,0xb2,0x25,0x7b,0x18,0xb3,0x10,0x9,0xc0,0x2f, + 0x56,0xad,0xc2,0xf,0xce,0x38,0x3,0x69,0x95,0xe3,0x1,0x0,0x91,0x48,0x4,0xc7, + 0x8f,0x1f,0xd7,0x5c,0x87,0xac,0x18,0x16,0x39,0x47,0xc7,0x79,0x9e,0xbf,0x72,0x7c, + 0x7c,0xbc,0x6a,0x8b,0x40,0x56,0xca,0x8c,0x12,0x5c,0x0,0x8,0x6,0x83,0xdb,0xda, + 0xda,0xda,0xd6,0x0,0x38,0x1b,0xa8,0xca,0xf0,0xc0,0x5c,0xba,0x98,0xe8,0x86,0x79, + 0x1e,0x4f,0xb5,0xb4,0xa0,0x33,0x9d,0x46,0x67,0x2a,0x65,0xe8,0x18,0xc,0x86,0x9b, + 0x89,0xf1,0x3c,0xbe,0xb9,0x76,0x2d,0x9e,0x5f,0xb8,0xb0,0xe0,0xbe,0x7,0x80,0x91, + 0x91,0x11,0xc,0xd,0xd,0xe5,0xcd,0x67,0x5b,0xe,0x8b,0x9e,0xd9,0x49,0x49,0x92, + 0xfe,0x22,0x1c,0xe,0x1f,0xd4,0x5d,0x98,0xb,0x98,0x71,0x82,0xb,0x80,0x6,0x83, + 0xc1,0xff,0x6e,0x6f,0x6f,0x3f,0x93,0x52,0x5a,0x10,0xa3,0x5b,0x74,0x27,0xb,0xbc, + 0x60,0x4a,0x29,0x44,0x51,0x2c,0x18,0x20,0x41,0x8,0x41,0x86,0xe3,0xf0,0x42,0x53, + 0x13,0xd2,0xdc,0xff,0xdf,0xde,0xd9,0x6,0x37,0x76,0x9d,0x75,0xfc,0x77,0xae,0xae, + 0x24,0xdb,0xeb,0xb5,0x77,0x1d,0xaf,0xed,0xb5,0x15,0x7b,0xfd,0xb2,0xde,0x21,0xce, + 0xb,0xb0,0x84,0x49,0xd3,0x17,0x3a,0x79,0x61,0x3,0x4d,0xa,0xa5,0xc9,0xb4,0x90, + 0x32,0x84,0x2d,0x4d,0xa0,0x7c,0x60,0x92,0x4e,0x69,0x68,0x12,0x86,0x81,0x32,0x53, + 0xe8,0x87,0xb6,0x81,0xf0,0xa1,0x69,0x29,0xa5,0x99,0x4e,0xc8,0xd2,0x24,0x4d,0x37, + 0x69,0x20,0x61,0x68,0x86,0x4d,0xc2,0x94,0x6e,0x2,0xed,0x24,0x1b,0x9a,0x84,0xd9, + 0xad,0xbd,0xf6,0xda,0xd6,0xdb,0x95,0x64,0x5b,0x6f,0xf7,0x3e,0x7c,0xb0,0xa5,0x68, + 0x65,0x59,0xbe,0xda,0x95,0xf5,0x7a,0x7e,0x33,0x1a,0xed,0x4a,0x8f,0x1e,0x3d,0xe3, + 0x7b,0xce,0x5f,0xe7,0x9e,0xf3,0x9c,0xe7,0x18,0xfc,0x7c,0x22,0xd1,0x1c,0xab,0x91, + 0x1a,0x4d,0x19,0xce,0xec,0xda,0xc5,0x3,0x57,0x5d,0x55,0x72,0xbe,0x56,0x44,0x58, + 0x58,0x58,0x60,0x79,0xb9,0xb2,0xf2,0xb2,0x55,0x14,0xdb,0x1b,0x63,0xb1,0xd8,0xf, + 0x2a,0xfa,0xf2,0x6,0xa0,0x19,0x5,0x17,0x40,0xc6,0xc6,0xc6,0x9e,0x4a,0xa5,0x52, + 0x57,0x29,0xa5,0xe,0x6d,0x6b,0x5c,0xe5,0x51,0xb0,0x6d,0xdb,0x25,0x8b,0xde,0x0, + 0xfc,0x78,0xd7,0x2e,0xde,0xec,0xec,0xe4,0x17,0x12,0x9,0x3a,0xf4,0x1,0x95,0x9a, + 0x26,0xe5,0x85,0x81,0x1,0x3e,0x7f,0xf9,0xe5,0x44,0x7c,0xbe,0x4d,0x6d,0x3c,0x9d, + 0x4e,0x73,0xfa,0xf4,0x69,0x2c,0xcb,0xaa,0xc8,0x67,0x95,0xfa,0xe1,0x8a,0x52,0xea, + 0x26,0xcb,0xb2,0x5c,0x1f,0x5a,0xd0,0x48,0x34,0xf5,0x40,0x6c,0x66,0x66,0xc6,0x97, + 0xc9,0x64,0x9e,0x0,0x7e,0x75,0x2b,0x9b,0x9d,0x4c,0x4d,0x31,0x4d,0x13,0x5f,0x89, + 0x6,0x9,0xd0,0x9b,0xcd,0xf2,0x99,0xb9,0x39,0xde,0xb3,0x51,0xac,0x43,0xa3,0x69, + 0x6,0xe2,0x5e,0x2f,0x7f,0x3b,0x3d,0xcd,0x7f,0xf6,0xf7,0x97,0x6c,0xd7,0x89,0x44, + 0x82,0xd9,0xd9,0xd9,0x7a,0x2c,0x8e,0x21,0x22,0x49,0xe0,0x16,0xcb,0xb2,0x9e,0xaf, + 0xc8,0x61,0x3,0xd1,0xd4,0x82,0xb,0x10,0x8,0x4,0x3a,0x3b,0x3b,0x3b,0x9f,0x51, + 0x4a,0xbd,0xbf,0xf8,0xbd,0x5a,0xe4,0x1,0x1a,0x86,0x41,0x47,0x47,0x47,0xc9,0xc6, + 0xa9,0x94,0xe2,0x48,0x24,0xc2,0xdd,0x73,0x73,0x74,0xea,0xd1,0xae,0xa6,0xc1,0x39, + 0xd9,0xd7,0xc7,0x83,0x87,0xe,0x11,0x2d,0x31,0x88,0x10,0x11,0x96,0x96,0x96,0x58, + 0x5e,0x5e,0xae,0xc7,0x7c,0x2d,0x40,0x6,0xb8,0x35,0x1a,0x8d,0x3e,0xe5,0xda,0x61, + 0x3,0xd2,0xf4,0x82,0xb,0x70,0xe5,0x95,0x57,0xee,0x4a,0x26,0x93,0xdf,0x3,0xde, + 0xb,0x35,0x29,0x6a,0x7c,0x1e,0x4a,0x29,0xfc,0x7e,0x3f,0x9e,0xa2,0x63,0x44,0x72, + 0x8c,0xa6,0x52,0xdc,0x7f,0xe6,0xc,0x87,0x74,0xce,0xae,0xa6,0x1,0xc9,0x18,0x6, + 0xdf,0x98,0x98,0xe0,0xf8,0xc8,0x8,0xc2,0xe6,0x33,0xff,0x1c,0xc7,0xe1,0xec,0xd9, + 0xb3,0x15,0x17,0xa0,0xa9,0xa2,0x6d,0x16,0xf8,0x48,0x34,0x1a,0x7d,0xdc,0xb5,0xc3, + 0x6,0xa5,0x25,0x4,0x17,0x60,0x7a,0x7a,0xba,0x1f,0x78,0x4e,0x44,0x7e,0xd6,0xed, + 0x67,0xaa,0x2d,0xcc,0x5e,0xaf,0x77,0xcb,0x29,0x6,0xbf,0x8,0x47,0x17,0x16,0xb8, + 0x2d,0x18,0xd4,0x55,0xc7,0x34,0xd,0xc3,0xec,0xae,0x5d,0x3c,0x38,0x3d,0xcd,0x4f, + 0x4a,0x2c,0x8c,0xc1,0x3b,0x47,0x98,0xa7,0x2a,0xcc,0xbe,0xa9,0xa2,0xd8,0x3a,0x22, + 0x72,0x97,0x65,0x59,0x5f,0xad,0x28,0x80,0x6,0xa5,0x65,0x4,0x17,0x60,0x66,0x66, + 0xa6,0x3b,0x95,0x4a,0x7d,0x47,0x29,0x75,0xdd,0x76,0xb6,0x3b,0xf5,0x4b,0x9d,0x9b, + 0x62,0x28,0xb5,0x25,0x18,0x60,0x3c,0x99,0xe4,0xd3,0xb3,0xb3,0xcc,0xe8,0x5a,0xc, + 0x9a,0x3a,0x92,0xf2,0x78,0xf8,0xe6,0xf8,0x38,0xcf,0xc,0xf,0x63,0x97,0x38,0xdf, + 0x4f,0x44,0x58,0x5c,0x5c,0x24,0x18,0xc,0xee,0xd8,0x14,0x82,0xb,0xfb,0x8c,0x88, + 0xdc,0x6e,0x59,0xd6,0xb1,0x8a,0x9c,0x36,0x30,0x2d,0x25,0xb8,0x0,0xc3,0xc3,0xc3, + 0x5d,0xbb,0x76,0xed,0x7a,0x12,0xb8,0x71,0x2b,0x9b,0x5a,0xdc,0x16,0x75,0x74,0x74, + 0xe0,0x2d,0x38,0x3c,0x2f,0x87,0x52,0xa,0x3,0xf8,0x40,0x28,0xc4,0x1f,0x9c,0x3d, + 0x4b,0x97,0x9e,0xdb,0xd5,0xd4,0x98,0xff,0xd9,0xbb,0x97,0xbf,0x9b,0x9e,0xe6,0x5c, + 0x47,0x7,0xb0,0x79,0xa,0x21,0x9d,0x4e,0x33,0x3b,0x3b,0x5b,0xf3,0x7a,0x8,0x45, + 0xac,0x29,0xa5,0x6e,0x8d,0x44,0x22,0xcf,0xb8,0x76,0xda,0x4,0xb4,0x9c,0xe0,0x2, + 0x4c,0x4d,0x4d,0xf9,0x81,0x47,0x95,0x52,0xbf,0x5e,0xfc,0x5e,0x2d,0x1b,0x90,0x69, + 0x9a,0xf8,0xfd,0xfe,0xfc,0x68,0xb7,0xb8,0x61,0xf,0xa5,0xd3,0xdc,0x33,0x3b,0xcb, + 0x2f,0x6e,0x9c,0xf1,0xa4,0xd1,0xec,0x24,0x71,0xaf,0x97,0xaf,0x4d,0x4e,0xf2,0xfd, + 0xc1,0xc1,0x7c,0xd1,0x81,0xe2,0x36,0x19,0xe,0x87,0x39,0x77,0xee,0x1c,0xb6,0x6d, + 0xd7,0x53,0x6c,0xe3,0xc0,0x2d,0xd1,0x68,0xf4,0x5,0xd7,0x4e,0x9b,0x84,0x96,0x14, + 0x5c,0x80,0xc3,0x87,0xf,0x7b,0x63,0xb1,0xd8,0xb7,0x80,0x5b,0xa1,0xf6,0xb,0x69, + 0x39,0x94,0x52,0x5b,0x8e,0x76,0x61,0xfd,0x2,0xdc,0x14,0xe,0xf3,0x89,0x85,0x5, + 0xfa,0x2a,0x48,0xb5,0xd1,0x68,0xdc,0x22,0xc0,0x89,0x7d,0xfb,0xf8,0x87,0xc9,0x49, + 0x82,0x1b,0xf5,0x9c,0x8b,0x85,0xd6,0xb6,0xed,0xfc,0x31,0x38,0xf5,0xea,0x2b,0x1b, + 0x58,0x4a,0xa9,0x9b,0x23,0x91,0xc8,0x89,0x8a,0x82,0x68,0x12,0x5a,0x56,0x70,0x37, + 0xf0,0x1c,0x3c,0x78,0xf0,0xab,0x22,0x72,0x47,0x25,0x1f,0xda,0x89,0x5f,0x76,0xd3, + 0x34,0xcb,0xce,0xed,0xfa,0x1d,0x87,0xf,0x7,0x83,0xfc,0xf6,0xb9,0x73,0x3a,0x85, + 0x4c,0x53,0x35,0x4e,0xf5,0xf6,0xf2,0xf0,0xe4,0x24,0x6f,0xef,0x7e,0xe7,0x4c,0xd6, + 0xe2,0x53,0x19,0x42,0xa1,0x10,0x4b,0x4b,0x4b,0x3b,0x3a,0xaa,0x75,0x69,0x1f,0x14, + 0x91,0x23,0x8d,0x74,0xca,0x6e,0xb5,0x69,0x75,0xc1,0x5,0xf0,0x4c,0x4e,0x4e,0x3e, + 0xa4,0x94,0xba,0x6b,0x3b,0xc3,0x9d,0xfe,0x65,0xcf,0xa5,0x8f,0x95,0xca,0x64,0xc8, + 0xfd,0x7f,0x5f,0x26,0xc3,0xef,0xcd,0xcf,0x73,0x63,0x38,0xdc,0x16,0x17,0x47,0xb3, + 0x33,0x2c,0x77,0x74,0xf0,0xf5,0x89,0x9,0x5e,0xda,0xb7,0xef,0xbc,0x9a,0x85,0x85, + 0xed,0x2e,0x99,0x4c,0x32,0x3f,0x3f,0xcf,0xca,0xca,0xa,0x50,0xbb,0xba,0x24,0x5b, + 0x30,0xf,0xdc,0x1c,0x8d,0x46,0x5f,0xad,0xc8,0x71,0x93,0xd1,0x36,0x7d,0x7a,0x72, + 0x72,0xf2,0x4e,0xa5,0xd4,0x43,0x80,0x59,0xea,0xfd,0x5a,0x36,0x36,0x8f,0xc7,0x43, + 0x67,0x67,0x67,0xc9,0x42,0x38,0x39,0xae,0x8e,0xc7,0xf9,0xe4,0xdc,0x1c,0x7,0x92, + 0x4d,0x51,0x75,0x4e,0xd3,0x20,0x64,0x94,0xe2,0x99,0x91,0x11,0x1e,0x1d,0x1b,0x63, + 0xd5,0x7c,0xa7,0xa9,0x17,0x8f,0x6a,0x73,0x19,0x8,0xb9,0xb6,0x59,0xc7,0xf9,0x5a, + 0x80,0x1f,0x9a,0xa6,0xf9,0xc1,0x60,0x30,0xb8,0xe0,0xda,0x71,0x93,0xd2,0x36,0x82, + 0xb,0x30,0x35,0x35,0x75,0x4,0x78,0xc,0xe8,0x29,0x7c,0xbd,0x5e,0x8d,0xcd,0xef, + 0xf7,0x6f,0xb9,0x4b,0xd,0xd6,0x2f,0xce,0x35,0x96,0xc5,0xd1,0x73,0xe7,0x98,0xd2, + 0x69,0x64,0x9a,0x32,0xa4,0xd,0x83,0xef,0x8e,0x8c,0xf0,0x9d,0x4b,0x2f,0xc5,0x2a, + 0x5a,0x2f,0x28,0x6c,0x5f,0x89,0x44,0x82,0x85,0x85,0x5,0x92,0x5,0x3f,0xe4,0x75, + 0x16,0xdb,0xa7,0xfc,0x7e,0xff,0x6f,0x2d,0x2e,0x2e,0xae,0xb8,0x76,0xdc,0xc4,0xb4, + 0x95,0xe0,0x2,0x8c,0x8f,0x8f,0x5f,0xe9,0xf1,0x78,0x9e,0x6,0x2,0x50,0xf7,0xc6, + 0x96,0x5f,0x54,0xdb,0x6a,0xc3,0x44,0x2e,0x8d,0xec,0xbd,0x91,0x8,0x47,0x17,0x16, + 0xb8,0x54,0x8f,0x78,0x35,0x5,0x64,0xc,0x83,0x67,0xf7,0xef,0xe7,0x89,0x4b,0x2f, + 0x25,0x54,0xe2,0x80,0xd3,0x5c,0x9b,0x4a,0x26,0x93,0x2c,0x2c,0x2c,0x90,0x48,0x24, + 0xf2,0xef,0xd5,0x79,0x71,0xc,0xe0,0xc1,0x68,0x34,0x7a,0xf,0xd0,0x36,0x85,0xa4, + 0xdb,0x4e,0x70,0x1,0xa6,0xa7,0xa7,0x47,0xb2,0xd9,0xec,0x71,0xa5,0xd4,0x8e,0xec, + 0x4a,0xbb,0x10,0xdb,0xdc,0x34,0x43,0x61,0x36,0x43,0xb1,0x0,0xe7,0x84,0xf7,0xe3, + 0xf3,0xf3,0x4,0x74,0xdd,0xdd,0xb6,0xc6,0x56,0x8a,0xe7,0x87,0x86,0x38,0x36,0x36, + 0xc6,0xf2,0x16,0x27,0x49,0x2b,0xa5,0xb0,0x6d,0x9b,0xa5,0xa5,0x25,0x42,0xa1,0xd0, + 0xa6,0xfa,0xce,0x6e,0xd9,0x1,0x61,0xb6,0x81,0x4f,0x45,0xa3,0xd1,0x2f,0x57,0xe4, + 0xb8,0x5,0x68,0x4b,0xc1,0x5,0x8,0x4,0x2,0x7d,0x7e,0xbf,0xff,0x71,0xe0,0x97, + 0xca,0xd9,0xd5,0x7a,0x14,0xe0,0xf3,0xf9,0xf2,0xf3,0xbb,0x5b,0xe1,0x13,0xe1,0x86, + 0x70,0x98,0xdb,0x16,0x17,0x19,0xd3,0x23,0xde,0xb6,0x22,0x63,0x18,0x7c,0x7f,0x70, + 0x90,0x27,0x3,0x1,0xe6,0xba,0xba,0x4a,0xda,0xe4,0x7e,0xa8,0x2d,0xcb,0x62,0x61, + 0x61,0x61,0x53,0x65,0xaf,0x3a,0xdf,0xd5,0xad,0x89,0xc8,0xef,0x5a,0x96,0xf5,0x4f, + 0xae,0x1d,0xb7,0x10,0x6d,0x2b,0xb8,0x1b,0x78,0xa6,0xa6,0xa6,0x1e,0x10,0x91,0x7, + 0x58,0x1f,0x40,0x9e,0x47,0x3d,0x6f,0xb9,0xdc,0x8,0xaf,0x52,0x8a,0xcb,0x13,0x9, + 0x3e,0x7a,0xee,0x1c,0xd7,0x58,0x56,0xdb,0x5f,0xcc,0x56,0x26,0xec,0xf3,0xf1,0xf8, + 0xe8,0x28,0xff,0x36,0x38,0x78,0xde,0x62,0x58,0x29,0x2c,0xcb,0x62,0x69,0x69,0xa9, + 0x64,0xfd,0x83,0x7a,0x8a,0xad,0x88,0x9c,0x72,0x1c,0xe7,0x43,0xf1,0x78,0xbc,0xa9, + 0x4e,0x69,0xa8,0x26,0xba,0x8f,0x2,0x53,0x53,0x53,0xb7,0x88,0xc8,0x37,0x81,0xde, + 0xdc,0x6b,0x75,0xbe,0xe5,0xca,0xe3,0xf7,0xfb,0xe9,0xec,0xec,0xdc,0x74,0x72,0x70, + 0x31,0x13,0x6b,0x6b,0xfc,0xda,0xd2,0x12,0xbf,0x1c,0xe,0xe3,0xd3,0x79,0xbc,0x2d, + 0xc3,0x6c,0x57,0x17,0xdf,0x1e,0x1d,0xe5,0xc4,0xc0,0x0,0x99,0x2d,0x16,0x57,0x61, + 0xbd,0x4d,0xc5,0x62,0xb1,0xaa,0x8,0x6d,0xa5,0xf6,0x2e,0x6d,0x1f,0x37,0x4d,0xf3, + 0x8e,0x60,0x30,0xd8,0xd6,0xdb,0x2a,0xb5,0xe0,0x6e,0x30,0x31,0x31,0x31,0xad,0x94, + 0x7a,0x2,0xb8,0xac,0xde,0xb,0x69,0xa5,0xec,0x3b,0x3a,0x3a,0xb6,0x1d,0xf1,0xc2, + 0xfa,0x76,0xe1,0x23,0xc1,0x20,0x37,0x85,0x42,0xc,0xa4,0xd3,0x15,0x7d,0x9f,0xa6, + 0x31,0xb0,0x95,0xe2,0x64,0x5f,0x1f,0xcf,0xed,0xdf,0xcf,0xc9,0xbe,0x3e,0xec,0x32, + 0x42,0xb,0xeb,0x87,0x38,0x6,0x83,0xc1,0xf3,0x32,0xf,0xa,0xa9,0xf3,0xe0,0xc1, + 0x11,0x91,0xcf,0x5a,0x96,0xf5,0xd7,0xd0,0xf8,0xc7,0x98,0xef,0x34,0x5a,0x70,0xb, + 0x38,0x74,0xe8,0xd0,0xee,0x4c,0x26,0xf3,0x75,0xe0,0xc3,0x6e,0xec,0x6b,0x2d,0xcc, + 0xb9,0x8c,0x86,0xe2,0x11,0x6f,0x29,0x3b,0x80,0xe9,0xd5,0x55,0x3e,0xb0,0xbc,0xcc, + 0x75,0xa1,0x90,0xde,0xbd,0xd6,0x4,0xbc,0xdd,0xdd,0xcd,0xb3,0xfb,0xf7,0x73,0x62, + 0xdf,0x3e,0x56,0xb7,0xd8,0xa,0x9e,0x23,0x37,0xa2,0xd,0x6,0x83,0xac,0x95,0xa9, + 0xb3,0x5c,0x67,0xb1,0x8d,0x28,0xa5,0x6e,0x8f,0x44,0x22,0xdf,0xab,0xc8,0x71,0xb, + 0xa3,0x5,0x77,0x33,0xc6,0xe4,0xe4,0xe4,0x9f,0x8b,0xc8,0x67,0x29,0xf3,0xf7,0xa9, + 0xf7,0x28,0xd8,0xe7,0xf3,0xe5,0xd3,0xc9,0xa,0x29,0x35,0xdd,0xd0,0x93,0xcd,0x72, + 0x7d,0x28,0xc4,0x91,0x50,0x48,0xe7,0xf3,0x36,0x18,0xab,0xa6,0xc9,0xcb,0xfd,0xfd, + 0xfc,0xeb,0xe0,0x20,0xa7,0x7a,0xd7,0x67,0xb4,0xb6,0xca,0xcb,0x86,0xf5,0x9a,0x7, + 0xa1,0x50,0x88,0x70,0x38,0x4c,0x36,0x9b,0x2d,0xeb,0xbb,0xce,0xf3,0xb5,0x6f,0x98, + 0xa6,0xf9,0x1b,0xa1,0x50,0xe8,0x94,0x6b,0xc7,0x6d,0x80,0x16,0xdc,0x2d,0x98,0x9a, + 0x9a,0x7a,0x97,0x6d,0xdb,0x8f,0x28,0xa5,0x26,0xa,0x5f,0x6f,0x80,0xb9,0xb0,0xf3, + 0x6c,0x4d,0xd3,0xa4,0xb3,0xb3,0xb3,0xec,0x6,0x8a,0x42,0xfa,0xd3,0x69,0xde,0x17, + 0x8d,0xf2,0xbe,0x70,0x98,0x19,0x7d,0xba,0x70,0x5d,0x88,0x7a,0xbd,0xfc,0xc7,0xc0, + 0x0,0x27,0xfa,0xfb,0xf9,0xdf,0x9e,0x1e,0x9c,0x8d,0xeb,0x56,0xee,0xfa,0xa5,0xd3, + 0x69,0x96,0x97,0x97,0xb1,0x2c,0xcb,0x55,0x7d,0xda,0x3a,0x8a,0xad,0x0,0x7f,0xb3, + 0x67,0xcf,0x9e,0xcf,0x9c,0x3e,0x7d,0x5a,0xa7,0xd0,0x14,0xa1,0xfb,0x5b,0x19,0xa6, + 0xa6,0xa6,0x7a,0x1c,0xc7,0x79,0x8,0xf8,0x18,0xd4,0xfd,0xf6,0xac,0xac,0x6d,0x2e, + 0x8f,0xb7,0x5c,0x81,0x9c,0xe2,0xe,0x3d,0x90,0x4e,0xf3,0xee,0x48,0x44,0x8b,0x6f, + 0xd,0x88,0x79,0xbd,0xbc,0x50,0x42,0x64,0x73,0x6c,0x25,0xb6,0x2b,0x2b,0x2b,0x84, + 0xc3,0x61,0x62,0xb1,0x98,0xdb,0x91,0x65,0x45,0x71,0x55,0xb9,0x4d,0x2f,0x88,0xc8, + 0xef,0x58,0x96,0xf5,0x5c,0x45,0x41,0xb4,0x11,0xba,0x8f,0xb9,0x60,0x7c,0x7c,0xfc, + 0x36,0xe0,0x2b,0xc0,0x1e,0x37,0xf6,0xf5,0x1e,0x5,0xe7,0x52,0xca,0xa,0x77,0xaf, + 0x6d,0x37,0xfa,0xd,0x24,0x93,0x5c,0x6d,0x59,0x5c,0x6d,0x59,0x5c,0x15,0x8f,0xeb, + 0x4c,0x87,0x2a,0x30,0xdf,0xd9,0xc9,0x2b,0x7d,0x7d,0x9c,0xdc,0xbb,0x97,0x1f,0xef, + 0xd9,0x43,0xda,0xe5,0xf,0x61,0x26,0x93,0x21,0x1c,0xe,0x63,0x59,0x16,0xe9,0xa, + 0x16,0x3e,0xeb,0x3c,0x20,0x38,0x9e,0xcd,0x66,0x8f,0x26,0x12,0x89,0xe5,0x8a,0x1c, + 0xb7,0x19,0x5a,0x70,0x5d,0x32,0x3e,0x3e,0x3e,0x6,0x3c,0x2,0xbc,0xa7,0x9c,0x5d, + 0x23,0x8d,0x82,0x73,0xa3,0xde,0xae,0xae,0xae,0xb2,0x8b,0x6c,0x39,0x72,0x1d,0xdf, + 0x10,0x61,0x72,0x75,0x95,0x6b,0xa2,0x51,0xae,0x89,0x46,0x99,0x5a,0x59,0xd1,0xd, + 0xc5,0x5,0x9,0xd3,0xe4,0x7,0x7d,0x7d,0xfc,0xd7,0x25,0x97,0xf0,0xda,0x9e,0x3d, + 0x44,0xb7,0x59,0xf8,0x82,0xcd,0x75,0xe,0x22,0x91,0x8,0xf1,0x78,0x1c,0x11,0xa9, + 0xfb,0x3a,0x81,0x4b,0xdb,0x55,0x11,0xb9,0xdb,0xb2,0xac,0x87,0xd1,0x59,0x8,0xdb, + 0xa2,0xfb,0x51,0x5,0xcc,0xcc,0xcc,0xf8,0xd6,0xd6,0xd6,0xfe,0x42,0x44,0x3e,0x5, + 0x6c,0xca,0xcf,0x6a,0x84,0xe,0xb2,0x95,0xbd,0xd7,0xeb,0x2d,0x3b,0xe5,0x50,0x6e, + 0x4,0x3c,0x90,0x4e,0x73,0x79,0x3c,0xce,0x65,0x89,0x4,0x97,0xc7,0xe3,0x1c,0x58, + 0x5b,0xc3,0xa8,0x30,0xa6,0x56,0x24,0xe6,0xf5,0xf2,0x46,0x4f,0xf,0xaf,0xf7,0xf4, + 0x70,0xaa,0xa7,0x87,0x37,0xbb,0xbb,0xc9,0x6e,0x93,0xb6,0x97,0x43,0x29,0x85,0x88, + 0x90,0x48,0x24,0x88,0xc5,0x62,0xc4,0xe3,0x71,0x6c,0x7b,0xbd,0xa4,0x40,0xbd,0xef, + 0x90,0xdc,0xda,0x8a,0xc8,0x29,0xe0,0x63,0xad,0x5c,0xbf,0xb6,0xda,0x68,0xc1,0xbd, + 0x0,0x26,0x26,0x26,0xae,0x10,0x91,0xaf,0x0,0xd7,0xe4,0x5e,0x6b,0x4,0xb1,0x75, + 0x63,0xab,0x94,0x3a,0x6f,0xa1,0xcd,0x30,0xc,0x57,0x8b,0x6d,0xb9,0xcf,0x2,0x74, + 0xd9,0x36,0x97,0x25,0x12,0x5c,0x16,0x8f,0xf3,0x33,0x89,0x4,0x93,0xab,0xab,0xf4, + 0xb6,0xf8,0x69,0x15,0x59,0xa5,0x98,0xeb,0xea,0xe2,0xed,0xee,0x6e,0x5e,0xeb,0xe9, + 0xe1,0x8d,0x9e,0x1e,0xe6,0xba,0xba,0xb6,0xac,0x35,0x5b,0x8e,0xb5,0xb5,0x35,0x2c, + 0xcb,0x22,0x1e,0x8f,0xd7,0x6c,0xdb,0x6d,0x95,0x7d,0xaf,0x0,0xf7,0x45,0xa3,0xd1, + 0x87,0x58,0x3f,0xc2,0x5c,0xe3,0x12,0x2d,0xb8,0x17,0x8e,0x1a,0x1f,0x1f,0xff,0x84, + 0x88,0x7c,0x81,0xa2,0x72,0x8f,0xe5,0x68,0x24,0x61,0x36,0xc,0x23,0x5f,0x22,0xd2, + 0xe7,0xf3,0x6d,0xbb,0x8d,0xb8,0x1c,0xbb,0x6c,0x9b,0x3,0xab,0xab,0x1c,0x48,0x26, + 0x19,0x5d,0x5d,0xe5,0xe0,0xca,0xa,0x93,0x2b,0x2b,0x74,0x34,0xd9,0x5c,0xb0,0xb0, + 0xbe,0xbb,0xeb,0xa7,0x1b,0x8f,0xb7,0x77,0xef,0xe6,0xad,0xee,0x6e,0xc2,0x45,0xe9, + 0x77,0x85,0x6c,0xf7,0xb7,0x11,0x11,0xd6,0xd6,0xd6,0x58,0x59,0x59,0x21,0x1e,0x8f, + 0xd7,0x7c,0x83,0x42,0x35,0x85,0x59,0x29,0xf5,0x2f,0x8e,0xe3,0x7c,0xd2,0xb2,0xac, + 0xff,0xab,0xc8,0xa9,0x6,0xd0,0x82,0x7b,0xd1,0x8c,0x8d,0x8d,0xed,0x7,0x1e,0x54, + 0x4a,0xdd,0x5a,0xce,0xae,0x19,0x6e,0x13,0x3d,0x1e,0x4f,0x5e,0x7c,0x73,0x69,0x66, + 0x6e,0x47,0x6d,0xb0,0x59,0x78,0xbc,0x22,0xc,0xa4,0x52,0xc,0xa6,0x52,0xf9,0xe7, + 0xdc,0x63,0x7f,0x2a,0xc5,0xde,0x74,0xba,0x2e,0xd,0x30,0x65,0x18,0x2c,0x76,0x74, + 0xac,0x3f,0xfc,0x7e,0x96,0x8a,0x9e,0x63,0x5e,0x6f,0xc5,0xa3,0xfe,0x62,0x92,0xc9, + 0x24,0x89,0x44,0x82,0xd5,0xd5,0x55,0x56,0x56,0x56,0xdc,0xdc,0x9e,0xbb,0x8e,0xbf, + 0x4e,0x62,0xbb,0x2c,0x22,0x7f,0xd8,0x4a,0x47,0x96,0xd7,0x3,0x2d,0xb8,0x55,0x62, + 0x7c,0x7c,0xfc,0x16,0x11,0x79,0x8,0xb8,0xb4,0xf8,0xbd,0x26,0xb9,0x4d,0xdc,0x84, + 0xdf,0xef,0xcf,0x3f,0x8a,0x37,0x58,0x14,0x72,0xa1,0xa2,0x6c,0x0,0x3d,0x99,0xc, + 0x3d,0xd9,0x2c,0xbb,0x33,0x19,0x7a,0xb3,0x59,0x7a,0x33,0x19,0xf6,0x64,0xb3,0xf4, + 0x64,0x32,0xf8,0x37,0x46,0xc7,0x5d,0xb6,0x8d,0x21,0x82,0x29,0x42,0x87,0x7d,0x7e, + 0xe9,0x54,0xc7,0x30,0x58,0xdb,0x18,0x99,0x27,0xd,0x83,0xac,0x61,0xe0,0xb0,0x3e, + 0xbf,0x1a,0x33,0x4d,0xe2,0x5e,0x2f,0x96,0x69,0x12,0xf3,0xf9,0xb0,0xbc,0x5e,0x62, + 0x5e,0x2f,0xa9,0x6d,0x16,0x10,0x2f,0x44,0x6c,0xb3,0xd9,0x2c,0xab,0xab,0xab,0xac, + 0xad,0xad,0x11,0x8f,0xc7,0x5d,0x67,0x17,0x34,0xca,0xf5,0x2e,0x63,0x2b,0x4a,0xa9, + 0x87,0x1d,0xc7,0xb9,0xd7,0xb2,0xac,0x88,0x6b,0x87,0x9a,0x92,0x68,0xc1,0xad,0x22, + 0x81,0x40,0xa0,0xcf,0x34,0xcd,0xcf,0x1,0x77,0xb2,0xb1,0xa8,0xd6,0x8c,0x62,0x5b, + 0xca,0x56,0x29,0x85,0xd7,0xeb,0xc5,0xe7,0xf3,0xe5,0x5,0xb8,0xdc,0x11,0x41,0xa5, + 0x3e,0xef,0x96,0x6a,0xfb,0xac,0xb6,0x9d,0x88,0x90,0x4a,0xa5,0xf2,0x2,0xbb,0xb6, + 0xb6,0x96,0xdf,0xf5,0xd5,0x2a,0xd7,0x7b,0xe3,0xf5,0x37,0xc,0xc3,0xb8,0x47,0x6f, + 0xcd,0xad,0x1e,0x5a,0x70,0x77,0x80,0x89,0x89,0x89,0x83,0x8e,0xe3,0xfc,0xa5,0x88, + 0xdc,0xe6,0xf6,0x33,0xcd,0xd6,0x51,0x95,0x52,0x78,0x3c,0x1e,0x7c,0x3e,0x1f,0x5e, + 0xaf,0x37,0x2f,0xc6,0xa5,0xe6,0x81,0x9b,0x59,0x94,0x73,0xe2,0x5a,0xf8,0x48,0x26, + 0x93,0xf9,0x8c,0x82,0x62,0x5b,0xb7,0x34,0xf8,0xf5,0x5e,0x4,0xfe,0x38,0x1a,0x8d, + 0x3e,0x2,0x34,0xd7,0x24,0x7c,0x83,0xa3,0x5,0x77,0x7,0x19,0x1d,0x1d,0xbd,0xde, + 0x30,0x8c,0x2f,0x8a,0xc8,0x15,0xe5,0xec,0x5a,0xa8,0xa3,0x62,0x18,0x46,0x5e,0x84, + 0x4d,0xd3,0xcc,0x3f,0x9b,0xa6,0x59,0x56,0xfc,0xea,0x2d,0xca,0xd9,0x6c,0x96,0x4c, + 0x26,0x93,0x7f,0x24,0x93,0x49,0x52,0xa9,0x14,0x99,0x4c,0xa6,0xea,0x3b,0xbc,0x1a, + 0xc1,0x76,0xb,0xfb,0x94,0x52,0xea,0x4b,0x22,0xf2,0xf9,0x68,0x34,0x1a,0xad,0xc8, + 0x99,0xc6,0x14,0xaa,0x8e,0x83,0x0,0x0,0x4,0x12,0x49,0x44,0x41,0x54,0x15,0x5a, + 0x70,0x77,0x1e,0x73,0x74,0x74,0xf4,0xa8,0x52,0xea,0x73,0xc0,0xbe,0xe2,0x37,0x1b, + 0xa1,0xf3,0xd5,0x4a,0x98,0x4d,0xd3,0xc4,0xe3,0xf1,0xe4,0x85,0xd8,0x30,0xc,0x3c, + 0x1e,0x4f,0xfe,0x61,0x18,0x46,0xfe,0x51,0x8a,0x4a,0x45,0x59,0x44,0x70,0x1c,0x7, + 0xdb,0xb6,0xf3,0xf,0xc7,0x71,0xc8,0x66,0xb3,0x9b,0x4,0xb6,0x30,0xce,0x46,0xfc, + 0xdb,0xed,0xb4,0xad,0x52,0xea,0x98,0x6d,0xdb,0xf7,0xc5,0x62,0xb1,0x37,0x5d,0x3b, + 0xd2,0x54,0x8c,0x16,0xdc,0x1a,0x71,0xe0,0xc0,0x81,0x21,0xc7,0x71,0xfe,0x4c,0x29, + 0x75,0x14,0xf0,0xb6,0x4a,0x47,0xdd,0x9,0xdf,0x4a,0xa9,0xf3,0x84,0x37,0xf7,0x9c, + 0x7b,0xbd,0x58,0x1c,0x73,0xc5,0x5c,0xa,0x77,0x67,0xe5,0xc4,0xf5,0x62,0xe2,0xa8, + 0x97,0x6d,0x8d,0xe3,0x78,0x1d,0xb8,0x3f,0x1a,0x8d,0x3e,0xe1,0xda,0x89,0xe6,0x82, + 0xd1,0x82,0x5b,0x63,0x46,0x46,0x46,0x2,0x1e,0x8f,0xe7,0xd3,0xc0,0x5d,0x40,0xe9, + 0xd3,0xff,0xa,0x68,0xe0,0x8e,0x5a,0x15,0x5b,0x1d,0xc7,0x85,0xdb,0x5e,0xa4,0xef, + 0xff,0x56,0x4a,0xfd,0x69,0x24,0x12,0x39,0x8e,0xde,0x92,0x5b,0x33,0xb4,0xe0,0xd6, + 0x89,0x89,0x89,0x89,0xd1,0x6c,0x36,0x7b,0x1f,0x70,0x14,0x28,0x79,0x48,0x55,0x83, + 0x76,0xd4,0x96,0x8b,0xa3,0xcd,0x62,0xfe,0x89,0x88,0xdc,0x6f,0x59,0xd6,0xb7,0xd1, + 0xb,0x62,0x35,0x47,0xb,0x6e,0x9d,0x19,0x1b,0x1b,0x1b,0x17,0x91,0x7b,0x81,0x8f, + 0x53,0x50,0x9f,0xa1,0x1,0x3b,0x6a,0xdb,0xc7,0xd1,0x8c,0x31,0x17,0xd8,0xbf,0x2d, + 0x22,0x7f,0xa2,0x85,0xb6,0xbe,0x68,0xc1,0x6d,0x10,0x46,0x47,0x47,0xf,0x3,0xf7, + 0x2,0x1f,0x12,0x11,0x77,0x15,0x50,0x68,0x7d,0xc1,0xd0,0x31,0x5f,0xb4,0xed,0x69, + 0xe0,0x8b,0xdd,0xdd,0xdd,0xf,0xcf,0xcd,0xcd,0x6d,0x7d,0x16,0x8f,0xa6,0x26,0x68, + 0xc1,0x6d,0x30,0x36,0x16,0xd7,0x7e,0x5f,0x44,0xfe,0x88,0x6d,0xea,0xef,0xb6,0x89, + 0x60,0x54,0xdd,0xb6,0x4d,0xe2,0x78,0x51,0x29,0xf5,0x57,0x91,0x48,0xe4,0x69,0xf4, + 0x88,0xb6,0x61,0xd0,0x82,0xdb,0xa0,0xf4,0xf7,0xf7,0xef,0xee,0xea,0xea,0x3a,0x2a, + 0xeb,0xa5,0x20,0x6b,0xb6,0x5d,0xb8,0x49,0xc5,0x65,0x47,0x6c,0x9b,0x30,0xe,0x1b, + 0xf8,0x96,0xe3,0x38,0x5f,0xb6,0x2c,0xeb,0x64,0x45,0x5f,0xa0,0xa9,0x9,0x5a,0x70, + 0x1b,0x9c,0x40,0x20,0xd0,0xa9,0x94,0xba,0x3,0xb8,0x1b,0x38,0xd8,0x8c,0x82,0xd1, + 0x8c,0x31,0x37,0x4a,0x1c,0x2e,0x6d,0xd3,0xc0,0x63,0xc0,0x17,0x22,0x91,0xc8,0x8f, + 0x5c,0x3b,0xd7,0xd4,0x1c,0x2d,0xb8,0x4d,0xc4,0xe8,0xe8,0xe8,0x61,0xc7,0x71,0xee, + 0x4,0x7e,0x13,0xd8,0x5d,0xce,0xb6,0x85,0xc5,0x45,0xc7,0xf1,0xe,0x2f,0x2a,0xa5, + 0xfe,0x11,0x78,0x34,0x1c,0xe,0xc7,0x5c,0x3b,0xd6,0xd4,0xd,0x2d,0xb8,0x4d,0xc8, + 0x81,0x3,0x7,0x3a,0x32,0x99,0xcc,0x2d,0x86,0x61,0xdc,0x29,0x22,0xd7,0x53,0x74, + 0x1d,0x5b,0x54,0x5c,0x1a,0x2e,0x8e,0x3a,0xc5,0xbc,0xc,0xfc,0xbd,0x61,0x18,0xdf, + 0xd0,0x47,0x90,0x37,0x1f,0x5a,0x70,0x9b,0x9c,0xe1,0xe1,0xe1,0x9f,0x33,0xc,0xe3, + 0x28,0x70,0x3b,0xb0,0xb7,0xc5,0xc4,0xa5,0x25,0xe2,0xa8,0x42,0xcc,0x2,0xbc,0x28, + 0x22,0x5f,0xf3,0xfb,0xfd,0xc7,0x16,0x17,0x17,0x57,0x2a,0x72,0xa8,0x69,0x18,0xb4, + 0xe0,0xb6,0xe,0xc6,0xf0,0xf0,0xf0,0xb5,0xc0,0x6d,0x4a,0xa9,0x8f,0x0,0x83,0xe5, + 0x8c,0xb5,0xc8,0x35,0x5e,0x1c,0x45,0xb6,0x59,0xe0,0x59,0x11,0x39,0x66,0xdb,0xf6, + 0xd3,0xf1,0x78,0x3c,0xe4,0xda,0x91,0xa6,0x61,0xd1,0x82,0xdb,0x9a,0x78,0x86,0x87, + 0x87,0xdf,0xc5,0xba,0xf8,0x7e,0x14,0x18,0x28,0x7c,0xb3,0x11,0xc4,0xa5,0x51,0xe2, + 0x68,0xb0,0x98,0x5,0x78,0x49,0x44,0x8e,0x79,0x3c,0x9e,0x7f,0xe,0x85,0x42,0x67, + 0x2b,0xa,0x4e,0xd3,0xf0,0x68,0xc1,0x6d,0x71,0x2,0x81,0x40,0x27,0xf0,0x2b,0xc0, + 0xad,0x22,0x72,0x44,0x44,0xfa,0xdc,0x7e,0xb6,0x4d,0x44,0xae,0xea,0xb6,0x15,0xda, + 0x3b,0xc0,0x2b,0x22,0xf2,0xa4,0x6d,0xdb,0x8f,0xe9,0x6a,0x5d,0xad,0x8d,0x16,0xdc, + 0x36,0x63,0x68,0x68,0x68,0xc6,0x30,0x8c,0x9b,0x81,0x1b,0x80,0xf7,0x53,0xe3,0x3a, + 0xe,0xd,0x22,0x72,0xf5,0xb6,0x9d,0x7,0x8e,0x8b,0xc8,0x71,0xd3,0x34,0xff,0x7d, + 0x79,0x79,0x39,0xe1,0xfa,0xb,0x34,0x4d,0x8d,0x16,0xdc,0x36,0x66,0x64,0x64,0xe4, + 0x12,0xe0,0x3a,0xe0,0x6,0x11,0xf9,0x20,0x30,0xd4,0xc2,0x22,0x57,0xcf,0x38,0x1c, + 0xe0,0x65,0x11,0xf9,0xae,0xc7,0xe3,0x79,0x3e,0x18,0xc,0xbe,0x8a,0xde,0xfd,0xd5, + 0x96,0x68,0xc1,0xd5,0x0,0x70,0xf8,0xf0,0x61,0xef,0xdc,0xdc,0xdc,0x61,0xc3,0x30, + 0xae,0x5,0xde,0xd,0x5c,0xb,0xc,0x6d,0x65,0xdf,0x4,0x22,0x77,0x51,0xb6,0x17, + 0xe9,0x3b,0x3,0xbc,0x2,0xbc,0xc,0xbc,0x68,0x18,0xc6,0x8b,0xc1,0x60,0x70,0xa1, + 0xa2,0x2f,0xd7,0xb4,0x24,0x5a,0x70,0x35,0x5b,0x32,0x30,0x30,0x30,0xe9,0xf1,0x78, + 0xae,0x5,0xae,0x55,0x4a,0xbd,0x5b,0x44,0x66,0x0,0xa3,0x41,0x45,0xae,0x9e,0x71, + 0x84,0x81,0x97,0x95,0x52,0x2f,0xd9,0xb6,0x7d,0xa2,0xab,0xab,0xeb,0x87,0xf3,0xf3, + 0xf3,0xab,0x15,0x7d,0xa1,0xa6,0x2d,0xd0,0x82,0xab,0xa9,0x4,0x73,0x68,0x68,0xe8, + 0x10,0x70,0x19,0x30,0x3,0x1c,0xde,0xf8,0xf7,0x38,0x25,0xda,0x52,0x33,0x8a,0xed, + 0x36,0xb6,0xab,0x4a,0xa9,0x57,0x1d,0xc7,0x79,0xd,0x78,0x5d,0x44,0x4e,0x3a,0x8e, + 0xf3,0x9a,0x3e,0x3e,0x5c,0xe3,0x16,0x2d,0xb8,0x9a,0x8b,0x26,0x10,0x8,0x8c,0xd8, + 0xb6,0x7d,0x85,0x88,0x5c,0x29,0x22,0x13,0x4a,0xa9,0x31,0x11,0x19,0x3,0xe,0x0, + 0x9d,0xdb,0x7d,0xbe,0xc1,0x84,0x59,0x80,0x73,0xc0,0x69,0x11,0x39,0xa3,0x94,0x3a, + 0x3,0x9c,0x32,0xc,0xe3,0x47,0xbd,0xbd,0xbd,0xaf,0xbf,0xf5,0xd6,0x5b,0xa9,0x8a, + 0x82,0xd5,0x68,0xa,0xd0,0x82,0xab,0xd9,0x51,0x6,0x7,0x7,0x7,0x94,0x52,0x63, + 0xc0,0x98,0xe3,0x38,0x63,0x1b,0xff,0xee,0x67,0x7d,0x63,0xc6,0x3e,0x11,0xe9,0x67, + 0xfd,0x70,0xcd,0x92,0xd9,0x12,0x85,0x54,0x41,0x98,0xe3,0xc0,0xa2,0x52,0x6a,0x59, + 0x44,0x82,0x22,0xb2,0xac,0x94,0x3a,0xab,0x94,0x3a,0xe3,0x38,0xce,0x19,0xc3,0x30, + 0xce,0xf4,0xf6,0xf6,0xfe,0x54,0x8b,0xaa,0x66,0xa7,0xf8,0x7f,0x61,0x46,0xa7,0xd4, + 0x38,0x75,0x8a,0xbb,0x0,0x0,0x0,0x0,0x49,0x45,0x4e,0x44,0xae,0x42,0x60,0x82, + + // /home/pi/share/projects.nxt/libPiGPIO/images/Black.png + 0x0,0x0,0x83,0xc0, + 0x89, + 0x50,0x4e,0x47,0xd,0xa,0x1a,0xa,0x0,0x0,0x0,0xd,0x49,0x48,0x44,0x52,0x0, + 0x0,0x1,0xc2,0x0,0x0,0x1,0xc2,0x8,0x4,0x0,0x0,0x0,0xd6,0x11,0x1,0xce, + 0x0,0x0,0x0,0x4,0x67,0x41,0x4d,0x41,0x0,0x0,0xb1,0x8f,0xb,0xfc,0x61,0x5, + 0x0,0x0,0x0,0x20,0x63,0x48,0x52,0x4d,0x0,0x0,0x7a,0x26,0x0,0x0,0x80,0x84, + 0x0,0x0,0xfa,0x0,0x0,0x0,0x80,0xe8,0x0,0x0,0x75,0x30,0x0,0x0,0xea,0x60, + 0x0,0x0,0x3a,0x98,0x0,0x0,0x17,0x70,0x9c,0xba,0x51,0x3c,0x0,0x0,0x0,0x2, + 0x62,0x4b,0x47,0x44,0x0,0xff,0x87,0x8f,0xcc,0xbf,0x0,0x0,0x80,0x0,0x49,0x44, + 0x41,0x54,0x78,0xda,0xed,0xbd,0x79,0x9c,0x5c,0x57,0x75,0x27,0xfe,0xbd,0xd5,0x8b, + 0x76,0x59,0xad,0x96,0xbc,0x8,0x5b,0x96,0x5a,0xf2,0x82,0x8d,0x6d,0xc0,0x40,0x0, + 0x3b,0x40,0xd8,0x62,0x13,0xc8,0x2,0xc4,0x2c,0xc1,0x19,0x16,0x27,0x24,0xe4,0x17, + 0x96,0x30,0x13,0x92,0x19,0x32,0x4,0x26,0xcc,0xc0,0x24,0x64,0x42,0xc2,0x12,0x62, + 0x3,0x1,0x1c,0xc0,0x36,0x86,0x4,0xc,0x36,0x5b,0xe2,0x24,0x98,0xc5,0xc6,0xc6, + 0xc8,0xbb,0x2c,0x75,0xb7,0x16,0x6b,0xef,0xae,0x56,0x4b,0xea,0xb5,0xea,0xdd,0xdf, + 0x1f,0x5d,0x5d,0xef,0xbe,0x77,0xcf,0xb9,0xf7,0xdc,0xb7,0x54,0x57,0x4b,0xf5,0xfc, + 0x51,0xbb,0xeb,0xd5,0xeb,0x5a,0xdf,0xf7,0x9d,0xef,0xf9,0x7e,0xcf,0x39,0x17,0xe8, + 0x6c,0x9d,0xad,0xb3,0x75,0xb6,0xce,0xd6,0xd9,0x3a,0x5b,0x67,0xeb,0x6c,0x9d,0x6d, + 0xc1,0x36,0xd5,0xf9,0x8,0xda,0x77,0x3b,0x63,0xc5,0x8a,0xfe,0x4a,0x7f,0x7d,0xbd, + 0xea,0xd7,0xfd,0xaa,0x1f,0xcb,0xf5,0x1a,0x0,0x4b,0x2a,0xcb,0x1,0xbd,0x12,0x3d, + 0x50,0x58,0xd3,0x3c,0x74,0x1c,0x75,0x44,0xea,0x28,0x80,0xa9,0x68,0x12,0xa8,0x1c, + 0xd3,0x27,0xd4,0x88,0x1e,0x51,0x23,0x7a,0x24,0x3a,0xbc,0x64,0xe4,0xb1,0x63,0x9d, + 0x4f,0xb3,0x3,0xc2,0xce,0xe6,0xd9,0x2e,0xee,0x9d,0xda,0xa8,0x37,0xe9,0x4d,0x95, + 0xcd,0xfa,0x5c,0x6c,0x40,0x3f,0xfa,0xd1,0x8f,0xa5,0x85,0x3d,0xfc,0xc,0x46,0x30, + 0xa2,0x46,0x70,0x50,0xf,0x63,0x58,0xd,0xd5,0x87,0x31,0x3c,0x3c,0xd5,0xf9,0xd4, + 0x3b,0x20,0x3c,0xc5,0xb7,0x4d,0x6b,0x2a,0x4f,0x51,0x5b,0xf5,0x26,0xbd,0x59,0x6d, + 0xc6,0x26,0x3c,0x9,0x95,0x16,0xbf,0x80,0xfd,0x18,0xc2,0xb0,0x1a,0x8a,0x86,0x2b, + 0x83,0x5d,0xdb,0xb6,0x1f,0xe9,0x7c,0x23,0x1d,0x10,0x9e,0x12,0xdb,0xb,0xba,0xf7, + 0x6d,0x9c,0xbd,0x58,0x5d,0xae,0x2e,0xd2,0x17,0xe3,0xc9,0x6d,0xf5,0xe9,0x57,0xf1, + 0xb0,0xbe,0xb7,0xf2,0x90,0x7e,0x78,0xea,0xbe,0x7d,0x13,0x9d,0x6f,0xaa,0x3,0xc2, + 0x93,0x2e,0xb7,0x5b,0xf9,0xac,0xe8,0x72,0x5c,0x82,0x4b,0xd4,0x45,0x58,0xd2,0xf6, + 0x2f,0xb7,0x86,0xc7,0xf0,0x0,0xb6,0xa9,0xfb,0xeb,0x3f,0x1a,0x1e,0xeb,0x7c,0x7b, + 0x1d,0x10,0x2e,0xea,0xed,0xfc,0x27,0xcd,0x5e,0x81,0x2b,0xd4,0x15,0xb8,0xc,0xdd, + 0x45,0x3f,0xb6,0x86,0x6,0x10,0x41,0x3,0xe8,0x2,0x80,0x32,0xd8,0x6c,0x84,0x87, + 0x71,0x97,0xbe,0xab,0xeb,0x87,0x3b,0x76,0x76,0xbe,0xcd,0xe,0x8,0x17,0xd3,0xd6, + 0xb5,0xf9,0x29,0xb8,0x52,0x3d,0x17,0x57,0xe0,0xdc,0xac,0x0,0x8b,0x50,0x47,0xdd, + 0xf8,0x39,0xf7,0xf,0xa8,0x37,0xb0,0xc1,0x7f,0x9d,0xa,0x40,0x5,0xa,0x15,0x54, + 0xd0,0x85,0x2e,0x54,0x1a,0xff,0xe6,0x7e,0x66,0xfe,0xba,0xf7,0xe3,0x87,0xb8,0x2b, + 0xfa,0x61,0xff,0x7d,0xf7,0xce,0x76,0xbe,0xe0,0xe,0x8,0xdb,0x78,0x3b,0x77,0x73, + 0xd7,0x55,0xb8,0x1a,0xcf,0xc7,0xea,0x50,0xd0,0xd5,0x50,0x43,0xd,0xb3,0x8d,0x9f, + 0xf5,0xf2,0xae,0xf,0xe8,0x46,0x37,0x7a,0x9a,0x3f,0x83,0xbf,0xfe,0x9,0xdc,0x85, + 0x3b,0xea,0xb7,0xef,0x7a,0xa4,0xf3,0x6d,0x77,0x40,0xd8,0x56,0xdb,0xa6,0xa5,0xea, + 0x79,0xea,0x2a,0x5c,0x8d,0xb,0xe5,0x7f,0x53,0xc7,0xc,0x66,0x30,0xd3,0x0,0x5e, + 0x19,0x5f,0x94,0x16,0x81,0xb2,0x7,0xdd,0xe8,0x45,0x2f,0x7a,0xc3,0x18,0xf3,0x2e, + 0xdc,0x5e,0xb9,0x63,0xc9,0xf7,0x1f,0x3a,0xde,0xf9,0xf6,0x3b,0x20,0x5c,0xf0,0xd8, + 0xd7,0xfd,0x12,0xbc,0x58,0xff,0xb2,0x2c,0xf6,0x69,0xcc,0x36,0xa0,0x37,0xed,0x88, + 0x76,0xe5,0x7e,0x25,0x3c,0x34,0x2b,0xe8,0x41,0x2f,0x7a,0xb1,0x4,0xbd,0xd2,0xfc, + 0xb2,0x86,0x9f,0xe0,0x1b,0xea,0x7b,0x3b,0xef,0x13,0x21,0xbe,0xb3,0x75,0x40,0x58, + 0xec,0x36,0x70,0x89,0xbe,0x46,0xbd,0x5a,0x16,0xfb,0x66,0x30,0x85,0x29,0x4c,0x63, + 0x36,0xf0,0x2b,0x50,0x2d,0x80,0x1e,0x7d,0x4f,0xf,0x7a,0xb1,0x14,0x4b,0xd1,0x2b, + 0x7b,0xd,0xbb,0x71,0x6b,0x74,0xf3,0xf0,0x4f,0x3a,0x50,0xec,0x80,0xb0,0x75,0x99, + 0xdf,0x35,0xf8,0x6d,0x5c,0xe4,0x3f,0xf1,0xa7,0x31,0x85,0x29,0x4c,0x11,0x42,0x8a, + 0xca,0xf8,0x55,0xa8,0x9c,0x90,0x73,0x1f,0xa3,0x89,0xe7,0x5b,0x82,0x25,0x58,0x8a, + 0xa5,0xd,0x5,0xd6,0xb9,0xed,0xd1,0x5f,0x53,0xb7,0xc,0xde,0xd5,0x81,0x62,0x7, + 0x84,0x65,0x46,0xbf,0xf3,0xd5,0x35,0xfa,0x1a,0x5c,0xe2,0x3e,0x2a,0xc2,0x24,0xa6, + 0x30,0x85,0x19,0xeb,0x6c,0x54,0xc2,0x8f,0x7f,0x6e,0x6f,0x3f,0xfa,0xb1,0xb6,0x51, + 0xbf,0xd6,0x87,0x75,0x58,0x87,0xd3,0xb0,0x14,0xcb,0x0,0xac,0x44,0x37,0x14,0xd6, + 0x40,0xa3,0x17,0x2b,0xa0,0x31,0x8d,0x9,0x68,0xd4,0x31,0xe,0x0,0x38,0x8a,0x3a, + 0xaa,0x18,0xc3,0x18,0xaa,0x38,0x8a,0x31,0x8c,0x61,0xc,0xa3,0xd8,0x8f,0x83,0xd, + 0x43,0x43,0x2,0x3e,0x7b,0xcf,0x5c,0x64,0x5c,0xe6,0x5,0xa3,0x1e,0x54,0x37,0x57, + 0x6e,0xde,0xf1,0xb3,0xce,0xd9,0xd2,0x1,0x61,0xc1,0xdb,0xd6,0xb3,0xa3,0x6b,0x71, + 0xd,0x9e,0xea,0x3e,0x6a,0x1a,0x13,0x98,0xc4,0x94,0xe7,0x43,0xa6,0xa1,0xb8,0x4, + 0xe7,0xe2,0x5c,0x6c,0x6a,0xfc,0xdc,0x84,0x33,0x1c,0x79,0x99,0x4e,0xfc,0x9f,0xfb, + 0x99,0xde,0x57,0xc3,0x21,0xec,0xc1,0x7e,0xec,0xc3,0x3e,0x1c,0xc0,0x6e,0xec,0xc4, + 0x21,0x2f,0xfc,0xec,0xfb,0x97,0x60,0x19,0x96,0x63,0x89,0xef,0xc4,0x79,0x5c,0xdf, + 0xa4,0xbe,0x30,0xb8,0xbd,0x73,0xe6,0x74,0x40,0x58,0xc4,0x56,0x19,0x78,0xa1,0xfa, + 0x5d,0xfd,0x1b,0x2e,0xf1,0xb0,0x8e,0x29,0x4c,0xe2,0x84,0x25,0xb6,0x28,0xc7,0x7, + 0xad,0x0,0x9c,0x83,0xa7,0xe0,0x12,0x5c,0x8c,0xcd,0xd8,0x84,0xb3,0x44,0x5f,0x85, + 0x1f,0x6a,0x21,0x47,0x8d,0x63,0x27,0x1e,0xc7,0xe3,0xd8,0x81,0x1d,0xd8,0x89,0x9, + 0x7,0x1c,0xed,0x98,0xbe,0xc,0xcb,0xb1,0xdc,0xa7,0xa8,0xde,0xab,0xfe,0x61,0xf2, + 0xc6,0x4e,0x11,0x5c,0x7,0x84,0x39,0xb6,0xf3,0x7,0xea,0x6f,0xc1,0x1b,0xf5,0x6, + 0x97,0xe4,0x72,0x2,0x13,0x98,0x16,0x83,0x4f,0x61,0x35,0x2e,0xc2,0xa5,0x78,0xa, + 0x2e,0xc1,0x53,0xd0,0x17,0x2c,0xad,0xe8,0x12,0xa0,0x38,0xf7,0x53,0x63,0x2f,0x7e, + 0x8e,0x7,0xb1,0xd,0xdb,0xb0,0x5f,0xc,0xc6,0x5e,0x2c,0xc7,0xa,0x77,0x25,0x5e, + 0x55,0x7f,0xa1,0x72,0xfd,0xce,0x7,0x3b,0x67,0x53,0x7,0x84,0x81,0xdb,0xc5,0xbd, + 0x13,0xbf,0xa6,0x7e,0x1b,0x57,0xf3,0x29,0xd0,0xc,0x4e,0xe0,0x78,0x4a,0xef,0xe4, + 0xc1,0xd7,0x83,0xa7,0xe0,0xa,0x3c,0x1b,0xbf,0x80,0xcd,0x81,0x1f,0x79,0xb1,0x50, + 0x93,0x1d,0x75,0x18,0xf,0xe0,0x1,0x6c,0xc3,0xbd,0xd8,0x27,0x2,0x63,0x37,0x56, + 0x60,0x85,0xbb,0xef,0xea,0x5e,0xf5,0xf,0x4b,0xbf,0xd8,0x71,0x15,0x3b,0x20,0x94, + 0xc7,0xbf,0xb7,0xe9,0xdf,0xc6,0x7a,0xee,0xfe,0x59,0x1c,0xc7,0x9,0xcc,0x30,0x1f, + 0x63,0x12,0x88,0xab,0x70,0x29,0xae,0xc0,0x15,0x78,0x6e,0x50,0xd4,0x43,0xc9,0x20, + 0x93,0x1f,0x75,0x10,0x3f,0xc1,0x3d,0xb8,0x1b,0xf,0x18,0xa,0xaf,0x66,0xa0,0xd8, + 0x83,0x15,0xee,0xa8,0x38,0x8e,0x2f,0xe9,0x4f,0xc,0x6d,0xeb,0x9c,0x61,0x1d,0x10, + 0xba,0x5,0x98,0xa7,0xeb,0x77,0xea,0xd7,0x71,0xa9,0x4e,0xd,0x27,0x70,0x22,0x25, + 0xbc,0xd0,0xf0,0x5b,0x83,0x17,0xe1,0xc5,0xb8,0x2,0x4f,0xce,0x54,0x56,0xdd,0x3a, + 0x90,0x49,0x8f,0x1a,0xc5,0x3d,0xf8,0x31,0xee,0xc6,0xb6,0x26,0x18,0x75,0xd6,0xa8, + 0x78,0x97,0xfe,0xf0,0xd0,0x6d,0x1d,0x1b,0xa3,0x3,0x42,0x52,0x80,0xd9,0xfc,0x2b, + 0xea,0xed,0x78,0x31,0x7,0x8b,0x9,0x8c,0x63,0xd2,0xb,0x3f,0x85,0x8b,0xf0,0x72, + 0xbc,0x8,0xbf,0x88,0xde,0x42,0xc0,0xd7,0x6e,0x80,0x1c,0xc3,0x5d,0xf8,0x4f,0x7c, + 0x1f,0x7,0x3c,0x50,0xec,0xc5,0x4a,0xac,0xe2,0xb9,0xfc,0x36,0xf5,0xf1,0xfa,0xe7, + 0x3b,0x9d,0xfd,0x1d,0x10,0x9a,0xf1,0x6f,0x89,0x7e,0xd,0xfe,0x44,0x3f,0x99,0xa3, + 0x9f,0xc7,0x70,0x2c,0xa1,0x7c,0x52,0xf0,0x5b,0x8f,0x17,0xe0,0x45,0x78,0x19,0x9e, + 0x94,0xe9,0x15,0x94,0xb,0x1f,0xa4,0x24,0x18,0xd7,0xbe,0xe4,0x1e,0xee,0xe7,0xe3, + 0xf8,0x3e,0xfe,0x13,0x3f,0x69,0xe4,0xc4,0x34,0x14,0x15,0x96,0x63,0x35,0x96,0x71, + 0x6f,0xf9,0x20,0xfe,0x7e,0xe6,0x6f,0xf7,0x8e,0x76,0xce,0xbe,0xe,0x8,0xb1,0x75, + 0x7d,0xf4,0x66,0xbc,0x3,0x67,0xc9,0xe2,0x1f,0x5,0xbf,0xcd,0x78,0x35,0x5e,0x85, + 0xcb,0x73,0x13,0xcf,0x62,0xa1,0x58,0x46,0x5e,0xa9,0x53,0x7b,0xc6,0x71,0x27,0x6e, + 0xc7,0x9d,0xd,0x82,0x4e,0x43,0xb1,0x7,0xab,0xf8,0x98,0x78,0x5c,0x7f,0x51,0x7d, + 0xa4,0xe3,0x26,0x9e,0xd2,0x20,0xdc,0x72,0xba,0xfe,0x53,0xbc,0x95,0xbe,0x58,0x4f, + 0x63,0x1c,0x27,0x12,0x5,0x67,0xca,0xfa,0xc8,0x36,0xe2,0x37,0xf0,0x6a,0x3c,0x27, + 0xd3,0x87,0x58,0x24,0x3c,0x5a,0x4b,0x66,0x75,0x6a,0xdf,0x24,0x7e,0x84,0xdb,0xf1, + 0x6d,0x9c,0x60,0xa1,0xa8,0xb0,0x2,0xab,0xb8,0x98,0x58,0xc3,0x17,0xea,0xff,0x6b, + 0xd7,0x50,0x7,0x84,0xa7,0xe0,0x76,0x61,0xff,0xcc,0x1f,0xe2,0x5d,0x74,0xf7,0xc3, + 0x4,0x8e,0x92,0xf1,0xaf,0x5c,0xf8,0x65,0x1,0x46,0x2b,0xc8,0xac,0xff,0x28,0xd, + 0x60,0xa,0x3f,0xc4,0xed,0xf8,0x1e,0x8e,0xb3,0x51,0xb9,0x7,0xab,0xb1,0x9a,0xfe, + 0xc4,0x66,0xd5,0x97,0xbb,0xfe,0x7c,0xfb,0x60,0x7,0x84,0xa7,0xd0,0x76,0xc1,0xaa, + 0xd9,0xb7,0xe1,0x4f,0x71,0x1a,0x5,0x90,0x13,0xa8,0x26,0xdc,0xbf,0x34,0x0,0xd7, + 0xe2,0xb7,0xf0,0x7a,0x3c,0x33,0x73,0x7f,0x5f,0xf1,0x51,0xaf,0x5d,0xc4,0x9b,0xb9, + 0xa8,0xf8,0x1d,0x7c,0xd,0x3f,0x41,0xc4,0xc4,0xc4,0x2e,0xac,0xc6,0x6a,0x9a,0x9c, + 0xce,0xe8,0x7f,0xac,0xbd,0x7f,0xcf,0xbe,0xe,0x8,0x4f,0x81,0xed,0xe2,0x95,0x93, + 0x7f,0x80,0xf7,0x50,0xb6,0x5d,0x1d,0xe3,0x18,0x37,0x4,0x18,0x65,0xfd,0xff,0xe9, + 0xf8,0x1d,0xfc,0x16,0x96,0x2f,0x90,0xec,0xd2,0x1e,0x51,0xcf,0x7d,0x54,0xd4,0xd0, + 0x5c,0xbe,0x81,0xaf,0x60,0x17,0x13,0x13,0x2b,0x58,0x89,0xd3,0xd0,0x43,0xe6,0x0, + 0xfa,0x73,0xfa,0x7d,0xc3,0x7,0x3a,0x20,0x3c,0x89,0xb7,0xd,0xcb,0x97,0xfe,0xe, + 0xfe,0x14,0x67,0x10,0x7c,0x8,0xe3,0x18,0x4f,0x64,0x31,0xc9,0xff,0x6f,0xc0,0xb5, + 0x78,0x33,0xb6,0x66,0x2,0x5f,0xf6,0x53,0xbe,0x7d,0xa3,0x9e,0x4,0x8a,0xf,0xe1, + 0x16,0x7c,0xb,0x27,0x18,0x72,0xba,0x1c,0x6b,0x68,0x37,0xf1,0x84,0xfe,0x74,0xe5, + 0x83,0x3b,0xf,0x75,0x40,0x78,0x52,0xbe,0xd3,0x2d,0xd7,0xe2,0xff,0x50,0x75,0xa0, + 0x33,0x18,0x4d,0x14,0x2f,0xab,0xc4,0x7,0xd3,0x83,0xab,0xf1,0x16,0x5c,0x15,0x38, + 0x2e,0xad,0x1d,0xa2,0x5e,0x3b,0x40,0x71,0x12,0xb7,0xe1,0x8b,0xd8,0xc1,0xbc,0xc3, + 0xa5,0x58,0x4b,0x3,0xb1,0x8a,0xf,0xf4,0x7d,0xfc,0xd4,0x19,0x29,0x75,0x8a,0x80, + 0x70,0xe0,0x99,0xf8,0x1b,0x3c,0x97,0x2,0xe0,0x51,0x1c,0x73,0xe4,0x7f,0xbf,0x8b, + 0xb7,0x5,0x3a,0x7f,0xc5,0x39,0x7a,0x8b,0x23,0xea,0x49,0xd4,0xd4,0xbb,0xf1,0x25, + 0xdc,0x99,0xc8,0x13,0xb5,0x1f,0x88,0xdb,0xf5,0x7b,0x87,0x6e,0xe9,0x80,0xf0,0x24, + 0xd9,0xce,0x7f,0xd2,0xec,0xff,0x54,0xd7,0xd9,0x36,0x5e,0xd,0x63,0x8d,0x36,0x58, + 0xa,0x80,0x5b,0x70,0x1d,0xde,0x4a,0x69,0x37,0x2,0xf0,0x2d,0xbc,0xa3,0x97,0x35, + 0x76,0xc2,0xf2,0x2,0x8b,0x7a,0xc6,0xc3,0xb8,0x15,0x5f,0xc6,0x18,0xf9,0xee,0x97, + 0x61,0x2d,0x5d,0x73,0xfa,0x3d,0xf5,0xae,0x53,0xa1,0xff,0xe2,0x24,0x7,0xe1,0xd9, + 0xcb,0x7a,0xdf,0x8e,0xff,0x81,0x55,0x14,0x0,0x8f,0x35,0x4f,0x3,0x95,0x22,0xa2, + 0x57,0xe2,0x5d,0x78,0x85,0xd8,0x7c,0x5f,0x3c,0x51,0xf,0x41,0xc7,0xda,0x59,0x5e, + 0xde,0x57,0x34,0x8d,0xdb,0xf1,0x39,0xc,0x87,0x0,0xb1,0xa6,0x3f,0xd3,0xf5,0xde, + 0x1d,0x87,0x3b,0x20,0x5c,0xb4,0xdb,0xe6,0x57,0xa8,0xbf,0xc5,0x26,0x1b,0x80,0x47, + 0xd,0x11,0x26,0x9,0xc0,0x2e,0xbc,0xc,0x7f,0x82,0x67,0x97,0x2c,0xbb,0xa0,0x25, + 0x51,0xaf,0xdc,0xbc,0x31,0xca,0xf8,0x58,0x11,0x7e,0x80,0x4f,0xe3,0x41,0x12,0x88, + 0xcb,0xb1,0x96,0xaa,0xb9,0x1d,0xc5,0x7,0x36,0x7e,0xfc,0xce,0x5a,0x7,0x84,0x8b, + 0x6e,0xdb,0x7a,0x51,0xf4,0x29,0x5c,0x99,0xde,0x1b,0x61,0xc,0x47,0x19,0x0,0x2e, + 0xc1,0x9b,0xf0,0x1e,0x6c,0x2c,0x51,0x76,0x29,0xf,0x18,0xad,0x81,0xb5,0xeb,0x7e, + 0x1d,0xf4,0x58,0x3f,0xc6,0xe7,0xf0,0x53,0x12,0x88,0xab,0xd1,0x47,0xf9,0x88,0xf, + 0xa8,0xdf,0xdb,0xf9,0xc3,0xe,0x8,0x17,0xd1,0x76,0x79,0x4f,0xf5,0x8f,0xf0,0x7e, + 0x9b,0xdd,0x9c,0xc0,0x48,0x73,0xd0,0x6e,0x12,0x80,0xbd,0x78,0x2d,0xde,0x8b,0x2d, + 0xa5,0xc9,0x2e,0x28,0xfc,0xc4,0x5f,0x28,0x9,0xa7,0x38,0x28,0x3e,0x86,0x2f,0xe1, + 0xdb,0xc6,0xf0,0xa9,0xf9,0xff,0x57,0xb0,0x6,0xa7,0xd9,0x27,0xa6,0xd6,0xd7,0x77, + 0xfd,0xb7,0x1d,0xe3,0x1d,0x10,0x2e,0x8e,0x18,0xf8,0x9c,0xe8,0x7a,0x5c,0x9c,0xde, + 0x3b,0x8d,0x91,0x66,0x27,0x60,0x12,0x80,0x3d,0xb8,0x16,0xff,0x1d,0x9b,0x17,0x8d, + 0xec,0xb2,0xf0,0x51,0x4f,0x7a,0x54,0xe4,0x3d,0x6a,0x7,0x3e,0x85,0x1f,0x10,0x9f, + 0x59,0xf,0xd6,0x62,0x85,0xfd,0x35,0xec,0xc7,0xff,0x37,0xf8,0xd5,0xe,0x8,0xdb, + 0x7c,0xdb,0xb0,0x7c,0xe9,0xff,0xc4,0x7f,0x4d,0xf3,0x99,0x1a,0xaa,0x96,0x11,0x31, + 0x9f,0x3,0xbe,0x12,0x1f,0xc0,0xf9,0xb,0x2c,0xbb,0x14,0x43,0x63,0xdb,0x13,0x8a, + 0xfe,0xd8,0xf8,0x20,0x3e,0x85,0x7b,0x89,0x77,0xbc,0xc,0xfd,0x54,0x86,0x78,0x5b, + 0xf7,0xef,0x6d,0x7f,0xa2,0x3,0xc2,0xb6,0xdd,0xb6,0x5c,0xad,0x3f,0x99,0x5e,0x9, + 0x49,0xe3,0x28,0xc6,0x9a,0xd7,0xe4,0x24,0x0,0x5f,0x8b,0x3f,0xc3,0x79,0x6d,0x2d, + 0xbb,0xb4,0x4a,0xc2,0xd1,0xa9,0x67,0x8c,0x5a,0xc,0xc5,0xbb,0xf1,0x29,0x3c,0x66, + 0x3d,0xa2,0xc2,0x2a,0x2a,0x43,0x1c,0x53,0xef,0xd9,0x79,0xfd,0xc9,0xd4,0x9b,0x7f, + 0xd2,0x80,0x70,0xcb,0xe9,0xfa,0x6f,0xf0,0xba,0xf4,0xde,0x9,0x1c,0x49,0x65,0x81, + 0xf3,0x3f,0x9f,0x85,0x8f,0xe0,0x39,0xc2,0xd8,0xb7,0x10,0x7a,0x64,0xf1,0x8f,0x15, + 0xe5,0x7c,0x8f,0x1c,0x48,0x8b,0x2,0xe4,0x4f,0xf1,0x71,0xec,0xb4,0x1e,0xa9,0xb, + 0x6b,0x6d,0x87,0x9,0xf8,0x5e,0xf7,0x5b,0x4f,0x9e,0xae,0x8b,0x93,0x4,0x84,0x5b, + 0x7e,0x5d,0x5f,0x8f,0x75,0xc9,0x7d,0x75,0x8c,0xe0,0x38,0x9,0xc0,0xcd,0xf8,0x10, + 0x5e,0xd5,0x76,0xb2,0x4b,0x56,0x78,0x2c,0x5c,0xc6,0x68,0xe,0x7f,0xa,0x1d,0xb0, + 0x48,0x1d,0x15,0xe1,0x9b,0xb8,0xc1,0x30,0xf4,0x75,0x93,0x98,0xae,0xb3,0xb,0xbe, + 0x27,0xd4,0x1f,0xed,0xfc,0x54,0x7,0x84,0x6d,0xb2,0x9d,0xbd,0xac,0xe7,0x43,0xea, + 0xed,0xb6,0x12,0x7a,0xa4,0xd9,0x11,0x61,0x42,0x70,0x25,0xde,0x8d,0x3f,0x4e,0x15, + 0x4a,0x2d,0xb4,0xec,0x72,0xb2,0xe4,0x8d,0x61,0x50,0xa4,0x29,0xef,0x71,0x7c,0x9, + 0xb7,0x60,0x36,0x45,0x91,0x15,0xfa,0xb0,0xc6,0x3e,0x79,0xbf,0x5d,0x7f,0xe3,0xc9, + 0xd0,0x73,0xb1,0xe8,0x41,0x38,0xf0,0xc,0xdc,0x88,0xb,0xd2,0x42,0xcc,0xe1,0x66, + 0x53,0x6e,0x32,0xb,0xfc,0x2d,0x7c,0x28,0xd1,0x44,0x91,0x4f,0x76,0x59,0x68,0x9b, + 0xa1,0x9d,0x75,0x52,0x9d,0xe3,0xa8,0x3d,0xf8,0x24,0x7e,0x6c,0xed,0xed,0xc5,0x7a, + 0xdb,0x75,0x3a,0x84,0x37,0xf,0x7e,0x73,0xb1,0x9f,0xc3,0x5d,0x8b,0xfb,0x12,0x32, + 0xf0,0xe,0x7c,0x39,0xdd,0x9a,0x34,0x8e,0x83,0x8d,0xb6,0xdc,0xb9,0xc5,0xa3,0xe7, + 0x7f,0xbe,0x10,0x5f,0xc3,0xef,0x62,0x65,0x5b,0x9c,0xf8,0x59,0x22,0xa8,0xc2,0xe2, + 0xea,0xa2,0xe0,0xf7,0xf3,0x91,0x74,0xee,0xb7,0xd5,0x78,0x21,0xce,0xc3,0x76,0x1c, + 0x33,0xbe,0x3f,0xa0,0x8e,0xe3,0x88,0xb0,0x2c,0x19,0x37,0x56,0xe0,0x75,0x6b,0x36, + 0x2c,0xff,0xd7,0x63,0x8b,0xba,0xe3,0x62,0x11,0x47,0xc2,0x2d,0xe7,0xe0,0xb,0xfa, + 0xf9,0xc9,0x7d,0x33,0x38,0xdc,0x1c,0x4a,0xaf,0x8c,0x38,0xd8,0x8f,0xbf,0xc4,0xb5, + 0xd6,0x69,0xbc,0x38,0x48,0x23,0x4a,0x2,0x11,0xa5,0x8b,0xf2,0x5e,0x9f,0xf9,0x7b, + 0x59,0xb1,0x31,0x29,0xf7,0xd4,0xf0,0x55,0x7c,0x1,0xd3,0xa9,0xd7,0xd8,0x83,0x75, + 0xf6,0xb4,0x9a,0x6d,0xea,0xb7,0x16,0x73,0xa1,0xf7,0xa2,0x8d,0x84,0x3,0xaf,0xc2, + 0x37,0x91,0x1a,0x52,0x78,0x14,0x87,0x1a,0x5a,0xa8,0x4a,0x40,0xf0,0xd5,0xf8,0x46, + 0xb3,0x8f,0xa9,0x15,0xb2,0x8b,0xbd,0x4f,0x65,0x7a,0x94,0x22,0x40,0x46,0xdd,0xe, + 0x81,0x35,0x3c,0xbf,0x87,0xc5,0x46,0xed,0xbd,0xdc,0xc4,0x8f,0x58,0xc1,0xc5,0x78, + 0x1,0xf6,0x62,0x5f,0x22,0x1e,0x46,0x54,0x3c,0x3c,0x3,0x6f,0xee,0xab,0x55,0x7f, + 0xb4,0x58,0x6d,0x8b,0x45,0x19,0x9,0xcf,0x5e,0xd6,0xfb,0x71,0xbc,0x89,0xcb,0x3, + 0xd3,0x4a,0xe8,0xc7,0xf0,0xd2,0xcc,0x71,0x43,0xe5,0x8c,0x41,0xaa,0xa5,0x51,0x4f, + 0x96,0x63,0x96,0xdd,0x51,0x1f,0x32,0x93,0x86,0xd7,0x5c,0xe3,0x7b,0x7e,0x80,0x8f, + 0xe1,0x68,0xea,0xd8,0x5e,0x9c,0x61,0xeb,0xa5,0xdf,0xac,0x5d,0xbb,0xbb,0xda,0x1, + 0x61,0x8b,0x68,0xa8,0xfe,0xa,0x9e,0xc5,0x69,0xa1,0xca,0xa0,0xa2,0xdd,0x78,0x1b, + 0xde,0xdf,0x28,0x7f,0xa,0x3f,0xc1,0x54,0xae,0x93,0x55,0x2d,0x40,0xd4,0x6b,0x2f, + 0x71,0x46,0xe7,0x80,0x6d,0x32,0xc2,0x1e,0xc3,0x3f,0xe2,0x8e,0xd4,0x3e,0x85,0xb5, + 0x76,0xb7,0xe7,0x6e,0xbc,0x7a,0xf0,0x9e,0xe,0x1d,0x2d,0x7d,0xdb,0xfa,0x2,0xfd, + 0xdd,0x64,0x9d,0x99,0xc6,0x28,0x46,0x1a,0x27,0xbe,0x29,0xc4,0x3c,0x3,0xff,0x8c, + 0x6b,0xd1,0xdb,0xe2,0x53,0x5a,0xe5,0xa0,0x7b,0x61,0x80,0xd,0xa7,0x96,0xb,0x75, + 0x14,0xd8,0xa8,0xe7,0xa2,0xb4,0xf1,0xdf,0xf4,0xe0,0x59,0xb8,0x10,0xf,0xe3,0x44, + 0x82,0x98,0x4e,0x62,0xa,0xcb,0x93,0x5d,0x9f,0xa7,0xe1,0xda,0xbe,0xfd,0xd5,0x9f, + 0x75,0x40,0x58,0xae,0x1a,0xfa,0x1e,0xfd,0xb9,0x64,0x1,0xc5,0x34,0xf6,0x37,0x26, + 0xc4,0x98,0x31,0xb0,0x17,0xef,0xc3,0xd,0x38,0xb3,0xa5,0x22,0x88,0x2a,0x5d,0xe8, + 0xc9,0xab,0xcc,0x72,0x19,0xa2,0x2c,0x7,0xd4,0x8,0xef,0xbb,0xf,0xbb,0x1c,0x69, + 0xf0,0x5,0xe0,0x67,0xe1,0x25,0x38,0xd1,0x98,0x56,0x33,0xff,0x5d,0xd7,0x70,0x1c, + 0xbd,0x49,0x5a,0xda,0x8d,0x5f,0x5b,0xb3,0xe1,0x49,0xdf,0x39,0x5c,0xef,0xd0,0xd1, + 0x72,0x62,0xe0,0xea,0xe8,0x73,0xf8,0xf5,0xe4,0xbe,0x31,0x54,0xd,0xe1,0x63,0xfe, + 0xe7,0x85,0xf8,0x2c,0x9e,0xde,0x42,0x3a,0xa8,0x4a,0x2c,0xed,0x6e,0x6f,0x9a,0x1a, + 0x9,0x24,0x1a,0x9f,0x42,0x9a,0x84,0xa0,0x5b,0x53,0xfd,0x19,0xfe,0xe,0x23,0xa9, + 0xbf,0x3c,0xd,0x6b,0xd3,0xa7,0xf1,0x5d,0xb3,0xd7,0x2c,0xa6,0x9,0xa6,0x8b,0x26, + 0x12,0x6e,0xbe,0x0,0xdf,0xc5,0x2f,0x9a,0x7b,0xea,0x38,0xd8,0xe8,0x8d,0x30,0x63, + 0x60,0x5,0xd7,0xe1,0x4b,0xd8,0x18,0x70,0x82,0xe5,0x31,0x2e,0x54,0x40,0x3c,0x53, + 0x5e,0x70,0x2e,0x6e,0x9a,0x6a,0xfe,0xdf,0x17,0x1b,0xf9,0xa3,0x28,0xea,0x1a,0xef, + 0x3f,0x3,0x2f,0xc2,0x11,0xec,0x4a,0x5c,0x74,0xa7,0x31,0x99,0xa6,0xa5,0x1b,0xbb, + 0x7e,0x7b,0xed,0xbd,0xd5,0xa1,0xe,0x8,0x8b,0x85,0xe0,0x6f,0xaa,0x6f,0x26,0xc7, + 0x9e,0x4d,0x63,0x7f,0x63,0xa1,0x4e,0x33,0xf,0x3c,0x3,0x9f,0xc7,0x3b,0x1a,0x4, + 0xa5,0x78,0x60,0x64,0x8b,0x67,0xed,0x4f,0x53,0x8b,0x6f,0xf6,0xf5,0x41,0x51,0x66, + 0x59,0x50,0x51,0xb1,0x7,0xcf,0xc6,0x39,0xd8,0x86,0x59,0xc3,0x84,0xaa,0xe3,0x38, + 0x96,0x24,0x69,0xe9,0xa,0xbc,0xbe,0x6f,0xbc,0xfa,0x93,0xe,0x8,0xb,0xdb,0x6, + 0xde,0xa1,0x6e,0x48,0x56,0x2c,0x1d,0xc7,0x41,0x44,0x30,0xfd,0x40,0x5,0x85,0x5f, + 0xc3,0x3f,0xe3,0xb2,0xd2,0xfb,0xfd,0xa4,0xa7,0xbc,0x12,0xc7,0x33,0x4,0xbc,0x22, + 0xe4,0x4,0xac,0x3b,0x3f,0xd4,0xec,0xb3,0x44,0x6c,0xa4,0xca,0x1e,0xf5,0xdc,0x4, + 0x35,0x62,0x3f,0xbd,0xb3,0x71,0x25,0x86,0x70,0xd8,0xb8,0xfc,0x6a,0x1c,0x87,0x4e, + 0x9a,0xf8,0x5d,0xb8,0xaa,0x6f,0xe3,0xc0,0xed,0xfb,0xa3,0xe,0x8,0x73,0x6f,0x2f, + 0xe8,0xae,0x7c,0x2,0xef,0x35,0x49,0xbf,0x46,0x15,0x23,0x56,0xc,0x5c,0x89,0x8f, + 0xe3,0xfd,0x58,0x8e,0x32,0xbb,0x15,0xa4,0x71,0x43,0x89,0xe1,0x11,0x2,0xa2,0x62, + 0x64,0x19,0x4,0xbc,0x22,0xd7,0xef,0x3a,0x93,0xec,0x62,0x3,0x12,0xe,0x1a,0xca, + 0xc7,0xc3,0xe5,0x78,0x3e,0x14,0x1e,0x81,0x59,0x17,0x35,0x85,0x69,0x2c,0x4f,0x66, + 0x87,0x4f,0x9b,0x7a,0x4e,0xdf,0xd7,0xab,0xd3,0x1d,0x61,0x26,0xd7,0x76,0xc1,0xaa, + 0x99,0x9b,0xd5,0x55,0xe6,0x9e,0x1a,0xe,0x61,0x2a,0x95,0x7,0x2,0xe7,0xe1,0x4b, + 0xb8,0x48,0x68,0x20,0x94,0x29,0x6f,0xa8,0x42,0xe3,0x30,0x32,0x40,0x6d,0xa1,0x67, + 0x99,0xca,0xa0,0x24,0x35,0xea,0xb9,0xa8,0x38,0xf7,0xf7,0xf,0xe3,0xef,0x30,0x9a, + 0x38,0xb2,0x7,0x67,0xa4,0xbb,0xf1,0x1f,0xc4,0xaf,0xc,0xee,0xee,0x80,0x30,0xf3, + 0x76,0xfe,0x93,0x6a,0xb7,0xe1,0xa9,0xe6,0x9e,0x29,0x1c,0x44,0x1d,0xc9,0xba,0x50, + 0xe0,0x15,0xf8,0x14,0x4e,0x2b,0xe5,0x94,0x96,0x9f,0xcc,0xaa,0x50,0x32,0x8b,0x52, + 0x2e,0x11,0xad,0x85,0xa2,0x2f,0xb6,0xc9,0x8c,0x7a,0xde,0xfa,0xd7,0x0,0x8e,0xe2, + 0x63,0x78,0x20,0xf1,0x5c,0x15,0xac,0x4f,0x4f,0xa7,0xd9,0xaf,0x5e,0xb1,0xf3,0xde, + 0xe,0x1d,0xcd,0x96,0x9,0x3e,0x23,0xba,0x33,0xb9,0x6,0xcb,0x38,0xe,0x35,0x32, + 0xc1,0x18,0x82,0xdd,0x78,0x3f,0xfe,0x12,0x4b,0x4b,0x20,0xa0,0xaa,0x50,0x9a,0x5a, + 0xc6,0x51,0x28,0x0,0x44,0x54,0x2e,0x48,0xc9,0x2b,0xd9,0xb3,0xcf,0x34,0x20,0x25, + 0x19,0xa3,0xcc,0x8f,0xd4,0x58,0x82,0xe7,0xa2,0x92,0xa0,0xa5,0x1a,0x27,0xd2,0xd9, + 0xe1,0x2a,0xbc,0x6e,0xed,0xfd,0xd5,0x1d,0x1d,0x10,0x6,0x6f,0x5b,0xae,0xc2,0x6d, + 0xe8,0x37,0xf7,0x54,0x31,0x6a,0x49,0x31,0xeb,0x71,0x13,0x5e,0x2b,0x94,0x1f,0x8a, + 0x27,0xa0,0xc5,0x1c,0x85,0xc2,0x9f,0x31,0x6b,0x19,0x77,0x78,0x76,0xa9,0x4b,0x8f, + 0xb3,0x3e,0x3b,0x5f,0xe1,0xc9,0xb8,0x0,0xdb,0x30,0x6d,0x28,0x4,0x53,0x98,0xc1, + 0xa,0x93,0xe4,0x2d,0xc1,0x6b,0xd7,0x8c,0x8c,0xdd,0xd3,0x1,0x61,0x18,0x4,0xff, + 0x50,0x7f,0xde,0x6c,0x7f,0xd7,0x38,0x84,0xf1,0x94,0x14,0x3,0x3c,0xf,0xb7,0xe1, + 0xa2,0x96,0x12,0xd0,0x30,0x9a,0x8a,0x42,0x9e,0x2b,0xa4,0x14,0xae,0x18,0x90,0x85, + 0x67,0x9f,0x60,0xa0,0x22,0xed,0x30,0x74,0x91,0x51,0xed,0x8d,0xb3,0xeb,0xf0,0x2c, + 0x3c,0x86,0x31,0xe3,0xcc,0x98,0x4d,0x97,0xb4,0x55,0xd4,0xcb,0xfa,0x96,0x57,0xbf, + 0xdf,0x1,0xa1,0x9c,0x88,0xbe,0x7,0x1f,0x31,0x3f,0xc1,0x3a,0xe,0x60,0x32,0x45, + 0x43,0x15,0xde,0x85,0x4f,0x62,0x15,0x8a,0xb2,0xe0,0xd1,0xc2,0xa3,0x16,0x36,0x36, + 0x16,0xd3,0x65,0x91,0xb7,0xc0,0x80,0x8b,0x73,0xf0,0x90,0x51,0xfa,0xfe,0xe5,0x78, + 0x2e,0xe,0x60,0xbf,0x71,0x8e,0xd4,0x30,0x81,0xe5,0xc9,0xd3,0xfb,0x8a,0xbe,0xad, + 0x97,0x7d,0x7d,0x38,0xea,0x80,0x50,0x20,0x15,0x6d,0xf9,0x2b,0xfc,0x4f,0x73,0xc7, + 0x6c,0xc3,0x96,0x37,0x69,0x68,0x2f,0x3e,0x89,0x3f,0x6c,0x0,0x32,0x9f,0xa0,0x52, + 0xac,0x54,0xe2,0x3b,0xaa,0xa8,0xd8,0x18,0xfe,0x1e,0xb5,0x13,0x2a,0xf0,0xbc,0x7a, + 0xee,0x37,0xd9,0x27,0x11,0x5,0x64,0x8c,0x32,0xeb,0xdf,0x3e,0xba,0xb,0xcf,0x40, + 0x2f,0x1e,0x69,0x5c,0x7e,0x15,0x14,0xea,0x38,0x8e,0xa5,0xc9,0x75,0x25,0x2f,0x1d, + 0xbb,0x6c,0xdd,0xd7,0x46,0xeb,0x1d,0x10,0x7a,0x20,0xb8,0xf9,0x6f,0xf0,0xae,0xa4, + 0x1e,0x7a,0x0,0xb5,0x44,0x26,0x8,0xac,0xc5,0x4d,0x78,0x59,0x41,0x4,0x54,0xb5, + 0x88,0xa0,0xca,0xe3,0x19,0x3f,0xdc,0x22,0xe4,0xdd,0xf9,0xbc,0xbe,0x62,0x46,0x73, + 0x98,0xbf,0x45,0xa2,0x77,0x27,0xef,0xce,0xd7,0xa2,0xb,0x9c,0xf9,0xef,0x3c,0x3c, + 0x9,0xf,0xa0,0xd6,0x64,0x4b,0x1a,0xc7,0xd1,0x93,0xb0,0x2c,0xd4,0x85,0xfa,0xe9, + 0x2b,0xbe,0x36,0x5e,0xeb,0x80,0xd0,0xf1,0x6a,0x6,0x3e,0xad,0xde,0x6a,0xee,0x38, + 0x81,0x83,0x88,0x52,0x99,0xe0,0x0,0xbe,0xde,0xf0,0x2d,0xca,0x26,0xa0,0x92,0xa9, + 0x2e,0x32,0x6a,0x99,0x37,0x36,0x16,0x1f,0xd9,0x8b,0x5f,0x8b,0x42,0x4e,0xd5,0x5d, + 0xd1,0x2f,0x7b,0xaf,0x5,0x0,0x6c,0xc0,0x25,0x78,0x10,0x13,0xcd,0xb3,0x45,0xe3, + 0x4,0x90,0xd4,0x4a,0xcf,0xeb,0xbe,0xf2,0xf4,0x5b,0x47,0x66,0x3a,0x20,0x24,0xb7, + 0x8b,0x7b,0x57,0x7d,0x9,0xaf,0x37,0xf7,0x1c,0xc5,0xe1,0x14,0xd,0x5,0x9e,0x87, + 0xaf,0x61,0x43,0xb,0x8,0xa8,0x2a,0x95,0x5a,0xaa,0x52,0xb2,0xcf,0xd0,0x8,0xa9, + 0x9d,0x45,0x6c,0xf4,0x24,0x9a,0x62,0x61,0xad,0x85,0x9f,0xaa,0x5f,0x9c,0x99,0xff, + 0x7d,0x35,0x9e,0x89,0x9d,0x18,0x33,0xce,0x9b,0x29,0x44,0x58,0x6e,0xbe,0xb1,0x4d, + 0xd1,0xf3,0xfa,0x6e,0x6d,0xa7,0x3a,0x9a,0xb6,0x1,0xe1,0xd6,0x25,0x33,0x37,0xab, + 0x57,0x9a,0x7b,0xc6,0x1a,0x96,0x84,0xf9,0xef,0xd,0xb8,0x1,0x2b,0x72,0x10,0x50, + 0xd5,0x62,0x6a,0xe9,0x53,0x12,0x43,0x74,0x50,0xf9,0xa3,0xf8,0x85,0x9e,0x6c,0x79, + 0x25,0xf5,0x58,0xd2,0xe,0x43,0x9d,0xa1,0x23,0xc3,0x95,0xd5,0xf2,0xcf,0xbb,0x14, + 0xbf,0x80,0x3,0x38,0x60,0x9c,0x37,0xd3,0x98,0x4d,0x16,0xb4,0x6d,0xd4,0xbf,0xbc, + 0xee,0xab,0xa3,0x13,0x1d,0x10,0x26,0xb6,0x33,0x56,0xf4,0x7c,0x5d,0xbd,0xcc,0xdc, + 0x53,0x45,0x35,0x95,0x9,0x56,0xf0,0x1e,0xfc,0x5,0xba,0x4a,0x24,0xa0,0x65,0x51, + 0xcb,0xbc,0xb0,0xce,0xde,0x87,0x98,0x8f,0x60,0x66,0x37,0xfd,0x43,0xb4,0x4d,0x10, + 0x91,0xd9,0x3d,0x40,0xdf,0x47,0x53,0x2b,0x78,0x3a,0x8e,0x61,0xb7,0xc1,0xa0,0x66, + 0x50,0x4b,0xc0,0x50,0x9d,0x85,0x97,0xaf,0xff,0xe7,0x91,0x63,0x6d,0x22,0x84,0xb4, + 0x7,0x4,0x57,0x7c,0x1b,0x57,0x98,0x7b,0x8e,0x60,0x3c,0x55,0x9a,0xb6,0x4,0x9f, + 0x68,0x74,0xf4,0x96,0xa1,0x24,0xfa,0x23,0x82,0xca,0xf4,0xf7,0x79,0x61,0x2d,0x1b, + 0x35,0x85,0xc2,0x41,0x66,0x7b,0x7d,0xe1,0x8f,0xe5,0x7,0xa4,0x5d,0xb8,0x16,0x89, + 0x24,0x9a,0x88,0xa1,0xa9,0xc9,0x67,0xfc,0x6,0xbe,0x99,0x78,0x8c,0x15,0x38,0x3d, + 0x79,0xba,0x3f,0x5e,0x7f,0xfe,0xae,0xfd,0x9d,0x48,0xd8,0xc8,0x5,0xf1,0x35,0xf5, + 0x42,0x73,0xcf,0xe1,0xe6,0xd8,0xd7,0xf9,0x4c,0x70,0x29,0x6e,0xc0,0x2b,0x32,0xf5, + 0x34,0xf8,0x9,0x68,0x9e,0xfc,0x2c,0x5f,0xec,0x2b,0xa6,0xa,0x27,0xb4,0xce,0xc5, + 0x55,0x39,0x3,0x91,0xb2,0x2a,0x77,0xf4,0x24,0x11,0x92,0x93,0x6d,0x64,0x96,0x5, + 0x52,0xe2,0x4c,0xfc,0x8a,0xce,0xc3,0x5a,0x3c,0xd8,0xbc,0x88,0x2b,0xcc,0x60,0x3a, + 0x59,0x47,0xd3,0x5f,0x79,0xf9,0x9a,0x5b,0xc6,0x4e,0x74,0x40,0x88,0xcb,0x7b,0x8e, + 0xdd,0xaa,0x7e,0xc5,0xfc,0xba,0xe,0xe1,0x78,0x2a,0x13,0x5c,0x89,0x1b,0xf1,0x62, + 0x84,0x77,0x2b,0xa8,0x12,0x9,0x68,0x56,0x78,0xf8,0x32,0xc6,0x62,0xa2,0x9e,0x9b, + 0x92,0x16,0xbd,0xb0,0x9a,0x1f,0x6a,0x6e,0x89,0x47,0x7b,0x1,0xad,0xbd,0x80,0xd7, + 0x4,0x7c,0xcf,0xc6,0x39,0xd8,0x66,0x54,0x1b,0xcf,0x62,0x2a,0x9,0xc3,0x75,0xea, + 0x25,0xab,0x6e,0x3a,0x3a,0x75,0xaa,0x83,0xb0,0x6b,0xd9,0x17,0xcc,0x5,0x92,0x34, + 0xe,0x35,0x67,0x6a,0xcd,0xff,0x5b,0x87,0x5b,0x1b,0x13,0xe,0xc3,0xc8,0x97,0x8f, + 0xc8,0xe5,0x27,0x98,0xad,0xc9,0x18,0xcd,0x57,0x5a,0xe6,0xba,0x16,0x9a,0x8d,0x34, + 0xc5,0xb6,0xf1,0xba,0xe2,0xa8,0xaf,0x3b,0xdf,0x25,0xce,0x68,0xe2,0xa8,0xd3,0xb1, + 0x15,0x3f,0x47,0xad,0x79,0x2e,0xd5,0x30,0x89,0x15,0x66,0x31,0xd6,0x99,0x5d,0xcf, + 0xdf,0x70,0xd3,0xe1,0x99,0x53,0x19,0x84,0x95,0xcd,0x9f,0x51,0x6f,0x30,0xbf,0xb8, + 0x3,0x98,0x48,0x41,0xf0,0xc,0xdc,0x8a,0x8b,0x2,0xb4,0x4d,0xd9,0xec,0x97,0x6c, + 0x74,0x50,0x65,0xa2,0xbc,0xd9,0xc9,0xac,0xfb,0x95,0xaa,0x20,0x9d,0xd4,0x26,0x97, + 0xa1,0x6d,0xbc,0xf4,0x63,0x48,0xd4,0x54,0xcd,0xbe,0x12,0xed,0x8d,0x8a,0x60,0xee, + 0x77,0xc3,0x3a,0x3e,0xaa,0xf,0x17,0xe2,0xe7,0x98,0x4d,0xc0,0x70,0xa5,0xf9,0xd9, + 0x9d,0x5d,0xfb,0x85,0xd3,0x6e,0x1e,0xab,0x9d,0xaa,0x20,0x54,0x3,0x1f,0x53,0xbf, + 0x63,0x7e,0xd0,0x7,0x31,0x95,0x82,0xe0,0xb9,0xf8,0x2a,0xb6,0xa,0xa9,0x65,0x7e, + 0x5,0x54,0x65,0x80,0xb5,0x2a,0x34,0x63,0x94,0xbd,0xfa,0xbc,0x24,0xbb,0xc8,0xa5, + 0xdc,0x60,0x65,0x66,0x32,0x40,0xfa,0xa,0xd7,0xfc,0x51,0x91,0xa6,0xa9,0xf6,0x51, + 0xab,0x71,0x1,0xb6,0x19,0x30,0x8c,0x30,0x91,0x84,0xe1,0x40,0xe5,0x99,0xfd,0xb7, + 0x2c,0x64,0x31,0xdb,0x2,0x82,0x70,0xe0,0x43,0xc9,0x2,0xb5,0xc3,0x98,0x40,0xb2, + 0x55,0xe9,0x2,0x7c,0x15,0x4f,0x12,0x6b,0x84,0xad,0x20,0xa0,0xb2,0x21,0x51,0x28, + 0x14,0xb0,0x65,0x55,0xd6,0xc8,0x5c,0xb8,0x10,0xa3,0x1e,0x84,0x54,0x12,0xd2,0x61, + 0x18,0x66,0x49,0xa4,0xef,0xe7,0x67,0xd2,0xac,0xc2,0xc5,0x78,0x0,0xd3,0xcd,0xb3, + 0x2b,0x4a,0xe7,0x86,0x5b,0xf5,0x45,0x97,0x7d,0x75,0xe1,0x4a,0xbb,0x17,0xc,0x84, + 0x3,0xef,0xc3,0x7b,0x93,0x10,0x3c,0x81,0x64,0xab,0xd2,0x45,0xf8,0x6a,0x62,0xf1, + 0xdd,0x22,0x2c,0xf6,0x62,0xa4,0x92,0xd0,0xc7,0x52,0x5,0x3e,0x56,0xbe,0xa3,0xdc, + 0xb2,0x8d,0x8f,0xa6,0x52,0x2,0x8b,0x16,0xbd,0x2e,0x69,0x84,0x95,0x92,0x51,0xb9, + 0x38,0x33,0xf7,0xfb,0xa,0x5c,0x8c,0x7,0x9b,0x3d,0x87,0x40,0x1d,0xd3,0xc9,0x68, + 0xf8,0xe4,0xa3,0x1b,0xab,0x5f,0x3f,0xc5,0x40,0xb8,0xf9,0x3a,0xf5,0xd7,0xe6,0xed, + 0x11,0x1c,0x43,0xb2,0x40,0x6d,0xb,0xbe,0x82,0xb5,0x62,0xc9,0x41,0x15,0xaa,0x47, + 0x16,0x7,0x58,0x95,0x69,0x12,0x5b,0xbe,0x5c,0x51,0x76,0x54,0xf1,0x34,0x55,0xb6, + 0x5e,0x3d,0x1c,0xf9,0xa1,0x3c,0xea,0x69,0x26,0xaa,0x6a,0x16,0xf6,0xcb,0xf1,0x14, + 0x3c,0x62,0x28,0xe,0xb5,0xb4,0x61,0xf1,0xd4,0xbe,0x25,0xb,0xd5,0x6f,0xb8,0x20, + 0x20,0xdc,0x72,0x15,0xfe,0xc9,0x94,0xa8,0x46,0x8d,0x86,0xdd,0xb9,0x7f,0x5b,0xf1, + 0x55,0xac,0xf,0x92,0x1c,0x8a,0xaa,0xde,0x54,0x5,0x65,0x71,0xca,0x3,0xbe,0x32, + 0x4c,0x7f,0x69,0x54,0xd4,0x9e,0x78,0xa7,0x5,0x22,0x4c,0xf9,0x2b,0x43,0xf9,0x2d, + 0xb,0x7f,0x69,0x80,0xf9,0x38,0x4b,0x71,0x11,0x1e,0x32,0x54,0x87,0x5a,0xba,0xff, + 0xfe,0xca,0xbe,0xc3,0xd5,0x7b,0x4e,0x11,0x10,0x6e,0x79,0x8a,0xfe,0x96,0x59,0x51, + 0x5b,0xc5,0xd1,0x14,0x4,0x37,0xe3,0x16,0x9c,0xb1,0x0,0x4,0x54,0x79,0x20,0x2e, + 0x3,0xbf,0x12,0x81,0xc4,0x1f,0x15,0xf3,0xbd,0x47,0xdf,0x63,0x21,0x23,0x3c,0x78, + 0x9d,0x95,0x2f,0x13,0x87,0x13,0x24,0x7e,0x35,0x55,0xb,0x48,0x30,0x77,0xb9,0x30, + 0x63,0xe3,0x32,0x3c,0x39,0x41,0x4a,0x67,0x51,0x4b,0xe,0x85,0xba,0x6a,0xcd,0xcf, + 0xc6,0xb6,0x9f,0x2,0x20,0xdc,0x7a,0xb6,0xbe,0xb3,0x19,0xe4,0x0,0x1c,0x45,0x35, + 0x5,0xc1,0x27,0xe1,0xe6,0x86,0x1c,0x93,0x5d,0x7,0x75,0x55,0x95,0x2a,0xf1,0xc9, + 0x5c,0x44,0x54,0x44,0x0,0x30,0x42,0xa,0xc0,0xf3,0x1e,0x55,0xf4,0x88,0xb,0xbe, + 0x96,0x46,0x32,0x26,0x3f,0x2c,0xea,0x81,0x25,0xa3,0xee,0xc8,0xaf,0xb1,0xc,0xe7, + 0xe1,0x1,0x63,0x7a,0xf7,0x4c,0xb2,0xc3,0xa2,0xa2,0x5e,0xbe,0xe6,0x5b,0x63,0x7, + 0x4f,0x72,0x10,0x5e,0xb0,0xaa,0x9e,0x58,0xd8,0xec,0x4,0x8e,0xa4,0x20,0xb8,0x1, + 0x5f,0xc1,0x39,0x82,0x93,0x42,0x15,0x64,0x8b,0x87,0xc4,0x33,0xbe,0xc3,0x50,0x1e, + 0x41,0xc3,0x35,0x55,0x29,0x94,0xb3,0x4f,0x13,0x87,0xe7,0xb1,0xdc,0xc4,0xb4,0x18, + 0x7b,0x44,0x5b,0xd2,0x91,0x6,0x5f,0xc1,0x2a,0x31,0xea,0xe9,0xfb,0x57,0x62,0x73, + 0xb3,0xf1,0x77,0xae,0xc3,0x42,0x99,0xc3,0x8c,0x96,0x54,0x7e,0x75,0xed,0x2d,0xd5, + 0xf1,0x93,0x19,0x84,0x5d,0xa7,0xdd,0xc,0x63,0x95,0xf9,0x69,0x1c,0x4c,0x41,0xf0, + 0x74,0x7c,0x19,0x9b,0x73,0xcc,0xa2,0xe,0x57,0x2d,0xa5,0x15,0x2a,0x6e,0xd2,0xe8, + 0x87,0xb5,0x12,0xbe,0x3a,0xdf,0x33,0x66,0xa5,0xa1,0xb2,0xa1,0x84,0xd9,0xdd,0xc1, + 0xb0,0x8e,0x7a,0x17,0x4d,0xd,0x2f,0x4f,0xe3,0x0,0x47,0x5f,0x30,0x56,0x63,0x13, + 0x1e,0x44,0xdd,0xe8,0x37,0x4c,0x74,0xdf,0xaf,0xc2,0x4b,0xfa,0xbe,0xd8,0xda,0x6e, + 0xc3,0x96,0x82,0x70,0xe0,0x63,0x30,0xea,0x63,0x66,0x71,0xa0,0xd9,0x35,0x3f,0xf7, + 0x6f,0xd,0x6e,0xc6,0x79,0xc8,0x5a,0xc0,0xa5,0x82,0xdc,0xc1,0x90,0x48,0xa5,0x84, + 0x57,0x7c,0x89,0xe,0x9a,0x3d,0x17,0xf4,0x41,0xa,0x1,0xc0,0x2b,0xb2,0x23,0x3, + 0x81,0x47,0xf9,0xed,0xfa,0x88,0xc9,0x4,0xfd,0xb1,0x93,0x8a,0xd6,0xda,0x22,0xac, + 0xab,0xb1,0x1,0xf,0x19,0xe7,0xde,0x64,0x72,0x16,0xcd,0xe9,0xfa,0xa9,0x4f,0xbd, + 0xa9,0x95,0xae,0x61,0xb,0x41,0x38,0xf0,0xa7,0xf8,0x93,0xf8,0x56,0xbd,0x31,0x3b, + 0x26,0x86,0xe0,0x52,0x7c,0x16,0x97,0x2,0x2d,0x31,0x1b,0x54,0x66,0xb2,0x2a,0x7b, + 0x44,0x57,0x24,0x53,0x28,0xb6,0xbe,0x26,0x2c,0x2a,0xca,0x0,0xeb,0xa2,0xa9,0x74, + 0x1e,0x98,0x5,0xb6,0x7c,0xe6,0x47,0xc1,0xca,0xd6,0x43,0x25,0x19,0xa3,0x79,0x7f, + 0x1c,0x8d,0xd7,0x62,0x3d,0x1e,0x6e,0xe,0x85,0xd2,0x98,0x4c,0x4c,0x66,0x53,0x5b, + 0x8f,0x3e,0xa9,0x95,0xae,0x61,0xcb,0x40,0xb8,0xf9,0x15,0xea,0x1f,0xe2,0xf3,0x52, + 0xe3,0x20,0x66,0x12,0x10,0xec,0xc2,0xdf,0xe2,0x5,0xce,0xaf,0x50,0x5,0xd,0x6b, + 0xa,0x1,0x2c,0x32,0x1f,0x45,0xc7,0x4e,0x15,0x68,0x23,0x84,0xd1,0x54,0x89,0xb6, + 0xd9,0x7a,0x71,0x86,0xef,0x88,0x77,0x53,0x4f,0x69,0x11,0x1b,0x77,0x19,0xa0,0xaa, + 0x46,0xdd,0x35,0x37,0x73,0xff,0xd6,0xa3,0x17,0x3b,0x11,0x97,0xb2,0xa5,0xa,0xbb, + 0x9f,0xbe,0x76,0xb4,0x7a,0xf7,0x49,0x6,0xc2,0x81,0xf3,0xd4,0xb7,0xcc,0x79,0x3b, + 0x47,0xac,0x42,0xed,0xf7,0xe2,0x35,0x85,0x99,0xd,0x21,0x4,0x54,0x89,0x33,0x42, + 0xc9,0xeb,0x92,0x92,0x59,0xee,0x15,0x29,0x11,0x19,0x2d,0xba,0xc3,0x50,0x46,0x85, + 0x25,0xbd,0x83,0x3e,0xb,0x9e,0xaf,0x89,0xb1,0x25,0x18,0xee,0xb1,0xb8,0x1c,0x54, + 0x7b,0xc1,0x9d,0x8c,0x8a,0x67,0x63,0xa,0x4f,0x34,0xcf,0x3f,0xab,0x86,0xe6,0xc5, + 0x6b,0xfe,0x7d,0x6c,0xd7,0x49,0x4,0xc2,0x33,0x56,0xf4,0x7e,0x17,0x1b,0xe3,0xdb, + 0x55,0xa3,0x6f,0x7e,0xee,0xdf,0x5b,0xf0,0xe,0x6f,0x16,0x98,0xa7,0xa7,0x41,0x9, + 0x15,0xd0,0xec,0x19,0xa1,0x34,0x6f,0xa4,0x6a,0x48,0x25,0xf1,0xac,0x88,0xaa,0x52, + 0x5d,0x50,0xc6,0xc8,0x13,0x59,0x37,0x3c,0x43,0x6,0x2,0xfb,0x1e,0x51,0x7b,0x5b, + 0xb0,0xec,0x5c,0x30,0xfd,0x8e,0xb6,0xe2,0x20,0x46,0x10,0xf7,0x57,0xcc,0x9a,0xae, + 0x61,0x97,0x7a,0xd9,0xfa,0x2f,0xb5,0x66,0x0,0x46,0x6b,0x40,0xf8,0x79,0x18,0x9d, + 0xf3,0xc7,0x30,0x9a,0x82,0xe0,0xaf,0xe0,0x83,0x4c,0x9b,0x6e,0x3e,0x1d,0x34,0x2f, + 0x1,0xa5,0xa2,0x62,0xf6,0xa3,0x6c,0x9a,0x5a,0xbc,0x25,0x91,0x55,0x9c,0x91,0x9c, + 0xcc,0xf2,0xc2,0x34,0x57,0xeb,0xae,0x2d,0xbb,0xb8,0x56,0x9c,0xc8,0x92,0xb,0xda, + 0xf7,0x47,0xec,0xe5,0xe2,0x7c,0xec,0x32,0xaa,0xb5,0x66,0x90,0x18,0x8f,0xb8,0x32, + 0x7a,0xd6,0xc0,0x8d,0xad,0x58,0x64,0xb4,0x5,0x20,0x1c,0xf8,0x23,0xbc,0xdb,0xb4, + 0x25,0xe,0xa5,0x20,0xf8,0x2c,0x7c,0x2,0xdd,0xe2,0x5c,0x2f,0xd4,0x16,0xcf,0x7e, + 0xe2,0xf3,0xf1,0xca,0xa5,0x70,0x4a,0xec,0x8d,0x50,0x7a,0x9d,0x5f,0x9c,0x9,0xa3, + 0x9e,0xee,0x7e,0xc2,0x50,0xd5,0xd2,0x45,0x4a,0xdd,0xe2,0x8d,0xe,0x6c,0x6b,0xd2, + 0x5e,0x58,0x6b,0x8b,0x93,0x9c,0x8f,0xed,0xc6,0x12,0xb,0x53,0xe8,0x35,0xed,0x8a, + 0x8d,0x93,0xa7,0x8d,0xdd,0x71,0x12,0x80,0x70,0xcb,0x73,0x71,0x63,0xfc,0x2c,0x75, + 0x1c,0x68,0x9e,0xe0,0x73,0xff,0xb6,0xe0,0xf3,0x8d,0x9a,0x5,0x59,0x75,0x27,0x7, + 0x35,0xd9,0x29,0x2d,0x95,0x70,0x24,0xc4,0x57,0x9,0x2c,0x7,0x1a,0x7e,0x12,0xf, + 0x51,0x79,0x5,0x95,0x10,0x71,0x26,0x64,0x19,0xb3,0x7c,0x93,0x6b,0x74,0x4e,0x57, + 0xd3,0xbd,0xe,0x93,0x76,0x44,0x70,0x5f,0x2e,0x48,0x97,0x79,0xf7,0x60,0x0,0xf, + 0x1b,0xbd,0xf7,0x29,0x9d,0xf4,0x17,0xd6,0xee,0xaa,0xde,0xbf,0xc8,0x41,0x78,0xee, + 0x59,0xea,0xfb,0x38,0xcd,0xd4,0x44,0x67,0x91,0x9c,0x1e,0xf3,0x79,0x9c,0x59,0x20, + 0xd4,0xf2,0x92,0x46,0x78,0xf2,0x37,0xfa,0x28,0x3a,0x1e,0xfa,0x62,0x5f,0xa8,0x30, + 0x12,0xfa,0x58,0xee,0x93,0x3d,0x72,0x50,0x57,0x3a,0xba,0x48,0x3b,0xc,0x5d,0x6a, + 0x28,0x57,0x19,0xe3,0xaa,0xc2,0x9,0xeb,0x9f,0xe0,0x60,0xc7,0x17,0x7d,0x2f,0xc3, + 0x6,0x3c,0x64,0x7c,0xd7,0xa9,0xce,0xfb,0xab,0xfa,0x6f,0x1f,0xdd,0xbf,0x88,0x41, + 0x78,0x79,0xcf,0xf4,0x6d,0xb8,0xd8,0x14,0x64,0x26,0x12,0x10,0xac,0xe0,0xef,0xf0, + 0xf4,0x5c,0x75,0x2c,0xd9,0x1d,0x3f,0x55,0x12,0x6c,0x5d,0xb1,0x2f,0xdc,0xfe,0x28, + 0x52,0x96,0xf1,0xbf,0xae,0x6c,0x4e,0xa3,0x6b,0x2d,0x8a,0x10,0x9d,0x94,0xaf,0x9c, + 0x91,0xc1,0xd2,0xad,0x93,0x6a,0x87,0x4e,0xba,0x1a,0x4b,0x31,0xd8,0x3c,0x2f,0xa3, + 0xa4,0x40,0xd3,0xad,0x7f,0xf9,0x8c,0x1b,0x8f,0x4c,0x2e,0x5a,0x10,0x2e,0xff,0x28, + 0x5e,0x1d,0xdf,0x3a,0x6e,0x95,0x6a,0xbf,0x1b,0xaf,0xca,0x65,0x46,0xa0,0xb0,0xa3, + 0x94,0xb7,0xb,0x3e,0xfc,0xb9,0xb2,0xcb,0x41,0xf2,0x78,0x97,0xdd,0x1d,0xa4,0xe2, + 0x9c,0x7f,0xce,0x4c,0x9e,0x36,0x5e,0x4e,0x27,0xd5,0xde,0x21,0x51,0xbe,0x95,0xa5, + 0x7c,0x35,0x33,0xf0,0xea,0xa4,0x67,0xe1,0x18,0xe,0x1a,0xdd,0x15,0x30,0xeb,0x49, + 0xd7,0xd4,0x9f,0x5c,0xfd,0xf2,0x22,0x5,0xe1,0x96,0xab,0xf4,0x47,0xe3,0xc0,0x30, + 0x8b,0xc3,0xcd,0xa,0x85,0xb9,0x7f,0x2f,0xc5,0xff,0xc8,0x18,0xd5,0x68,0xe3,0x42, + 0x9,0x8e,0xa,0x7,0x46,0x38,0xac,0xb3,0x5f,0x1c,0xc2,0x8f,0xd,0x9f,0xf0,0x9d, + 0xe5,0x12,0xe0,0x7b,0xf4,0xd0,0x1,0xf8,0xae,0x95,0xed,0x7d,0x5d,0x14,0xee,0xa8, + 0xe6,0xcb,0x2b,0x23,0x36,0x63,0x3c,0x17,0xbb,0x8d,0x69,0xb7,0x53,0xe8,0x45,0x4f, + 0xfc,0x80,0x17,0xac,0x39,0x5c,0xe6,0x3a,0xbf,0xa5,0x4d,0xe0,0xde,0xba,0x3e,0xda, + 0xd6,0x4c,0xf7,0x10,0x61,0xbf,0xd1,0x40,0xa2,0x0,0x5c,0x88,0x2f,0x35,0xe4,0xe0, + 0xf0,0xc6,0xa1,0x2c,0xf1,0x2e,0x2b,0xb5,0x2c,0x22,0xf6,0xf9,0x9,0xa6,0xa,0x50, + 0x81,0x8b,0x5f,0x55,0x91,0xcb,0x15,0x75,0x86,0xc2,0xb4,0xc8,0x61,0x6c,0xb8,0x86, + 0x39,0x69,0x36,0x6,0x52,0x8f,0x1e,0x31,0xd4,0x34,0x22,0x54,0x55,0xfb,0x1e,0xaa, + 0xef,0x42,0xe3,0x4,0x6e,0xc4,0xb1,0xe6,0xbd,0x15,0x6c,0x30,0xeb,0x49,0xa7,0xf0, + 0xac,0xc1,0x7,0x16,0x5b,0x24,0x54,0x6b,0x6e,0xc6,0xd3,0xe2,0x9b,0x87,0x8c,0x56, + 0x4a,0x5,0xa0,0xf,0x9f,0x6d,0xc,0xaf,0x8,0x8d,0x77,0x34,0x75,0xd4,0x81,0xf0, + 0x29,0xa,0x5e,0xc5,0x5c,0x28,0xf2,0xd2,0xd4,0x22,0x57,0x73,0x92,0x59,0x21,0xae, + 0x5c,0x2f,0x4f,0xcc,0xf6,0x1b,0xf5,0x5a,0x28,0x1a,0xf9,0x6b,0x66,0xd2,0xb0,0xef, + 0xc1,0x59,0x78,0xb4,0x59,0xd6,0xad,0x93,0x15,0x34,0xdd,0x78,0x6e,0xff,0x67,0xcb, + 0x9a,0xc8,0x56,0x12,0x8,0xb7,0xfc,0x21,0xde,0x1e,0xdf,0x1a,0x4f,0x8c,0xb5,0x7, + 0xba,0xf1,0x31,0x5c,0x5c,0x9a,0xc5,0x1e,0x1e,0xcf,0x54,0xe,0xc0,0x2a,0x94,0x5d, + 0x9b,0x5a,0xd4,0xb4,0xf0,0x7c,0x96,0x85,0x16,0x5e,0x16,0xa8,0xe1,0x19,0x32,0x9d, + 0x54,0x33,0xd4,0x11,0x4e,0x10,0x45,0x9e,0xfb,0xdd,0xb9,0xa0,0xb9,0x5f,0x63,0x15, + 0x96,0x62,0x18,0x71,0x5,0x8d,0x36,0xad,0xfb,0x33,0xb1,0xac,0xfa,0x9d,0x45,0x4, + 0xc2,0xad,0x17,0xe9,0x5b,0x62,0x4a,0x3d,0x83,0xc3,0x29,0x7b,0xfe,0x5d,0xf8,0x55, + 0xef,0xa9,0xe3,0x8b,0x77,0x14,0x85,0x93,0x44,0x1f,0x95,0x23,0x9e,0x29,0x81,0xd, + 0x51,0x54,0xad,0x4e,0x5a,0x20,0x2a,0xc3,0xb2,0x40,0x80,0x8e,0x4a,0x9b,0x10,0x3e, + 0xdb,0x5c,0x3b,0x5e,0x25,0xf7,0xba,0xf8,0xfc,0x4e,0x7b,0x9b,0x8c,0x25,0x1e,0xa2, + 0x76,0x0,0xfa,0xc,0x8c,0x1a,0xb,0xf2,0x4d,0x63,0x89,0x99,0x19,0x3e,0x67,0xed, + 0xdd,0xd5,0x1d,0x8b,0x24,0x27,0xdc,0xba,0x24,0xfa,0x9,0x2e,0x8b,0x3f,0x86,0xfd, + 0x29,0x6f,0xf0,0xa,0x7c,0x12,0x15,0xa1,0x79,0x1e,0xe6,0xe8,0xe5,0x21,0x98,0x3e, + 0xcb,0x42,0x39,0x2f,0x11,0xa1,0x12,0x50,0x78,0xa7,0x7f,0xde,0xf5,0xa5,0x28,0x50, + 0x14,0xd5,0x45,0xe1,0x36,0xea,0xb9,0xf5,0x96,0x22,0x22,0x2a,0x49,0xd6,0x5e,0xb2, + 0xf3,0x3b,0x3b,0x17,0xa4,0xf3,0x3f,0x2e,0x63,0xd4,0x46,0x66,0x38,0x8b,0x2f,0xa3, + 0xda,0xbc,0xa7,0x82,0xd,0xa6,0x75,0xbf,0xaf,0xeb,0xb2,0xed,0x47,0x16,0x45,0x24, + 0x5c,0xf3,0x97,0x8d,0x35,0xcc,0x0,0x0,0x55,0xa3,0x28,0x8,0x50,0xe8,0xc7,0xa7, + 0xb0,0x1c,0x7c,0x4d,0x8c,0x12,0x96,0x94,0xe5,0x1,0xa4,0xf2,0x46,0x4,0xd7,0x89, + 0xaf,0x10,0x56,0x13,0x93,0x57,0x2d,0x95,0xc5,0xbb,0xbc,0x12,0x8e,0x2b,0x36,0x6a, + 0x4f,0x2c,0x44,0x46,0x2,0xea,0x52,0x33,0x29,0xdb,0x24,0xb2,0x22,0x19,0x6f,0x59, + 0x68,0xa7,0x4e,0xaa,0x99,0xf9,0xa4,0x40,0x5,0x67,0xe2,0x51,0xe3,0x2c,0x99,0xc1, + 0xca,0xf8,0x9,0x56,0x45,0xe7,0x57,0x6f,0x5a,0x4,0x20,0xdc,0xfc,0x12,0xf5,0xf1, + 0xf8,0xcc,0x9c,0x4a,0xad,0xb6,0x5b,0xc1,0x47,0x71,0x5e,0x80,0xcd,0xe0,0x3f,0x59, + 0x15,0x7c,0x95,0x35,0x72,0xc0,0x2a,0xc1,0x73,0xa1,0x24,0x71,0x26,0x24,0x8b,0x2b, + 0x52,0x9c,0xf1,0xc1,0x4d,0x6,0xd8,0xc8,0xfb,0x2a,0xe9,0x2a,0x99,0x30,0xa3,0x1e, + 0xb0,0x8b,0xb2,0xe1,0xcc,0x61,0xb5,0x48,0x96,0x49,0xfe,0xd5,0x32,0xf4,0x60,0xb7, + 0x31,0x18,0xb1,0xb,0x4b,0xe2,0x27,0xba,0x70,0xcd,0xbe,0xb1,0xfb,0xda,0x1c,0x84, + 0x3,0xa7,0xa9,0xef,0x60,0xf5,0xfc,0xad,0x3a,0xe,0xa6,0xbc,0xc1,0x37,0xe1,0xd5, + 0x1,0xc3,0x2b,0x54,0xee,0xa,0x16,0x49,0x4,0x95,0xb9,0x83,0x4a,0x74,0xec,0x42, + 0x88,0x33,0x5c,0x8c,0x2a,0x5e,0x9c,0xa1,0xb2,0xb9,0xbc,0xe3,0x9d,0xdc,0x95,0x35, + 0xda,0xf1,0x2a,0xdc,0x20,0xf3,0xd,0x4,0x6,0x4b,0x56,0x81,0x33,0x70,0x4,0x63, + 0xc6,0xf0,0x8b,0x15,0x26,0x25,0x7d,0xe1,0x69,0x5f,0x1c,0x1b,0x6b,0x6b,0x10,0xf6, + 0x7d,0x14,0xbf,0x14,0xdf,0x3a,0xdc,0xc8,0x6,0xe7,0xdf,0xce,0x53,0xf0,0x41,0x6f, + 0xdb,0x6a,0x51,0x36,0x82,0xca,0x9c,0x11,0x2a,0x64,0x97,0xf3,0x43,0xa0,0x26,0x75, + 0xf,0x11,0xc,0x58,0x19,0x4d,0xe5,0x48,0x9f,0xf4,0x3d,0xf8,0xe0,0x13,0x42,0x40, + 0x8b,0x28,0x52,0x8b,0x18,0x39,0x26,0x7e,0x46,0x77,0x87,0xa1,0xf9,0xf8,0xe7,0x60, + 0xa7,0x61,0xaa,0x25,0xcc,0x8a,0x5e,0x75,0x69,0xf5,0xb,0x6d,0xc,0xc2,0xcd,0xcf, + 0x53,0x7f,0x17,0xbf,0xda,0x63,0x8d,0xd1,0xf6,0xf3,0x6f,0x65,0x35,0xfe,0x1e,0x6b, + 0x32,0xf7,0xe8,0x85,0x64,0x79,0xca,0x69,0x23,0x64,0x3,0x19,0xa,0x50,0x66,0xc3, + 0x8e,0xf2,0x9d,0xf8,0xd9,0x3d,0x44,0x59,0x5d,0x50,0x96,0xe1,0x16,0x9c,0x2,0xa, + 0xa7,0x5a,0x2a,0x8b,0x7d,0xee,0x8c,0xd1,0x1f,0x1b,0x7d,0x6d,0x4d,0xe6,0xde,0x2e, + 0xf4,0xe3,0xf1,0xe6,0xf7,0x5c,0x4f,0x9a,0x15,0x9b,0xd7,0xec,0x18,0xdb,0xd6,0xa6, + 0x20,0xdc,0xb4,0xb4,0xf2,0xcd,0x78,0x5,0x97,0x59,0x1c,0x46,0x72,0x81,0x97,0xf7, + 0xe1,0xe9,0x99,0x4f,0x56,0x25,0x2c,0x4f,0xe3,0x85,0x93,0xb0,0xd8,0xa9,0x4,0x52, + 0x4c,0x79,0xb9,0x60,0xf8,0x6a,0x4e,0x8,0x0,0x5c,0xf8,0x1a,0x86,0x2e,0xd8,0x4a, + 0xc6,0xe4,0x4b,0xac,0xa,0xed,0x98,0x32,0xc3,0xad,0x3e,0xe8,0x87,0x9d,0x9f,0x80, + 0xa6,0xbd,0xc2,0xf9,0xbf,0x58,0x85,0x59,0x1c,0x6a,0x26,0x22,0xd3,0x89,0x79,0x6c, + 0xea,0x79,0xfd,0xff,0x38,0x3a,0xd1,0x96,0x20,0xec,0xff,0x73,0xfc,0x46,0x7c,0xeb, + 0x48,0x73,0x96,0xda,0xdc,0xcf,0x57,0xe0,0x3a,0x48,0xaa,0x5d,0x7c,0x27,0xab,0x12, + 0x64,0x81,0x21,0x80,0xb,0x79,0x14,0x15,0x94,0x63,0x66,0xaf,0x3d,0x95,0xf5,0x3, + 0x86,0x28,0x9c,0xf9,0x96,0x54,0xb,0x37,0x49,0x34,0x63,0x8c,0x68,0xe7,0xb4,0x19, + 0x77,0xef,0xa0,0x1d,0xc1,0x22,0x11,0x75,0x95,0xda,0xf5,0x76,0x51,0xf7,0x10,0xa6, + 0x9b,0x30,0x9c,0x31,0x29,0xe9,0x72,0x7d,0x56,0xf5,0x6b,0x6d,0x8,0xc2,0x81,0x4b, + 0xf0,0xf9,0xf8,0xd1,0x8e,0x27,0x6a,0x64,0x14,0xd6,0xe3,0xaf,0xd1,0x9b,0xa1,0xc4, + 0x3a,0x6b,0x7e,0x56,0x4,0x1,0x75,0xc5,0x46,0x49,0xdf,0x7d,0x39,0xe2,0x8c,0x62, + 0x81,0x1a,0x6,0x38,0x79,0x6c,0xd4,0x8e,0x3e,0x44,0x69,0xb3,0xaf,0xbc,0x59,0x18, + 0xa0,0xda,0x8f,0x68,0xea,0xa,0x91,0x19,0x31,0xf7,0x8f,0x2f,0xdd,0x4e,0x7b,0x93, + 0xba,0xf9,0x49,0x9f,0x8e,0xed,0x4d,0x61,0xb1,0x9e,0x9c,0xd4,0x7d,0xe9,0x9a,0xfb, + 0x8a,0x5b,0xb5,0xa2,0x28,0x10,0x56,0xd6,0x7c,0x4d,0x9d,0x1b,0xab,0xa2,0x87,0x9b, + 0x57,0x90,0xb9,0x7f,0x1f,0xc0,0xf9,0x2,0x43,0xdb,0x57,0x13,0xa3,0x84,0xe6,0x39, + 0xf,0x48,0xe9,0x3d,0xc9,0x93,0x5d,0x4e,0x69,0x5b,0x67,0x56,0x40,0x0,0x1f,0xbf, + 0x38,0x13,0xce,0x22,0x64,0xbf,0x47,0x22,0xc0,0xc9,0x87,0xfc,0x6a,0x2f,0x35,0xa5, + 0x63,0x76,0x3a,0xf7,0x8b,0x3c,0x51,0x31,0x9,0xd8,0xa5,0x88,0x8c,0x19,0xf1,0xd3, + 0x58,0x66,0xaa,0xa4,0x57,0x6c,0xb8,0xa1,0xa8,0xb5,0xee,0xb,0x2,0xe1,0xc0,0x3b, + 0xd5,0x75,0xf1,0xad,0x91,0x54,0x8d,0xcc,0xcb,0xf1,0x5f,0x4,0xa7,0xa1,0x3c,0x5e, + 0x69,0xc6,0x9,0x74,0x4b,0x38,0x8a,0xed,0x98,0xcf,0x6a,0x5c,0x28,0x94,0x2d,0xce, + 0x94,0x53,0x33,0x23,0x17,0x7a,0xb2,0xce,0x27,0x85,0x5,0x35,0xb0,0x64,0x55,0x36, + 0x65,0xd4,0xd,0xb2,0x3c,0x4,0x34,0x99,0x13,0x26,0xff,0x9d,0x8e,0x27,0x9a,0xc5, + 0x26,0xc0,0x34,0x56,0xc5,0x2f,0xfa,0xb4,0xda,0x8a,0xea,0x1d,0x6d,0x4,0xc2,0xcd, + 0xe7,0xaa,0x5b,0xe2,0xf9,0x38,0x93,0x18,0x4b,0x2c,0x7a,0xdd,0x8f,0x8f,0x60,0x69, + 0x10,0xd,0x75,0xc9,0x32,0x45,0x5d,0xbf,0xf3,0x64,0x94,0xad,0x16,0x67,0xfc,0x6, + 0x1,0xf7,0xea,0x25,0x45,0x6a,0x61,0xcd,0xbe,0xbe,0xb2,0x6d,0x5f,0xc1,0x9c,0xeb, + 0x7d,0x6b,0xcf,0x8,0x60,0x57,0x51,0xb6,0x6b,0xde,0xb6,0x8b,0x80,0x6a,0x52,0x96, + 0x89,0xff,0x62,0x1d,0x1e,0x6f,0xb2,0xba,0x8,0xca,0x34,0xee,0x9f,0xb5,0xf6,0x7b, + 0xd5,0x3d,0x6d,0x3,0xc2,0xb5,0x5f,0xc0,0x25,0x71,0xce,0x70,0x8,0xc9,0xfe,0xf9, + 0xf,0xe0,0x82,0x80,0x32,0x30,0x77,0x5d,0xa6,0x84,0x5a,0xba,0x62,0xa3,0x12,0x69, + 0xae,0x2a,0xa3,0x10,0x54,0x7c,0x2e,0x98,0x4f,0x96,0x9,0x69,0x68,0x2a,0x36,0x36, + 0xba,0xff,0x22,0x22,0x9e,0x23,0x64,0xb0,0x13,0xbf,0x50,0xa8,0xfd,0x3e,0x7c,0x4, + 0xd4,0x8e,0x82,0xc9,0x57,0xb1,0x4,0xa,0x7,0x8c,0x66,0x5f,0x63,0x4e,0xb7,0xc2, + 0xe5,0xd5,0x1b,0x3c,0xeb,0x6,0xb4,0xa,0x84,0x3,0x2f,0xc2,0x7,0xe3,0x5b,0x55, + 0x4c,0xc3,0x74,0x7,0xaf,0xc2,0x1b,0x11,0xd6,0x38,0x54,0x56,0xd4,0x53,0xc1,0x47, + 0xa9,0x0,0x4a,0xdc,0x2a,0x40,0xfa,0xb2,0xbf,0xa2,0x65,0x19,0x78,0xa3,0xa2,0x7c, + 0xf5,0x42,0xed,0x88,0x8d,0x7e,0x71,0xc6,0x6f,0x4c,0x48,0xa0,0xe6,0xee,0xa2,0xa0, + 0xca,0xbb,0xd7,0x61,0x6f,0x63,0x7d,0x5f,0x34,0x54,0xd2,0xe6,0x76,0xe6,0xda,0x27, + 0xaa,0xf7,0xe6,0x47,0x50,0xee,0x2e,0x8a,0x17,0x74,0xef,0xfe,0x19,0x9e,0x32,0x7f, + 0xcb,0x5c,0xec,0x6c,0xae,0x79,0xf7,0x9f,0xb0,0x16,0xd9,0xba,0x11,0x5c,0x76,0xbd, + 0x12,0x54,0x8a,0x2a,0x26,0x7f,0x83,0xc8,0xfe,0x68,0x87,0x5c,0xd0,0x17,0x51,0xb2, + 0xe7,0x8d,0x5c,0x67,0x45,0x71,0x2b,0x56,0xe8,0x94,0x9e,0xea,0xee,0x98,0xd7,0x9e, + 0x5e,0x7a,0xcd,0x56,0xc8,0x50,0x4,0x94,0xeb,0xa2,0x8f,0x88,0xbc,0x31,0xb2,0x48, + 0x69,0xf2,0x19,0x23,0x0,0x87,0xf0,0x1d,0xe3,0xfe,0x7e,0x73,0xc,0xd4,0xe1,0xe8, + 0xfc,0xe1,0xb1,0x5,0x8f,0x84,0xea,0x6d,0xea,0x8d,0xf1,0xd7,0x79,0xb8,0xd9,0x99, + 0x3c,0xf7,0xf3,0xcf,0xf0,0x64,0x31,0x69,0x6c,0x45,0xd4,0xb,0x2d,0x4f,0x93,0x80, + 0x24,0x4b,0x4f,0xa3,0xef,0x28,0x88,0xe1,0x53,0xe6,0x72,0xa2,0xfe,0x15,0x74,0xb3, + 0x3,0x56,0x93,0xf1,0xce,0x3d,0x1,0x3c,0xb2,0xe2,0x69,0x3e,0x2,0x4a,0x45,0x45, + 0x4a,0xac,0x59,0x81,0x13,0x18,0x6b,0xc6,0xac,0x84,0x63,0xb8,0x42,0xf5,0xe6,0x6f, + 0xf5,0xcd,0x19,0x9,0x37,0xf6,0x75,0x3d,0xae,0xfa,0xe7,0x6f,0x1d,0x43,0x35,0xe1, + 0xe,0x3e,0x13,0x7f,0x23,0x54,0x1a,0xa5,0x66,0x84,0xf2,0x46,0x4d,0x3e,0xea,0xf1, + 0x19,0xa5,0x1f,0xb0,0xbe,0x67,0x94,0x2,0x52,0x65,0x30,0xd7,0xf3,0xe5,0x85,0x7e, + 0x82,0x1a,0x79,0x63,0xa7,0xf6,0x46,0x4d,0xaa,0xc4,0x4c,0x3a,0x26,0x5f,0x32,0x47, + 0x6,0x4c,0x4,0xf4,0x45,0xba,0xf8,0x2f,0x25,0xc7,0xa6,0xef,0x89,0xf7,0x4c,0xe3, + 0x9b,0x98,0x6a,0x1e,0xb9,0xa,0x7d,0xf1,0x47,0x36,0xab,0x2f,0x19,0x7a,0x6c,0x41, + 0x23,0xe1,0xba,0xbf,0x6c,0xac,0x67,0x6,0x20,0xc2,0x48,0x13,0xd7,0xa,0x40,0x2f, + 0xfe,0x6f,0xa3,0xa1,0x42,0x6e,0x23,0xb8,0x33,0xaf,0x50,0x10,0xc1,0x63,0x56,0xc8, + 0x9,0xa8,0x3f,0x57,0xf4,0xb5,0x4,0xa7,0x8f,0xca,0xd6,0x87,0x98,0x7d,0xfc,0x93, + 0x8c,0xde,0x16,0x19,0xf5,0x24,0xaf,0x54,0x52,0x14,0xe0,0xb2,0xe8,0x7d,0xa,0xa8, + 0x6c,0x2e,0xb7,0x7f,0x70,0x7f,0x17,0x96,0x60,0x1f,0xe2,0x35,0x2b,0x8c,0x29,0xdd, + 0x5d,0x6a,0x53,0xf5,0x4b,0xb,0x8,0xc2,0x73,0x9f,0xac,0x6e,0x88,0x1f,0xa1,0x8a, + 0xe9,0x84,0x35,0xf1,0x6,0xbc,0xd0,0x1b,0xa9,0xdc,0x16,0xbc,0x8c,0x86,0xaa,0x8c, + 0x51,0x4f,0xe5,0xa0,0xa9,0xd9,0x27,0x78,0xe7,0x9b,0x3,0xe,0xe1,0xa5,0x8b,0x16, + 0x46,0xc2,0x6,0xd1,0x87,0xa7,0x4,0xbe,0x61,0xfa,0x69,0xd2,0xe8,0x1a,0xa,0xc, + 0xf,0x3c,0xa8,0xc7,0x72,0x97,0x87,0xd3,0xd3,0xe0,0xe8,0xec,0xd4,0x8e,0xb6,0x6b, + 0x70,0xa8,0x39,0xba,0x1a,0xa8,0x99,0x79,0xe1,0xf9,0x6b,0x7f,0x92,0x6f,0xec,0x45, + 0x2e,0x10,0xae,0xbb,0x11,0xe7,0x37,0xa3,0x32,0xaa,0x9,0x8,0xae,0xc7,0xfb,0xd1, + 0x1d,0x58,0x52,0x96,0x3d,0xea,0x49,0x2c,0xfa,0x7c,0xd9,0x67,0x88,0x71,0x91,0xa5, + 0x25,0x38,0xa4,0xb3,0x41,0x46,0x33,0xe5,0x91,0x2a,0xcc,0xd8,0x8,0x53,0x53,0x7d, + 0x86,0xbb,0xbb,0x84,0x9b,0x86,0xa2,0x3f,0xd7,0xf3,0x8d,0xaa,0xd2,0xe0,0x97,0x15, + 0xa5,0x1f,0x4d,0x63,0x2d,0x86,0x9a,0x9c,0x68,0x36,0x31,0x97,0x54,0x5d,0x3e,0xf0, + 0xf,0x79,0x56,0x6f,0xca,0x1,0xc2,0xcd,0xaf,0xc0,0x9f,0xc5,0xb7,0x46,0x50,0x4f, + 0x58,0x13,0x7f,0x8c,0xf3,0xbc,0x96,0x84,0xe4,0xf4,0x57,0x41,0x11,0xd4,0xff,0x28, + 0x2a,0xf8,0xb5,0x68,0x81,0xe8,0xe3,0xef,0x8c,0xc,0xa1,0x9e,0x21,0x59,0x20,0x82, + 0xc8,0x9f,0xef,0x28,0x1d,0x10,0x15,0x25,0xfd,0x13,0x5c,0xde,0xa8,0x3d,0xab,0xe9, + 0xba,0x5d,0x40,0x17,0x9c,0x7c,0x96,0x5,0x5f,0x4f,0x4a,0xf,0xd0,0x8f,0x5f,0x43, + 0x2f,0x66,0x31,0xd2,0xf8,0x2e,0x55,0xb2,0xc7,0x70,0xfd,0xf4,0xe1,0x3c,0xeb,0xfa, + 0x66,0x16,0x66,0x5e,0xd0,0xbd,0xfb,0xa1,0x38,0xe,0x4e,0xe2,0x48,0xc2,0x9a,0xb8, + 0xc,0x1f,0x6d,0x9c,0xf8,0x4a,0x64,0x33,0xb8,0x20,0xe3,0x8b,0xa0,0x3e,0xa8,0xb9, + 0x8f,0x75,0xc5,0x3b,0x79,0x4,0xcd,0xd2,0xc9,0xdf,0xe,0xb2,0x4c,0xb9,0x83,0x9f, + 0x68,0x7b,0x82,0x82,0x21,0x25,0xd1,0xf0,0x83,0x7b,0x43,0x87,0xfc,0x52,0xb5,0x31, + 0x94,0x5c,0xe3,0xb2,0x2c,0x22,0x0,0x33,0xf8,0x36,0xa6,0xd,0x82,0x6a,0x14,0xb1, + 0x8d,0x46,0x5b,0xb2,0x5b,0x15,0x99,0x23,0x61,0xe5,0x8d,0x78,0x73,0xfc,0xe5,0x1d, + 0x49,0x58,0x13,0xdd,0xf8,0x8b,0xc6,0x68,0x5f,0x5e,0x1,0x55,0xf0,0xbb,0x70,0xfe, + 0x48,0x45,0x81,0x54,0xa5,0x68,0x2a,0x44,0x50,0xc,0x71,0x7,0xc3,0x73,0x41,0xb7, + 0xd0,0x93,0x5d,0x96,0xc9,0xb2,0x86,0x21,0x44,0x50,0x73,0x49,0x25,0x72,0xc0,0x72, + 0x99,0xa9,0x4b,0x61,0xa5,0x26,0x8f,0xba,0xa2,0xa0,0x7c,0xc8,0xaf,0xcf,0xb8,0x30, + 0xed,0xd,0x2a,0xc2,0x76,0xa1,0x62,0xf4,0x18,0xce,0x98,0xd5,0x33,0xcb,0x30,0x3b, + 0xf6,0x6f,0x2d,0x6,0xe1,0xe5,0x3d,0x93,0x37,0xab,0xbe,0xd8,0x9a,0x98,0x4c,0x58, + 0x13,0xbf,0x89,0x97,0xc0,0xdf,0xd9,0x20,0xd5,0x49,0x25,0x59,0x1a,0x9c,0x50,0xf3, + 0xc7,0x59,0xb9,0xe0,0x92,0x77,0x76,0x77,0x96,0xaa,0x53,0xe5,0x10,0x4a,0x38,0x28, + 0x22,0x0,0xb0,0xbe,0xc7,0xd2,0xe2,0x8b,0x42,0xf2,0xb7,0xc8,0xab,0xc3,0xba,0x97, + 0xc7,0x76,0x13,0x51,0xfe,0xb9,0xf8,0x22,0x34,0xee,0x1e,0xed,0x69,0x8e,0x9a,0x7, + 0xe5,0x1a,0xec,0x6f,0x8e,0xbd,0xd0,0x88,0x8c,0x7e,0x7b,0x75,0x79,0xff,0xd,0x59, + 0x1b,0x7d,0x33,0x82,0x70,0xd9,0xef,0xaa,0x6b,0x4d,0x6b,0x42,0x1b,0xd9,0xe0,0x69, + 0xf8,0x73,0xf4,0x8,0x27,0x9e,0x85,0xc9,0x32,0x8a,0x3c,0x99,0xdd,0xc7,0xf2,0x50, + 0x74,0x13,0xc8,0x7c,0x79,0x63,0x96,0xd8,0xe8,0x3,0x86,0xd4,0x8e,0x97,0x2c,0xe5, + 0x19,0xbe,0xa2,0x85,0xce,0x58,0x9b,0x1a,0x46,0x76,0x79,0x8,0xfa,0xa6,0xa7,0x85, + 0x8c,0xb3,0xb0,0x29,0x27,0xc8,0x5c,0x90,0xa2,0xb4,0x4b,0xd,0xab,0x62,0x16,0xcb, + 0xe3,0x58,0xd8,0xab,0x75,0xf5,0x7b,0x2d,0x4,0xe1,0xd6,0x25,0xfa,0x96,0x78,0xe9, + 0xcf,0x71,0x4c,0x25,0x74,0xd1,0xeb,0x70,0x69,0x61,0xe6,0xb9,0xf2,0x3c,0x8a,0x14, + 0x8a,0xbe,0xa8,0x19,0xe2,0x57,0x86,0xc7,0xbe,0x7c,0x13,0xe2,0xc2,0xe7,0x65,0x6b, + 0xd1,0x63,0xe9,0x40,0xf,0xd1,0x65,0x7b,0x68,0x91,0x5c,0xa3,0x1d,0xf1,0x96,0x5b, + 0x83,0x9e,0xce,0x5a,0xe9,0x7b,0x34,0x7c,0x63,0x31,0x24,0x1d,0xf5,0x60,0xc5,0x19, + 0xd,0x60,0x25,0x46,0x9b,0x56,0x85,0x46,0xd4,0x58,0x65,0x1a,0x0,0xf0,0xd4,0x35, + 0x9f,0x1e,0x3b,0xd1,0x32,0x10,0xf6,0xfd,0x1,0x5e,0x33,0xff,0x7b,0x1d,0xa3,0xd, + 0xca,0x34,0x7,0xc1,0x33,0xf0,0x9e,0xc6,0xd5,0xc1,0x3e,0x7d,0x65,0x3a,0xa9,0x12, + 0xa,0x2a,0xda,0x9b,0x3d,0x2a,0x7,0x54,0xf9,0xda,0x54,0x57,0xfe,0xa6,0x82,0xe0, + 0x13,0x46,0x3d,0xd3,0xa7,0xa7,0xf2,0x12,0xf2,0x90,0x6,0x5d,0x8d,0xf0,0xda,0x54, + 0x7e,0xa4,0x92,0x34,0x23,0xd4,0xde,0x68,0xab,0xd9,0x95,0xa1,0x64,0xd,0x4b,0xee, + 0x3e,0xa,0x97,0x42,0xca,0x75,0xd4,0xbb,0x16,0x34,0xd5,0xd0,0x58,0x8d,0xdd,0x4d, + 0x55,0x73,0xd6,0xb4,0xed,0x7b,0x55,0x57,0xf5,0xdb,0x2d,0x2,0xe1,0xa6,0xa5,0xea, + 0xa6,0x78,0xb6,0xe8,0x38,0x66,0x12,0xba,0xe8,0xdb,0x1a,0xc3,0x7d,0xdd,0x32,0x2, + 0x57,0x43,0x2a,0x15,0x5f,0xa4,0x59,0xa0,0x3f,0x82,0x66,0x8d,0x8d,0xf9,0x2c,0x87, + 0xb0,0xc7,0x2a,0x46,0x27,0xf5,0x1f,0xa5,0x3d,0x11,0xd6,0x4d,0x67,0x69,0x22,0xe9, + 0x2f,0x1d,0xa0,0x2e,0x14,0xae,0x48,0xe8,0x8e,0x80,0xae,0x8c,0x2f,0xf2,0xb8,0x88, + 0x11,0x9b,0xb,0x9a,0xb7,0x7a,0x30,0x89,0xf1,0xe6,0x39,0x5f,0x37,0x63,0xe1,0xd3, + 0xfa,0x3f,0x37,0x3a,0xde,0x12,0x10,0xf6,0xbd,0x53,0xbd,0x2a,0x19,0x7,0x63,0x8, + 0x6e,0xc4,0x3b,0xd8,0xb8,0xa1,0x82,0x32,0x3e,0xd7,0xc9,0x1a,0x9e,0x5,0xca,0x4e, + 0x79,0x15,0x24,0x1,0xe5,0xb7,0x1c,0x24,0xf9,0x99,0xa,0x6e,0xe3,0x2d,0x5a,0x27, + 0xd,0x59,0xa7,0xc9,0x26,0x8d,0x14,0x35,0xe5,0x9,0x28,0xd8,0x78,0x95,0x35,0x17, + 0xf4,0x67,0x99,0xae,0xd2,0x6d,0x90,0x47,0xad,0xc2,0x9e,0xe6,0xa5,0xbc,0x66,0xe, + 0xbd,0xe8,0xd6,0x4b,0xab,0xdf,0x6a,0x1,0x8,0xcf,0x58,0xd1,0x7b,0x73,0x5c,0xb3, + 0x33,0x8e,0x99,0x84,0x2e,0xfa,0x47,0xd8,0x18,0x64,0x49,0xc8,0xe2,0x1d,0xd,0xf, + 0x5,0x59,0x11,0x9b,0xa,0xa2,0x8e,0x2e,0x41,0x45,0x95,0x22,0xcb,0xd0,0x97,0x82, + 0x6c,0xb9,0x62,0x19,0x3a,0xa9,0x5b,0x3b,0xd,0x59,0x54,0x54,0xa,0x48,0x14,0x90, + 0xb,0xf2,0x11,0x91,0x1a,0x6e,0x41,0xf,0xa,0x8e,0x69,0x6a,0xf2,0xf1,0x7b,0x30, + 0x85,0xa3,0xc6,0xa0,0x7c,0xa3,0x84,0xed,0xa9,0xab,0x6f,0x3c,0x3a,0x56,0x3a,0x8, + 0x4f,0xff,0x6f,0xea,0x57,0xe3,0x2f,0x60,0x14,0x66,0x95,0xcc,0x5,0xb8,0x2e,0xc0, + 0x20,0x70,0xd7,0xb1,0xf8,0x32,0x46,0x77,0xb4,0x55,0x4e,0x89,0x47,0x26,0x4,0xf9, + 0x25,0xa0,0xbc,0xb1,0xb1,0x88,0x5c,0x4f,0x3a,0x30,0x38,0xeb,0xa2,0xa4,0xd9,0x97, + 0x1b,0x75,0xc7,0x41,0x4e,0xf,0xf5,0x77,0xce,0x87,0xe4,0x82,0x91,0x57,0x2e,0xa2, + 0x2a,0x45,0xed,0xda,0x1e,0x9d,0x22,0xb3,0x73,0xb1,0x70,0x7e,0x34,0xf0,0x52,0xa3, + 0x9c,0xbb,0x6b,0x45,0xf5,0x1b,0xa1,0x98,0xa,0xac,0x98,0xd9,0xb0,0x7c,0xe9,0xae, + 0x78,0xc0,0xef,0x18,0x8e,0x27,0xba,0x7,0x3f,0x84,0xcb,0xbc,0x27,0xb6,0xf2,0xc4, + 0x3b,0x5b,0xc2,0x9,0xa3,0x99,0x72,0x89,0x47,0xe,0x9,0x78,0xad,0x96,0xd0,0xd8, + 0x28,0xa1,0xa1,0xad,0xab,0x9c,0xb1,0xd5,0x54,0xe9,0x64,0x1a,0xed,0x99,0x10,0x3, + 0x8f,0x20,0xe2,0xaa,0x96,0xa1,0x4d,0x74,0x97,0x94,0xe2,0x6a,0xe6,0xd5,0xe,0x3, + 0xc2,0xd5,0xd6,0x44,0x2d,0x9f,0x6,0x68,0x3c,0x8c,0x3d,0xcd,0xdf,0x97,0x60,0x7d, + 0xfc,0xe1,0xcd,0xaa,0x2d,0x3b,0x3,0x27,0xcf,0x4,0x46,0xc2,0x75,0xbf,0xab,0x5e, + 0x1d,0xe7,0x83,0xd5,0x4,0x4,0x9f,0xd5,0x90,0x4c,0x75,0xd0,0xe9,0x2f,0x2d,0x29, + 0x93,0x40,0x51,0x41,0x6a,0xfa,0xf3,0xf1,0xc,0x85,0xe5,0x85,0xd9,0x9d,0x46,0x9, + 0xd,0x55,0xe,0x29,0xc4,0x9f,0x11,0xea,0x4c,0x3a,0xa9,0x8c,0xcc,0xf2,0xeb,0x34, + 0x71,0x1d,0xe,0xae,0x3e,0x45,0x5e,0xb3,0x74,0xd,0x76,0xe2,0xa3,0xa3,0xbb,0x8b, + 0x42,0x5b,0x64,0x95,0x5e,0xcf,0x30,0xc2,0x2a,0xec,0x6d,0x5e,0xea,0x6b,0x58,0x12, + 0xcf,0xe7,0xee,0x52,0xf5,0xea,0x77,0xcb,0x8c,0x84,0x95,0x81,0x47,0x9b,0xe2,0x27, + 0xaa,0x38,0xd1,0x4,0xa0,0x2,0xf0,0x51,0x6c,0x75,0xea,0x91,0xa1,0xb2,0xc,0x65, + 0x46,0xc8,0xa2,0xa2,0xf2,0x8e,0x3b,0xc,0xe9,0xb8,0x90,0x55,0xd9,0x14,0xa9,0xa6, + 0x66,0x75,0xf,0x65,0xc3,0x2b,0x7c,0xd4,0x32,0x72,0x46,0x45,0x1f,0x9,0xf4,0x57, + 0x95,0xf2,0xb,0xc6,0xd8,0x44,0x93,0x5f,0x71,0x30,0x22,0x4c,0x8,0xed,0xdc,0xc7, + 0x1f,0x15,0x59,0xd4,0x34,0x82,0x5d,0x4f,0x1a,0xa5,0x1e,0xe5,0x71,0xec,0x6a,0x1e, + 0xd1,0x6b,0xc6,0xc2,0xa3,0x95,0x8d,0x3b,0xc6,0x4b,0x8b,0x84,0x3,0xbf,0x81,0xdf, + 0x8f,0xbf,0xaa,0x64,0xeb,0xd2,0xe5,0x78,0xa5,0x50,0x76,0x91,0xd9,0x8,0xa,0x2e, + 0xdf,0x4f,0x3b,0x95,0xd3,0x2c,0xe5,0x69,0xf0,0xe8,0x91,0xbc,0x44,0x93,0x8f,0x7a, + 0x82,0x30,0x6f,0xca,0xb5,0x2c,0x22,0x8f,0x4e,0xea,0xcb,0x2b,0xb3,0xb6,0xf1,0xba, + 0x1f,0xd1,0x37,0x36,0x38,0x4c,0x15,0x8d,0xd8,0xbc,0xd7,0x3e,0x8a,0xef,0xc3,0x88, + 0x8f,0xa2,0xf6,0xcf,0xc7,0xc2,0x39,0x71,0xc6,0xc8,0xb,0x97,0x46,0x23,0x63,0x3f, + 0x2a,0xd,0x84,0x7d,0x37,0xe0,0x1c,0x53,0x17,0x35,0x45,0x99,0xb7,0xe3,0x74,0xb8, + 0xbb,0x24,0xb4,0x20,0x5e,0x15,0x5,0x45,0x10,0xc0,0xb,0xa5,0x96,0x14,0x3c,0x42, + 0x74,0x4e,0x1f,0xdd,0xb,0xbf,0x1f,0x1,0xa,0x28,0x4f,0x50,0xc1,0xe6,0x82,0x74, + 0x7e,0xe8,0x7f,0x67,0xbe,0x82,0x37,0xdf,0xeb,0xd1,0x1,0xf1,0x9c,0xa7,0xa9,0x92, + 0x79,0xdb,0xdc,0xa2,0x69,0x70,0x5a,0x12,0xc9,0x8e,0x8a,0xb8,0x9c,0x7b,0x6,0xe3, + 0xcd,0xd6,0x26,0x73,0xdd,0x26,0x75,0xd1,0xc0,0xc7,0x42,0xfa,0xb,0x2b,0xf2,0x43, + 0x37,0x3f,0xb,0xcf,0x8d,0x3f,0x94,0xb8,0xcb,0x58,0x1,0x38,0x1f,0x17,0x1b,0x81, + 0xda,0xac,0x2f,0x98,0xff,0x3d,0xb2,0xf8,0xb6,0x4e,0xec,0xd1,0xe4,0x51,0xd4,0xa3, + 0xe9,0x66,0xba,0xac,0x9,0xb9,0x59,0x33,0xa4,0x46,0x1b,0xff,0x51,0x8f,0xcb,0x3d, + 0x96,0x7d,0x9f,0x66,0x9e,0x51,0x72,0x8f,0xfc,0x7e,0xed,0xb8,0x9f,0x7e,0xf5,0xf6, + 0x5f,0x80,0x10,0x5c,0xe8,0xc2,0xe9,0xf4,0x5f,0x53,0xcf,0x1f,0x91,0xdf,0xab,0x26, + 0x28,0xa7,0xeb,0x1b,0x46,0x53,0xf0,0xe0,0xe7,0x60,0xc7,0xa7,0x7c,0xfa,0x2f,0xa9, + 0xef,0x9d,0xce,0xf2,0x34,0x71,0x9b,0x72,0x3,0xd3,0x8f,0x45,0x37,0x38,0x69,0x72, + 0x24,0xd4,0xd9,0xd,0xf8,0xcc,0x4d,0x24,0xad,0xc7,0x1f,0xf4,0xd9,0xd5,0x6b,0x82, + 0xb2,0xbc,0x80,0xf4,0xf1,0x3d,0xf1,0xef,0x27,0x52,0x53,0xd5,0x7e,0x93,0x4,0x91, + 0xb6,0xbe,0xfa,0x88,0x39,0xb5,0x6d,0x4d,0x8a,0x3a,0x26,0xf9,0xf1,0x46,0xc6,0xc7, + 0x46,0x3b,0x3f,0x3a,0x75,0x14,0x95,0x6b,0x68,0x2,0xb8,0x1c,0x60,0xe8,0x8b,0x88, + 0x4,0x8a,0x92,0xfb,0xe1,0x5,0x27,0x7f,0x94,0xd,0x35,0xfb,0x51,0x22,0xcf,0x63, + 0xa6,0x9f,0x1,0xe4,0xe7,0xe9,0x6,0x22,0x75,0xc9,0xd4,0x8e,0xcb,0x63,0xfa,0xdb, + 0xe6,0x3d,0x47,0xa,0x44,0x60,0xa3,0x1e,0x27,0xbe,0x44,0xe0,0xfa,0x8,0x5d,0xb9, + 0xab,0x66,0x2,0xc6,0x12,0xac,0x6f,0x22,0x40,0xe3,0x98,0xf9,0x25,0xfc,0x71,0x88, + 0xda,0x22,0xa6,0xa3,0xe7,0x6e,0xae,0x7c,0x3c,0x86,0x6c,0x15,0x91,0x21,0xca,0x9c, + 0x83,0xeb,0x84,0xe,0x15,0xe5,0xe,0x72,0x99,0x9d,0xdc,0x8c,0x50,0x8e,0x69,0x33, + 0x74,0x16,0x57,0xd4,0x3c,0xb6,0x22,0x8a,0xd8,0x54,0xa1,0xd9,0x25,0x4f,0x5d,0xf3, + 0xd6,0xcc,0x84,0xe4,0xa0,0x14,0xd8,0xc0,0xda,0x14,0x70,0x64,0x65,0x76,0x3e,0x2b, + 0x29,0x52,0xd3,0x1e,0xd,0x34,0x1d,0xc3,0x69,0x5,0x94,0xb3,0x6b,0xe2,0x63,0x96, + 0x61,0x7f,0x53,0x15,0xa9,0x61,0x45,0x7c,0x46,0x9f,0xd1,0xf7,0x9f,0xd5,0x21,0x29, + 0xb6,0xba,0xc5,0x68,0x7d,0x77,0xc,0xd8,0x49,0xd4,0x8c,0x6c,0x10,0x78,0x55,0xe2, + 0xed,0x99,0x20,0xd3,0x84,0x63,0x97,0xfe,0x88,0x14,0x73,0x3a,0x52,0x7a,0x25,0xd, + 0xa2,0x64,0x52,0xaf,0xd8,0xab,0xb9,0xbb,0xc1,0x46,0xb1,0xd2,0xbd,0x7b,0xac,0x83, + 0x7f,0x10,0xa2,0xbb,0x32,0x46,0x43,0xee,0x1e,0xfa,0xc5,0x9d,0xac,0x43,0x33,0x34, + 0x6b,0x63,0xb8,0x8f,0xd5,0xa2,0x4b,0x88,0xf6,0xd6,0x8b,0x6a,0x4f,0x76,0xe8,0x1e, + 0x69,0xe1,0xaf,0x9c,0x71,0x8f,0xb0,0xe0,0x47,0xef,0xa7,0x8d,0x8d,0xe4,0xbd,0xcb, + 0xb1,0x6,0x63,0x8d,0xb3,0x3a,0xc2,0x9,0xb3,0xd7,0xfe,0xdd,0xf8,0x7e,0xc1,0x16, + 0xc5,0xd9,0x6b,0x7b,0x77,0xc7,0xd5,0x39,0xc9,0xb5,0xe8,0xd7,0xe1,0x93,0xcd,0x91, + 0x4e,0x52,0xdf,0xcf,0x25,0x9b,0xf8,0xb,0xcf,0x94,0xd7,0xb8,0x8,0xe9,0xb5,0x90, + 0xfb,0x91,0x5a,0x20,0x17,0x15,0xd3,0x87,0xe8,0x5a,0x30,0x2e,0x1c,0x8a,0xe1,0x47, + 0x15,0x33,0xe2,0xc2,0x6d,0xd7,0xbb,0xa7,0x72,0xd3,0x8f,0x64,0xc3,0x8b,0xdf,0x47, + 0xdb,0xf5,0xb4,0xf9,0x1e,0x19,0xe9,0x92,0x9,0x3c,0x4d,0x50,0xeb,0x64,0x5a,0x52, + 0xc5,0x83,0xcd,0x7d,0x15,0x9c,0x11,0x3,0x4a,0x57,0x2e,0xd9,0xf1,0x50,0xa1,0x39, + 0x61,0xef,0x1b,0x63,0x8,0xce,0x34,0x17,0x3e,0x9b,0xfb,0xf9,0x1b,0xe8,0x4a,0x24, + 0xb4,0x5a,0x24,0xc1,0x68,0xe2,0x2d,0xe9,0x44,0x79,0x10,0xf7,0xf7,0x68,0x66,0x38, + 0xda,0x2b,0xe3,0x48,0xf6,0xc2,0x91,0x17,0x22,0x95,0x5d,0xba,0xb2,0xa0,0x48,0x94, + 0x25,0xa6,0x1f,0xcb,0x7d,0xac,0x5b,0xd4,0x89,0x44,0xf9,0xa3,0x2f,0x63,0xa4,0xa3, + 0xb1,0x76,0xf0,0x9,0x3a,0xe,0xc6,0xff,0x45,0x6c,0x5,0x8e,0x66,0x3a,0x8,0xe9, + 0x52,0x31,0xed,0xc8,0x2d,0x35,0x1,0x4f,0xed,0xf0,0x45,0xf9,0x76,0x5d,0x18,0xe7, + 0x14,0x25,0xce,0x50,0x46,0x7e,0x7c,0xc4,0xea,0xc6,0xda,0x14,0x73,0xab,0x36,0x4d, + 0x19,0xe1,0x2d,0xfa,0xfd,0x82,0x23,0xe1,0xc0,0x43,0xb8,0x68,0xfe,0xf7,0xd1,0xc6, + 0xf2,0x18,0x73,0xff,0x56,0xe1,0x53,0x58,0x92,0xc9,0xab,0xf3,0x9b,0xeb,0xa,0xf2, + 0xc2,0x62,0x25,0x8e,0x64,0x92,0x8,0xe9,0xa3,0x96,0xbe,0x51,0x54,0xee,0x55,0xef, + 0xc3,0x72,0x3d,0xd9,0xb2,0x2f,0xfe,0xfc,0x2e,0x5f,0xd4,0x93,0x8f,0x2e,0x74,0xaf, + 0x64,0xaf,0xc9,0xfd,0x69,0x8d,0x93,0x1b,0x7,0x25,0x89,0x7a,0xbe,0x48,0x68,0x4b, + 0x47,0xb6,0x1d,0xf,0x43,0x81,0xb7,0xa3,0x66,0x32,0x5a,0x1e,0xc6,0x8e,0xe6,0xfd, + 0xdd,0x38,0xdd,0x30,0xed,0xa7,0x36,0xec,0x9b,0x28,0x2c,0x12,0xe,0x5c,0x19,0x43, + 0xb0,0xde,0x40,0xfb,0xbc,0x28,0xf3,0x42,0xf4,0x92,0x57,0xa9,0xc8,0x19,0xfb,0x92, + 0xd7,0x4c,0x4e,0x41,0x73,0x9b,0x11,0xbc,0xa,0x47,0x47,0x3d,0xed,0xd1,0x39,0xf9, + 0xd7,0x9,0x56,0xe5,0x75,0x6b,0xa4,0x11,0xab,0x3c,0x86,0xa8,0xa5,0x60,0x23,0x99, + 0x2f,0x36,0x72,0x7f,0xc7,0xc7,0x6c,0xbf,0x43,0x48,0xbf,0xb,0x97,0x42,0x4a,0xb3, + 0x8c,0xe4,0xff,0xe9,0x81,0x13,0x9a,0xf9,0x6e,0xb4,0x43,0x6a,0xd2,0x82,0x2e,0xa, + 0x9b,0x87,0xd9,0xc0,0xe6,0x8d,0x89,0x74,0x64,0xec,0x47,0x2f,0xe2,0xa1,0xc0,0xc6, + 0xe2,0xbd,0xa7,0x2d,0x7b,0x75,0x81,0x74,0x54,0xff,0x4e,0xfc,0x7b,0xd2,0x1f,0x54, + 0x78,0x91,0xd3,0x74,0xf0,0xb9,0x83,0x30,0xd8,0xb7,0x8b,0x7c,0x52,0x66,0x4,0xed, + 0x4,0x46,0xd6,0x89,0x2c,0xa7,0xa8,0x72,0x2f,0x90,0x36,0x2e,0x68,0x87,0x2f,0xf2, + 0xb8,0x7f,0xbc,0x41,0xc0,0x81,0x2c,0x62,0x3c,0x3d,0x9f,0xab,0x48,0xc3,0x92,0xff, + 0x1b,0xf3,0xb9,0xdc,0x6,0x5,0x75,0x69,0xe4,0x4c,0x1f,0x6e,0x10,0x21,0x5f,0xb5, + 0x9,0x52,0xcd,0xe4,0xca,0xc9,0x93,0x35,0x31,0xda,0xb9,0xe0,0xb,0x0,0x2f,0x20, + 0xd3,0x45,0x6c,0x76,0xbe,0xbb,0xce,0x40,0x84,0x39,0xdf,0x42,0x5f,0x57,0x18,0x8, + 0x7,0x4e,0x53,0xaf,0x36,0x41,0x68,0xfa,0x83,0x4f,0xc5,0x99,0xd6,0x89,0x6f,0x7f, + 0xfd,0xb4,0x3b,0x8,0x32,0xcb,0x8b,0x2,0xa0,0x8,0x4f,0x84,0x3,0x13,0xd5,0x6c, + 0x6b,0x16,0x9e,0x1c,0x56,0xea,0xb,0xfa,0xed,0x76,0xc9,0x63,0xc9,0x22,0x15,0x4d, + 0x63,0x5d,0x73,0xac,0x29,0xa0,0x47,0x8e,0x13,0x5f,0x2a,0x23,0xa5,0x61,0xcb,0xe7, + 0x99,0xae,0xfd,0xc9,0x38,0x14,0x91,0xd3,0x62,0xd2,0xb7,0x22,0x22,0x3b,0x4,0x51, + 0x1a,0xc0,0xdd,0xab,0xd9,0x85,0x42,0x79,0x40,0xda,0xd1,0xf2,0x74,0xa8,0x26,0x22, + 0xa6,0xcc,0xb2,0xc0,0x5f,0xdc,0x7a,0x51,0x41,0x20,0xd4,0xd7,0xc6,0x1d,0xfc,0x53, + 0x8d,0x39,0xdb,0xf3,0xb8,0x7f,0xa9,0x87,0x80,0xba,0x65,0x19,0x3e,0xf6,0x45,0x4, + 0x88,0xd2,0xf0,0xe1,0x8c,0x7a,0x6d,0x9d,0xcc,0xee,0x9a,0x9a,0x90,0xfb,0x75,0x30, + 0x14,0xc3,0x6b,0x6a,0xfc,0x91,0x8a,0x2,0xac,0xef,0x58,0x9a,0x9a,0xc2,0x7a,0x2c, + 0x7f,0x6c,0x8d,0x18,0xba,0xee,0x2,0xa6,0xd,0xa3,0xc8,0x82,0x1a,0x18,0x26,0xa0, + 0x99,0x4b,0xb8,0x76,0xd4,0x94,0xf2,0x80,0x8b,0xc8,0xc,0x37,0x5d,0x29,0x1a,0x91, + 0xb2,0xc,0x9d,0x4f,0x2,0xdd,0x58,0xd3,0x44,0x84,0xc6,0xa4,0xf9,0x1e,0xde,0x5c, + 0x10,0x8,0xd5,0x5b,0xe2,0xdf,0x27,0xd,0x0,0x2,0xeb,0x71,0x29,0x41,0x40,0x29, + 0x85,0x2b,0xd,0xb4,0xc8,0x7b,0x84,0x4e,0xb5,0x9d,0x80,0x50,0xd,0x4d,0x59,0x99, + 0x23,0x87,0x70,0x46,0x35,0x4a,0xb5,0x74,0xdd,0x1f,0x1e,0xd5,0xc2,0x0,0xcb,0xd3, + 0x50,0x97,0x76,0x9,0xf6,0xb1,0xb2,0xe5,0x82,0x74,0x6c,0x95,0x38,0x85,0xf6,0xe5, + 0x15,0x6c,0xbd,0xc,0x75,0xc1,0xe0,0x95,0x4f,0xd7,0x34,0x50,0x90,0xe9,0x8,0x3f, + 0xb0,0x22,0xc9,0xdd,0xf8,0x48,0x18,0x39,0x52,0x1f,0x24,0x0,0xbb,0xce,0x8,0x4d, + 0xa6,0x16,0x13,0xbd,0x71,0xeb,0x92,0x2,0xcc,0xfa,0xcd,0xcf,0xc2,0x53,0xe3,0xe0, + 0x9f,0x5c,0xa,0xfb,0x25,0xd,0x95,0xd0,0x3f,0xd4,0x40,0x93,0x46,0x7d,0x52,0x87, + 0xa4,0xd7,0x4,0x34,0xff,0x4e,0x81,0x6a,0x75,0x4a,0x3e,0x2e,0x65,0xc4,0xcf,0xdd, + 0x4f,0xd7,0xcc,0x28,0xd0,0xab,0xeb,0xd9,0xf7,0x17,0xd5,0x18,0xec,0xfa,0xdd,0xfd, + 0x97,0x59,0xda,0x78,0xfd,0xe6,0xbb,0x86,0x7b,0x45,0xa,0xd,0xdf,0xe2,0x9d,0xee, + 0x67,0xd7,0x8e,0x49,0x6c,0x76,0xff,0x84,0x7f,0xbe,0x8d,0x74,0xd,0x45,0xed,0x88, + 0x79,0x92,0x62,0x6d,0x4d,0x48,0x3d,0x9c,0x4e,0xbb,0x1a,0x4b,0x1b,0x9e,0x81,0x46, + 0xd,0xb3,0xcd,0xc5,0x62,0x54,0x7f,0xfd,0xd7,0x70,0x73,0xee,0x48,0x58,0x49,0x88, + 0x32,0xda,0x88,0x84,0xbd,0xf8,0x45,0xd2,0x59,0xe3,0x3c,0x40,0xb0,0x84,0x89,0xbe, + 0x72,0x82,0xad,0x17,0x95,0x3d,0x2e,0xef,0x45,0xda,0xca,0x2b,0x75,0xc5,0x4e,0x52, + 0xde,0xa2,0xa3,0x22,0xd8,0xe8,0x81,0xa0,0xda,0x53,0x78,0x5c,0x40,0xcd,0xc4,0x47, + 0xda,0xb7,0xa3,0x23,0x9e,0xfb,0xe8,0x74,0x51,0x36,0x27,0x99,0x1,0x76,0x53,0xad, + 0x26,0xbb,0xd6,0x75,0x62,0x0,0x3e,0x7,0x41,0x9d,0x1a,0x93,0x6f,0x5f,0x5a,0x22, + 0x56,0x7,0xd5,0x6c,0xc,0xe6,0x28,0x68,0x44,0x1a,0xf8,0xf1,0xdf,0xf4,0x33,0xe2, + 0x8c,0xba,0x2e,0x77,0x24,0xbc,0x78,0xe5,0xe4,0x6b,0x4c,0x32,0xa,0x23,0xec,0x3e, + 0x1b,0xab,0xad,0xab,0xa1,0x4a,0x9d,0x5e,0xca,0x29,0x2a,0xf0,0x85,0x69,0xdc,0x95, + 0x93,0xbb,0x92,0xfb,0x26,0xb5,0x29,0x47,0xe1,0x99,0x6b,0x9d,0xa6,0xf9,0xfb,0x23, + 0x83,0xf3,0xe7,0x8f,0x77,0xe9,0xf8,0xc0,0x37,0x47,0xf9,0xd6,0x25,0xcc,0x3e,0x6d, + 0x26,0x7c,0x75,0x42,0x2d,0xfc,0x7b,0x0,0xc,0xe3,0x71,0xc7,0xe9,0xac,0x9d,0xfc, + 0x11,0x5b,0x4d,0x3,0x26,0xd2,0xf1,0x11,0x9d,0xf2,0x18,0x6d,0x3d,0x34,0x22,0x4a, + 0xe,0xd6,0x62,0x7f,0xe3,0x7c,0x7,0xa6,0x11,0xc5,0xd1,0xed,0xc5,0x5b,0xb7,0xec, + 0xd8,0x99,0x2b,0x12,0x4e,0xbd,0x32,0x2e,0x87,0x9b,0x4e,0x55,0x8c,0xbe,0x88,0xc8, + 0xc2,0x22,0xe2,0x2a,0xe3,0x6e,0xba,0xe1,0xa3,0x15,0x27,0x7e,0xdb,0xe2,0xb,0x9c, + 0x96,0x4,0xc8,0x2a,0x1c,0x5b,0x99,0x85,0x53,0x59,0x85,0x25,0x4,0x85,0x46,0x45, + 0x4e,0x4,0x71,0xc5,0x36,0xa9,0xec,0xe2,0xdb,0xe7,0xca,0x41,0xdd,0x42,0x10,0x57, + 0xc5,0xc3,0xd3,0x50,0xcd,0xd4,0xc1,0x70,0x51,0x8d,0xaf,0x1e,0x4a,0xeb,0x3,0xbe, + 0xce,0x1a,0xf7,0x7c,0x70,0x6e,0xf0,0x13,0x98,0x86,0x29,0xb0,0x79,0xa3,0x6d,0xbf, + 0x1,0x5d,0x58,0xdd,0xf4,0xd,0xe6,0xd2,0xb6,0xf9,0x50,0xa8,0x5f,0x9f,0x93,0x8e, + 0xea,0xdf,0x4c,0x9b,0x13,0xf3,0xfe,0xe0,0x59,0xd8,0xc2,0x12,0xd0,0xc8,0x43,0x48, + 0x39,0x1b,0x57,0x3b,0xa1,0xc8,0x3d,0xa6,0x4b,0x4d,0xe5,0x45,0x23,0xba,0xad,0x89, + 0xa7,0x8e,0x76,0xa3,0x95,0x84,0xa0,0x6a,0xd6,0x91,0xa4,0xd,0x2,0xb9,0xcb,0xe7, + 0x62,0xe,0x32,0x27,0x52,0x7,0x35,0x2f,0xc1,0x69,0xe7,0xf0,0x50,0xd0,0x44,0x5e, + 0x5,0x87,0x5b,0x8,0xc0,0x59,0xca,0xe6,0xfb,0x9d,0x1f,0x65,0x1,0xc2,0xc,0xd3, + 0xa0,0x47,0xf1,0x27,0x2b,0x63,0x5c,0xc3,0x3b,0xe2,0xa4,0x65,0x8d,0xc1,0x12,0x13, + 0x6e,0xe1,0x6b,0x72,0xd1,0xd1,0x4d,0x6b,0xf0,0xd2,0xb4,0x28,0x33,0xf,0xc3,0xe7, + 0x12,0x3d,0xb,0x3e,0x2,0xaa,0x1d,0x73,0x64,0xd2,0x1f,0xb7,0x62,0xc8,0xaa,0xeb, + 0x8a,0xc7,0x11,0x54,0x5b,0xe8,0xb1,0x65,0x1b,0x77,0x23,0x94,0x4b,0xa2,0x49,0xef, + 0xf3,0xad,0xaa,0xc8,0x55,0x7b,0xf0,0xcb,0x63,0xfb,0x8,0xa8,0x74,0xc5,0xa,0x49, + 0x2f,0xbc,0x6c,0xfd,0x5f,0x9a,0x7a,0xba,0x27,0x8f,0xfa,0xd6,0xe1,0x5,0xe8,0xe1, + 0x16,0xbe,0x89,0x6d,0xfe,0xa9,0x6e,0xda,0x91,0xdd,0x46,0x4e,0x9b,0x9e,0x6a,0x4a, + 0xd6,0x4c,0xfd,0xcc,0x2a,0xf4,0x34,0xaa,0xaa,0x35,0x66,0x51,0x8b,0xa1,0x75,0xf1, + 0xd6,0x8b,0xdd,0xa5,0xdc,0xce,0x48,0x58,0x79,0x25,0x7a,0x63,0x87,0x10,0x46,0x96, + 0x52,0xc1,0xb3,0x73,0x11,0x50,0xb0,0x6d,0xbb,0xee,0xd6,0x16,0xcd,0x18,0xf0,0x36, + 0x41,0x8d,0x18,0x9b,0x22,0xe9,0x53,0xf1,0x5,0x6f,0x5c,0x54,0xf3,0xc7,0x1,0xbe, + 0xaa,0x86,0x97,0x49,0xb8,0xa2,0x6d,0x99,0x87,0xc8,0xcb,0x33,0x70,0xc4,0x63,0x97, + 0x1c,0xe4,0x3,0x9f,0x6b,0xf2,0x1,0xc8,0xc8,0x94,0xee,0x98,0x77,0x99,0xf0,0x9a, + 0x94,0x70,0xfc,0xe2,0x8c,0x4b,0xd9,0xd4,0x70,0x2d,0x43,0xc3,0xd7,0xcc,0xb8,0x74, + 0xd4,0xe4,0x6d,0x85,0x55,0x88,0xcb,0x39,0x4d,0xb7,0x30,0xba,0x26,0x7,0x1d,0x55, + 0xc6,0x1f,0x27,0xcd,0x89,0xad,0x58,0x4f,0xe,0x22,0x90,0x12,0x50,0x8e,0x38,0xb8, + 0x6f,0x69,0xa6,0xda,0x45,0x8b,0xf2,0x42,0xde,0x2f,0xd4,0xc1,0x4,0x93,0x87,0x62, + 0xe4,0x1d,0x50,0xc1,0x3b,0x7e,0xfe,0xfc,0x4d,0x96,0xb,0x82,0x30,0x37,0x7c,0xb9, + 0x60,0x24,0xca,0xd,0x23,0xd6,0x9c,0xe7,0xf2,0x42,0x78,0xf3,0x42,0xcd,0x90,0x55, + 0xee,0x13,0x2,0x53,0x96,0x41,0x97,0x7b,0xdb,0xf9,0x1d,0xdd,0xa9,0xf,0x92,0x54, + 0x53,0x97,0x4f,0xd,0x6a,0x45,0x5f,0xd,0x8d,0xd3,0xc,0xc5,0x64,0xca,0xfc,0x60, + 0x5e,0x93,0x99,0x8e,0x9e,0xbf,0xae,0xf6,0xc2,0xf8,0x5,0xce,0x24,0x32,0xc2,0x67, + 0x43,0xb3,0x4e,0x51,0xfa,0xb,0x56,0x2c,0xc1,0xb4,0xbd,0xc0,0xf8,0xd8,0xa8,0xf9, + 0x93,0xea,0x3d,0xd7,0x6c,0x63,0xaf,0x6c,0xad,0x58,0x9e,0xbe,0xca,0x14,0x50,0xed, + 0xf1,0x10,0x23,0x87,0xde,0xe8,0x26,0x95,0x21,0x1e,0x62,0xc8,0x51,0xda,0xe1,0x38, + 0x42,0xa0,0x60,0x6a,0x8f,0xbd,0x21,0x5b,0xa1,0x49,0xc3,0x3d,0xd6,0xc9,0xb5,0x20, + 0x4c,0xe8,0xc2,0xdf,0x7c,0xf1,0xb5,0x76,0xd8,0xf8,0x30,0x54,0x6,0xaa,0x7,0x92, + 0xee,0xce,0x98,0xfb,0xb9,0xc,0xbd,0x98,0x69,0x9c,0x19,0x75,0x93,0x90,0x5e,0xb0, + 0xf9,0xb2,0xa1,0x9f,0x67,0x2,0x61,0xfd,0x95,0x4d,0xcf,0x11,0x53,0x98,0x5f,0x6, + 0x14,0x50,0xe8,0xc2,0x33,0x9c,0x56,0x38,0x75,0x25,0x56,0x62,0x40,0x52,0x35,0x31, + 0x8a,0xcc,0xb0,0xf8,0x53,0x5a,0x5,0x4c,0x29,0x4d,0xc2,0x2a,0x72,0x1e,0xe5,0x82, + 0xa2,0xcf,0xb8,0x70,0x81,0x44,0x5,0x9a,0xfe,0x10,0x3,0x56,0xba,0xb8,0x27,0xd8, + 0xd3,0xda,0xd5,0xdf,0xee,0xbf,0xc,0xfa,0xa1,0xc6,0xe5,0x6b,0xf6,0xcf,0x88,0x91, + 0x6d,0x68,0x71,0xc6,0xbd,0x26,0xa2,0xbb,0x7a,0x94,0x3,0x2f,0xd,0xc9,0x98,0x5e, + 0xaf,0xc6,0x91,0xe6,0x79,0x37,0xd5,0xe8,0x34,0x4,0x80,0xca,0x35,0xf8,0x79,0x26, + 0x3a,0xaa,0xaf,0x31,0x1d,0x42,0xb3,0x5c,0xed,0x52,0xac,0x10,0x11,0x50,0xbe,0x5e, + 0x94,0xee,0x87,0xe0,0x6c,0x8,0xba,0xd4,0x48,0xc3,0xdd,0xb0,0xc4,0xf7,0x4f,0xc8, + 0xea,0x45,0xe5,0x85,0x67,0x6e,0x55,0xd2,0x47,0xf2,0x78,0x9d,0x94,0x7b,0x5c,0x9f, + 0x71,0xa1,0x99,0xd7,0xe0,0x1f,0xf,0x5,0xe2,0xf3,0xf2,0x5f,0x10,0x34,0x63,0x1, + 0x71,0x46,0x10,0xfd,0x49,0xd3,0x19,0x2b,0x1c,0x67,0x15,0x77,0x6f,0x72,0x30,0xbe, + 0x26,0x63,0x9f,0xdd,0x1b,0xc8,0xe7,0x7f,0x9a,0x54,0x5a,0xb5,0x65,0x59,0x20,0x91, + 0x15,0x9a,0x84,0x34,0x7a,0xad,0xab,0x73,0x97,0x5,0xe1,0xd6,0xf5,0x78,0x7e,0x4c, + 0xae,0x6a,0x46,0x46,0xa8,0xf0,0xb,0xe0,0x6b,0x12,0x79,0x73,0x41,0x3b,0x0,0x6, + 0xab,0xa4,0x97,0x1f,0x36,0x8,0x40,0xe4,0xe,0x72,0xfd,0x13,0xbe,0x2e,0x9,0xf9, + 0x88,0x43,0x9f,0x3b,0xe8,0x3e,0xbd,0x7d,0x99,0xa2,0xff,0x71,0xdd,0x86,0x85,0x4f, + 0x76,0xd1,0x64,0x7b,0x50,0x58,0x1d,0xac,0x86,0x76,0xb0,0x19,0x3a,0x2f,0xe4,0xfb, + 0x36,0xb8,0xb,0xb2,0x4f,0x9c,0xd1,0x44,0x85,0xf,0x45,0x46,0x35,0x5c,0xeb,0x1, + 0x47,0x9e,0xce,0xc1,0xb4,0x9a,0x4a,0x1d,0xdb,0x8b,0x65,0xcd,0x50,0x55,0x47,0x2d, + 0x56,0x57,0x6,0xb6,0x3c,0x3d,0x3,0x1d,0x8d,0x5e,0x1d,0xdf,0x37,0x9d,0x28,0x57, + 0x5b,0x8a,0x4b,0x88,0x5a,0x4c,0x2e,0x17,0x94,0x90,0x55,0x17,0x65,0xe5,0x96,0x16, + 0x55,0x44,0xb5,0x8b,0x16,0x11,0x41,0x3e,0xaf,0x34,0xc9,0xa1,0xfb,0xa8,0xec,0xd4, + 0x53,0x91,0x54,0x49,0x5a,0x7,0x13,0x92,0xb,0x82,0xcd,0x4b,0x65,0xd3,0x66,0x20, + 0xac,0x60,0x91,0xd3,0x50,0x7a,0x50,0xa1,0xe4,0x79,0x25,0xaf,0x3e,0x62,0x4d,0x12, + 0x20,0xbd,0x62,0x85,0x8f,0x82,0xba,0xa3,0x2c,0xa5,0xe1,0xcf,0xdf,0xbf,0x1c,0x53, + 0xcd,0xb3,0x77,0xd2,0x18,0xfc,0xa4,0xaf,0xc1,0xbd,0xe1,0x74,0xd4,0x98,0x6a,0x3f, + 0x65,0x50,0x51,0x85,0xa7,0xa2,0xc7,0x5b,0x9b,0xa9,0x1,0xd6,0xa0,0x0,0xe0,0x25, + 0xa9,0xb4,0x10,0x4e,0x1f,0xcb,0x75,0x18,0xc2,0xdb,0x53,0x1,0x8f,0x2,0xea,0x6e, + 0x41,0xe5,0x2b,0x63,0xa8,0x8e,0xc,0x77,0x5f,0x9f,0x2f,0xc2,0xfa,0x1b,0x74,0x7d, + 0x95,0x33,0xbe,0x32,0x0,0x2d,0xce,0x14,0xfd,0x5a,0x32,0x6d,0x4f,0xf8,0xea,0x45, + 0xb5,0xc7,0xb4,0x97,0x51,0x53,0x3a,0x83,0xf5,0xb,0x31,0xf0,0xe4,0x83,0x54,0xe4, + 0x33,0xeb,0x49,0xe7,0xef,0x5b,0x61,0x60,0x65,0xda,0xfc,0x8a,0x5e,0x15,0x4c,0x47, + 0xcf,0x58,0xd1,0xa8,0xce,0x6,0x10,0x61,0x36,0x91,0x11,0x5e,0x96,0x78,0x62,0x97, + 0xe3,0x17,0xb1,0x1f,0x98,0x66,0xaf,0x83,0xf6,0x7,0x1f,0x81,0x9f,0x2f,0xad,0x53, + 0xd,0x4d,0x11,0xdc,0xc3,0x67,0xf9,0xcc,0xf,0x9e,0xa3,0x24,0x34,0x95,0x2,0x65, + 0xe4,0xa8,0x98,0x91,0x43,0x94,0xcf,0xe2,0xfc,0x34,0x95,0x2b,0x0,0x84,0xd7,0x48, + 0x49,0x5a,0x12,0x9a,0x21,0x7e,0x3e,0x1a,0xa,0x36,0x47,0x4d,0x1b,0xf5,0x6e,0x50, + 0xa6,0x3d,0x46,0x97,0x38,0x13,0x81,0x1f,0x73,0xef,0x23,0xa9,0x5c,0xe5,0xc,0x97, + 0x2f,0x26,0x3f,0xb5,0x1e,0xf4,0x34,0xd1,0x52,0xc7,0x6c,0xfc,0x66,0xb7,0xc,0x9c, + 0x17,0x48,0x47,0x97,0xbf,0x8,0x4b,0x4c,0x87,0x30,0xce,0x8,0x7b,0x70,0xa1,0xf1, + 0xe1,0xa9,0x14,0x39,0xf4,0xd1,0x54,0xba,0xb6,0x21,0x7e,0x8c,0xf4,0xad,0x74,0x1d, + 0x89,0xb6,0x28,0x2f,0x9c,0x15,0x3b,0x2e,0x5,0x6f,0xfe,0x11,0x5d,0x4d,0x4a,0x9a, + 0xb5,0x24,0x34,0x39,0xc8,0x8a,0x53,0x25,0x39,0xcd,0x55,0x39,0x68,0x68,0x56,0x33, + 0x82,0x3f,0xca,0xbd,0x7c,0x9a,0x44,0x99,0x95,0xac,0x54,0x2f,0xb3,0x27,0xa4,0x4d, + 0x5b,0xae,0x89,0xaf,0xf2,0xca,0x19,0x6e,0x85,0x5f,0x7a,0xc0,0xa1,0xf,0x6c,0x60, + 0x6a,0x63,0xe7,0xbe,0xe7,0x15,0x18,0x6b,0x9c,0xd,0xa,0x33,0xb1,0xc1,0x0,0x75, + 0x35,0x1e,0xf,0x8a,0x84,0xea,0xaa,0xb4,0x4d,0x3f,0x1f,0x9,0x2f,0x6c,0xcc,0x56, + 0xa3,0x9a,0x8c,0x5c,0xd4,0x93,0x8f,0x97,0xdc,0xd5,0x8f,0x6f,0x59,0xe2,0x9b,0x98, + 0xf8,0x3d,0x7c,0xc3,0x12,0x9c,0x8a,0x22,0x6f,0xd4,0xdb,0x7b,0x5c,0x65,0xe2,0x60, + 0xd,0x67,0xed,0xd0,0x31,0xa5,0x51,0x91,0x22,0xb6,0x54,0x1b,0xaf,0x2b,0x8e,0x6a, + 0xe7,0xa0,0xb,0xdf,0x5a,0x14,0x48,0x8d,0x1f,0x1,0x53,0x7c,0x2f,0xa3,0x9e,0x48, + 0xc4,0x46,0xce,0x92,0x70,0x8b,0x33,0x9a,0xd5,0x4c,0xf9,0x2e,0x9,0xcd,0xce,0x75, + 0xb3,0xbb,0xf3,0x69,0x49,0x4b,0x63,0x99,0x81,0x16,0x93,0x90,0x46,0x57,0x7,0x46, + 0x42,0xfd,0xcb,0xb1,0xa2,0x3a,0x9b,0xc8,0x8,0x9f,0xd2,0x8c,0x52,0x94,0xd7,0xa7, + 0xd9,0x51,0xb5,0xba,0x79,0x75,0x88,0x7d,0x3f,0xfb,0x1e,0xf3,0x71,0x23,0xa7,0xbf, + 0xc3,0x7b,0x66,0xca,0xba,0x36,0xcd,0x5b,0xff,0x92,0x35,0x81,0x0,0xe9,0xc0,0x60, + 0xae,0x8e,0xc3,0x25,0x8f,0xa0,0xc9,0x1d,0xec,0xc5,0xd0,0x64,0x8d,0xbd,0x59,0x22, + 0x19,0x1f,0x8d,0x65,0xb6,0xb9,0xce,0x19,0x99,0xdd,0x63,0xf0,0xb3,0xd7,0x8b,0xba, + 0xd3,0x18,0xca,0xdb,0x8c,0xd8,0x58,0xcb,0xf,0x91,0x72,0xd,0xd4,0xa0,0x2e,0x6, + 0x4b,0xd0,0x85,0x5a,0xe3,0x2c,0xac,0x19,0x4d,0x4d,0xea,0x5,0x1b,0x96,0xd3,0x23, + 0x10,0xc9,0x48,0xb8,0xe9,0x42,0x35,0x10,0x43,0x50,0x27,0x6a,0x65,0x9e,0xe2,0x8c, + 0x6d,0xf2,0xc9,0x20,0x9a,0x71,0x1a,0x41,0xc,0xe9,0x81,0x47,0x76,0x81,0x73,0x88, + 0x54,0x7a,0x80,0xa2,0x4b,0xbc,0xe1,0xe3,0x69,0xa8,0x25,0xe1,0x1a,0x7f,0xab,0xc1, + 0xaf,0xcb,0xee,0x36,0x36,0xb4,0x53,0xc8,0x71,0xc7,0x38,0x3e,0x4b,0xf4,0x57,0xae, + 0xb8,0x6,0x3f,0xda,0xd9,0x5d,0x72,0x4f,0xc4,0xd6,0xd9,0x70,0xf6,0x84,0xc4,0x92, + 0x70,0x49,0x34,0x74,0x17,0x6,0xac,0x39,0x45,0x7c,0x3d,0x4c,0x5a,0x76,0xa1,0x13, + 0x28,0x9d,0xd2,0x22,0xe6,0x9f,0x71,0xa9,0x81,0x18,0x63,0x4,0xe2,0xd2,0x65,0xcf, + 0xb,0x88,0x84,0x95,0xab,0x93,0x64,0x34,0x8e,0x83,0xe7,0xe0,0xb4,0x54,0x61,0x99, + 0xc4,0x86,0xe0,0x7a,0x22,0xd2,0xb1,0x7,0x44,0x4e,0x48,0xb5,0xd8,0x66,0xc9,0x2, + 0xd3,0x96,0x3,0xf7,0xb8,0xb2,0xd5,0x2f,0x42,0x96,0xab,0x49,0x67,0x8c,0x54,0x1b, + 0x31,0x18,0xe3,0x82,0x5f,0x86,0x5a,0x16,0x1b,0x65,0x31,0xca,0x9d,0xc9,0x86,0x2d, + 0x8f,0xed,0x1b,0x12,0xcc,0xd7,0xc9,0xc8,0x9f,0x2b,0xce,0xe6,0x5d,0x9e,0x9d,0x66, + 0x47,0x78,0x50,0x96,0x3b,0x9c,0x64,0x54,0xb3,0x42,0x10,0x75,0xf4,0x72,0x9c,0x68, + 0x9e,0x2f,0x33,0x58,0x6a,0x12,0xd2,0x3b,0xe4,0x39,0xa1,0x91,0x11,0xce,0x26,0x96, + 0xc4,0xbe,0x94,0x88,0x2e,0x70,0xf4,0x49,0x50,0x35,0x1e,0x5c,0x1f,0x5,0xc8,0xc9, + 0x92,0xf6,0x78,0x28,0x7f,0xef,0xa0,0x4f,0x4d,0xf5,0x2d,0xe1,0x45,0x45,0x5e,0xed, + 0x54,0xff,0xfc,0xfb,0xd2,0xb3,0xcc,0x42,0xcc,0xf9,0xf0,0x36,0x5e,0x77,0x4c,0x76, + 0x37,0x15,0xb9,0xe2,0x2c,0x3f,0xde,0x89,0x7f,0x67,0xb0,0x14,0x50,0x7e,0xcc,0x2f, + 0x8,0xd1,0x5f,0x12,0xf5,0x20,0x68,0x1f,0xe0,0xc7,0x1a,0xfa,0xf2,0xc1,0xf4,0xb9, + 0xee,0x16,0x81,0x22,0xf4,0x34,0xd7,0x2d,0x54,0x89,0xac,0x50,0x5d,0x2d,0x16,0x66, + 0xce,0x5e,0x66,0xda,0x13,0x35,0x2b,0x23,0xa4,0x4e,0xf6,0xc8,0xa9,0x58,0x51,0x57, + 0x56,0x4a,0x11,0x4b,0x4a,0x3c,0x70,0x7e,0xa8,0x12,0x77,0x50,0x6a,0x4c,0xc0,0x53, + 0x33,0x13,0x39,0xba,0x15,0xf8,0xb6,0x26,0x57,0x8b,0x30,0x4f,0xc,0x65,0x5d,0xf0, + 0x92,0x9a,0x19,0x9f,0x44,0xa4,0xa1,0x59,0x3a,0xe8,0x7a,0x25,0xae,0x25,0x42,0xb9, + 0xb5,0x22,0x28,0xf,0x8f,0x6e,0x55,0xf2,0x5b,0x12,0x54,0xd4,0x8b,0x0,0xc7,0x19, + 0x20,0x99,0x27,0xea,0x92,0x5d,0x0,0xd7,0xfc,0x51,0xfb,0xa7,0x32,0x66,0x72,0xc3, + 0xa8,0x9b,0xc1,0x79,0x5b,0xb7,0x8,0x41,0xd8,0xfb,0xc2,0x78,0xe5,0xdf,0xa4,0x32, + 0xba,0x16,0x67,0x3a,0xb3,0x3c,0xbf,0x59,0x2f,0xcb,0x18,0x1,0x7b,0x34,0xa2,0xcb, + 0x1d,0xe4,0xb3,0x40,0x97,0xed,0xf,0x27,0x29,0x71,0xd,0xd6,0x97,0xb5,0x35,0xf9, + 0x2b,0x35,0x65,0x23,0x2e,0xc2,0xe6,0x8f,0x72,0x8f,0x46,0xaf,0xf1,0x40,0xfb,0x88, + 0x91,0xb7,0x7d,0x88,0xca,0x17,0xb5,0x97,0x45,0x68,0xc6,0x6f,0xa4,0x8c,0x27,0x38, + 0x32,0x73,0x57,0x3d,0xb,0xad,0x96,0xa6,0x57,0x60,0xf2,0x9b,0xf3,0x9a,0x35,0xeb, + 0xc1,0xc4,0x46,0xf3,0x67,0x2f,0xa3,0x90,0xd6,0xaf,0x12,0x82,0xd0,0xb4,0x27,0x92, + 0x71,0xf0,0x42,0xd2,0x10,0x77,0x8d,0x4f,0x87,0x0,0xae,0xf4,0xd7,0xaa,0x9d,0xe9, + 0x36,0x65,0x33,0x44,0xac,0x35,0x41,0x7f,0x19,0xae,0xb6,0x54,0xf7,0x7c,0x52,0x9f, + 0x71,0x41,0x3f,0x96,0xfb,0x94,0x97,0xac,0xb6,0x2b,0xdf,0xb2,0xb6,0x4,0x6b,0x67, + 0xa3,0x12,0xff,0x1e,0xf9,0x72,0x70,0x6a,0x6e,0x3a,0x75,0x54,0x52,0x38,0x73,0xe5, + 0x5f,0x11,0x6b,0x49,0x24,0x87,0x50,0xf3,0xe2,0x8c,0x1d,0x67,0xfd,0x66,0x84,0xe, + 0xfa,0xb9,0xc4,0xc0,0xcd,0x8c,0x97,0x90,0x12,0xc2,0x8c,0xfe,0xa5,0xf8,0xf7,0x99, + 0x44,0xad,0xcc,0x96,0x54,0x8d,0x27,0x60,0x37,0xe,0x29,0xcb,0x66,0x50,0x4,0x45, + 0x55,0x96,0x65,0xc1,0x27,0xf1,0xfc,0x20,0xc,0xd9,0x9a,0xc0,0x7c,0x43,0x93,0x22, + 0x5b,0x91,0x24,0xf5,0xa4,0x12,0xe3,0x82,0xb6,0x4d,0x28,0x9b,0x42,0xf2,0x28,0x34, + 0x99,0x95,0xc8,0x32,0x6e,0x21,0xc6,0x27,0xdb,0xb8,0xe6,0x93,0xba,0x67,0x97,0xd9, + 0x9f,0x9e,0xcc,0xae,0x97,0x58,0xf0,0x36,0xc8,0x94,0x67,0x62,0x8c,0xf9,0xca,0x14, + 0xfc,0x93,0x45,0x35,0xb8,0x62,0x40,0x2e,0x2b,0x8c,0x8c,0x9f,0x5d,0xa8,0x34,0x0, + 0xae,0x12,0x36,0x5,0x7e,0x11,0x5d,0xe6,0xe2,0xf6,0x4c,0x24,0xdc,0xd8,0x87,0x27, + 0xc7,0x71,0x30,0x32,0xe2,0x60,0x5,0x3,0xa0,0xd7,0x1d,0x88,0x58,0x6b,0xde,0xf5, + 0xa1,0xba,0x5a,0x9e,0xe0,0x1c,0x87,0x21,0x4b,0xca,0xc1,0x5a,0x16,0xb0,0xc8,0x2c, + 0x25,0xcd,0xf8,0xe3,0x59,0x76,0x63,0x42,0x32,0xe2,0xc2,0x67,0xab,0x47,0xc2,0xa3, + 0xdc,0x33,0x47,0x5d,0xaf,0x8,0x24,0xd,0x35,0xef,0x55,0x4e,0x96,0xe0,0x6f,0x2d, + 0xd3,0xe,0x91,0x46,0x9,0x62,0xb2,0x76,0xb0,0x1a,0xde,0x84,0xd7,0xa4,0x53,0x18, + 0xb1,0xda,0xae,0x16,0xec,0x4d,0xbf,0x8a,0xde,0xa6,0x98,0x99,0x88,0x85,0xab,0x37, + 0x5d,0x22,0x88,0x84,0xdd,0xcf,0x89,0x81,0x99,0x54,0x46,0x4f,0xc7,0x2a,0xe1,0x30, + 0x20,0xff,0x5a,0xea,0xe9,0x18,0xa5,0x52,0x71,0x32,0x62,0x62,0x8f,0x2b,0xc2,0xd1, + 0x56,0x89,0x4e,0xd8,0x1d,0x60,0x6d,0xf,0x33,0x66,0x2b,0x32,0x96,0xc8,0x7a,0x29, + 0x14,0x5c,0x73,0x3c,0xe5,0x4b,0x90,0xc9,0x64,0x17,0x39,0x3d,0x95,0xd8,0xf9,0xb2, + 0xe9,0xa9,0x11,0x1b,0x47,0x4d,0x68,0x46,0x8e,0x4f,0xdc,0xd5,0xb0,0x14,0xd6,0xc6, + 0xeb,0x5e,0xf8,0x9a,0x8e,0x89,0xfc,0x6f,0x60,0xe4,0x20,0x80,0x1f,0x93,0x41,0xe7, + 0xa8,0x40,0xf,0xa6,0x9b,0x1c,0xa0,0x66,0x9e,0xf9,0x57,0xe0,0x7e,0x6f,0x24,0x54, + 0x57,0x80,0xa9,0x95,0xd9,0x2,0x6a,0xa9,0x2c,0xa9,0x35,0xf,0x68,0x46,0x81,0xe2, + 0x6b,0xf2,0x22,0xc1,0x75,0xe,0x5e,0x71,0xc7,0xb7,0x42,0x2f,0xb7,0x4e,0x1e,0x3c, + 0xb1,0x39,0x7c,0x74,0xa2,0xd4,0xf4,0x97,0x4d,0x95,0xf1,0xcb,0x32,0xb2,0x15,0x2b, + 0xd2,0xc7,0xfa,0x56,0x1c,0x76,0xbd,0x5f,0x97,0xc6,0xec,0x5a,0xf6,0x5,0x99,0xa2, + 0x1e,0x9d,0x15,0xfa,0x6f,0x83,0x1d,0x5e,0xa1,0x1d,0x93,0xda,0xec,0x23,0x22,0x4b, + 0x1c,0x8c,0x7f,0xf6,0x18,0xd8,0xa9,0x31,0xf8,0xe2,0x73,0xc2,0x2b,0x4c,0x59,0xc6, + 0xce,0x8,0xcd,0x53,0xc4,0x97,0xb,0x26,0xed,0x7c,0x10,0x32,0xb1,0x42,0xb2,0x58, + 0x9b,0xb2,0xe8,0x23,0x47,0x6c,0xd4,0x8e,0x5c,0x8f,0x8a,0x9d,0x54,0xf9,0x1a,0xbc, + 0x96,0x32,0xb5,0x2e,0x5,0x3d,0xda,0xc2,0x3d,0xee,0x2,0xa2,0x78,0xc4,0xe5,0x6a, + 0x4a,0x18,0xf9,0x7c,0x23,0x2c,0xf8,0xcf,0x4d,0xb2,0x56,0xb0,0x3b,0x47,0xe4,0xf2, + 0x3a,0xc9,0x58,0x8b,0x90,0xa8,0x47,0xbd,0x42,0x95,0x2,0x59,0xfa,0x99,0x95,0x67, + 0xf2,0xc,0x7d,0x11,0xa7,0x41,0xc6,0xe5,0xa6,0x73,0x3f,0xa7,0x30,0xdb,0x1c,0x7e, + 0x38,0x97,0x15,0xc6,0xe4,0x1a,0x7e,0x10,0x5e,0xde,0x53,0x7d,0x66,0x53,0x4e,0x45, + 0x64,0xcc,0x95,0x51,0xd8,0xc4,0x9c,0xd2,0x76,0x3,0x2f,0x55,0xc1,0xe2,0xaa,0x99, + 0x31,0xef,0xd5,0x24,0x94,0xb4,0x47,0xe,0x4a,0x9e,0xac,0x11,0x3,0x5,0x9b,0xb2, + 0xca,0x16,0xe4,0xa6,0x81,0xe7,0x9b,0x58,0x1a,0x42,0xf7,0xca,0x95,0x65,0xf8,0xfb, + 0x23,0xcf,0x5,0x82,0x96,0x70,0x34,0xdc,0x93,0xd6,0x28,0x82,0xaa,0x89,0x6a,0x97, + 0xf9,0xef,0xd9,0xae,0x1e,0x95,0x54,0x8a,0x2a,0x92,0xb7,0x24,0x1,0xa7,0x19,0x40, + 0x26,0x2b,0x6e,0x5c,0xf3,0xc2,0xdd,0x53,0x66,0xd2,0xf0,0xac,0x63,0x2,0xb3,0xd, + 0x2e,0x61,0x9e,0x9f,0xb5,0xb8,0x9b,0x62,0xe3,0x96,0x73,0x76,0xee,0x71,0xd2,0xd1, + 0xd1,0xa7,0xc5,0x6b,0x11,0x26,0xbb,0x8,0xcf,0xc4,0x72,0x86,0xbb,0x6b,0x86,0x15, + 0xd3,0x23,0x30,0xfc,0xee,0xb,0x65,0xe0,0x4a,0x49,0x69,0xda,0xc3,0xa1,0x8d,0x78, + 0x6a,0x25,0x44,0x3f,0x69,0x74,0x11,0x30,0x4,0xc8,0x36,0xee,0x81,0x16,0x12,0x59, + 0xc6,0x15,0xe1,0xc2,0x96,0xcf,0x46,0xaa,0xa2,0x27,0xfd,0xa,0x15,0xa9,0x6b,0xba, + 0x4a,0x1c,0xfc,0xd5,0x47,0x7c,0x17,0x85,0x82,0x6c,0x78,0x5,0x57,0xa4,0x1,0x72, + 0x5c,0x7,0x4,0x52,0x4d,0x92,0xa6,0xfa,0xa2,0x64,0xc4,0xd4,0x42,0x1f,0xc3,0x51, + 0xcc,0x1a,0x9f,0x5b,0x9c,0xca,0xcd,0x32,0x5c,0x93,0x8c,0x84,0xea,0xca,0xa4,0x47, + 0x18,0xc7,0xc1,0xcd,0x1,0x42,0x80,0xbd,0x3c,0x4b,0x1c,0x3b,0x29,0x4b,0x82,0x96, + 0x4e,0xb4,0x65,0x4b,0xb8,0xfb,0x36,0xfc,0x24,0x2c,0xf9,0x28,0xfe,0x71,0x8d,0xa1, + 0x34,0x52,0xb3,0x52,0xe,0x57,0x2f,0x9a,0xbe,0xdf,0x7e,0x7,0x4a,0x48,0x56,0xfd, + 0xef,0x24,0x9c,0x92,0xfa,0x3b,0x46,0xe8,0xc7,0x54,0xa9,0x9c,0xdf,0x2d,0xcb,0x44, + 0xa2,0xc8,0x1e,0x59,0x97,0x3d,0x6e,0xc6,0x1a,0x58,0x31,0x5,0x64,0x7f,0x84,0x4f, + 0x3,0x4d,0xd7,0xa9,0xd2,0x51,0x70,0x6,0x13,0xcd,0xf3,0x3a,0x79,0x86,0xcd,0x4d, + 0xe4,0x4e,0x80,0xf0,0xcb,0xee,0x9c,0xf0,0xa,0xdb,0xa8,0x9f,0x3b,0xd,0x6,0x44, + 0xb9,0xa0,0x16,0xe5,0x82,0x48,0xa9,0xa2,0x26,0xad,0x93,0x4e,0xae,0x91,0x39,0x73, + 0xbc,0x53,0xa8,0x3d,0x47,0xf9,0x1,0xa9,0x58,0x3d,0xd4,0xce,0x11,0x79,0xfd,0x98, + 0x5a,0x1f,0x51,0x9,0xf2,0x34,0x1e,0x5e,0xb2,0x4b,0x8b,0xf6,0xd0,0x5c,0x2e,0xf3, + 0xe3,0xd6,0x5,0xd4,0x19,0xe6,0xc8,0x48,0x1d,0x4b,0x57,0x66,0xaa,0x8,0x6b,0x41, + 0x27,0xce,0xb0,0x88,0x0,0x94,0x66,0xc5,0x19,0xe5,0xad,0x86,0xa1,0xfa,0x8,0x27, + 0x1a,0x73,0x98,0xec,0x73,0xa,0xd,0x9a,0x6a,0xa4,0x0,0xbe,0x48,0x88,0xe7,0xc4, + 0x6f,0xb3,0x9e,0x8,0xaa,0xe7,0x38,0xa6,0x6a,0xf9,0x32,0x42,0xfb,0x64,0x57,0xa9, + 0xbf,0xe3,0xe4,0x7c,0xdf,0x7c,0x52,0x99,0x65,0xa1,0xad,0x9e,0x45,0x2e,0x57,0x4c, + 0x3f,0x96,0x62,0xc,0x88,0x64,0x5e,0xe8,0x5a,0x7f,0xc2,0xd,0x3f,0x3e,0xa2,0x6a, + 0x36,0xa6,0xe6,0x97,0x65,0x24,0xe0,0xd5,0xde,0xe7,0xd2,0xa9,0x8c,0x8e,0x8b,0x74, + 0xfc,0x33,0x70,0x5d,0x14,0x9a,0x89,0x41,0x70,0x8a,0x23,0xe9,0x8,0xac,0x5,0x11, + 0x4f,0x59,0xc3,0x2b,0x5c,0x63,0x3b,0xb9,0x73,0xe7,0x44,0x42,0x86,0xa1,0x81,0x58, + 0x47,0xd7,0xfc,0xab,0xbc,0x74,0xeb,0xea,0x1d,0xe3,0x2c,0x8,0xcf,0xdd,0x8c,0xb3, + 0x92,0xf6,0xc4,0xfc,0x75,0x7c,0xd,0x56,0x30,0x48,0x8f,0x1c,0x57,0x58,0x7b,0x62, + 0x1a,0x40,0x8d,0x3a,0x50,0xa9,0x38,0x60,0x53,0x55,0xcd,0x52,0x5e,0xb7,0x47,0x28, + 0xf3,0x33,0x6d,0x35,0x54,0x13,0x12,0x8f,0x5b,0x1b,0xd5,0xe,0xa9,0x47,0x33,0x7b, + 0xe5,0xde,0xaa,0x84,0x80,0xfa,0x96,0x85,0xf1,0x7d,0x2,0x6e,0xe2,0x1d,0xb1,0xda, + 0xa7,0x1d,0xf5,0xa8,0x15,0x97,0x79,0x59,0x46,0x67,0x6e,0xe0,0xf5,0x59,0xec,0xe6, + 0xfd,0xa,0xf4,0xaa,0xbe,0xbe,0xf5,0x25,0xcc,0xc7,0x8f,0x40,0xad,0x8a,0x32,0xd1, + 0x70,0x11,0x34,0xb9,0x92,0xf4,0xfc,0xcf,0xd9,0x26,0x8,0xd1,0x15,0x3d,0xb,0xdf, + 0x63,0x41,0xd8,0xfd,0xd4,0xf8,0xe5,0x25,0xe3,0xe0,0x6,0x6b,0xd4,0xa0,0x66,0xe0, + 0x2,0x82,0x82,0xaa,0xe6,0x57,0xa4,0x9c,0x39,0x91,0x64,0xb8,0xb9,0x72,0xda,0xf9, + 0x5c,0x8e,0x22,0xa3,0x9e,0xdc,0x72,0xa4,0xe6,0xd7,0x21,0x2d,0x5f,0x83,0x15,0xef, + 0x7c,0xcf,0x6b,0xaf,0xc6,0x24,0xcb,0xf5,0xd2,0x17,0x27,0x3e,0x12,0xf1,0xf7,0x6b, + 0x6f,0x81,0x81,0x82,0xab,0xd0,0x8e,0x56,0xc4,0x65,0xa3,0xed,0xc3,0xa3,0x9e,0xf2, + 0x94,0x55,0x23,0x35,0xaf,0x88,0x73,0x7,0xd3,0xcf,0x1f,0x25,0x3c,0x6c,0x25,0x90, + 0x1b,0x35,0x26,0x9b,0x5d,0xf4,0x76,0x26,0x68,0xfe,0x34,0xbd,0x42,0xfd,0x54,0x7, + 0x8,0xf5,0x65,0x76,0x46,0x38,0xf7,0xf3,0x4c,0xe6,0x7a,0x13,0xe2,0xe,0xda,0xf4, + 0x14,0x48,0xe,0x78,0xa2,0xf2,0x42,0x57,0xd4,0xd3,0xc1,0x59,0xa0,0x22,0x6d,0xa, + 0x49,0x2e,0xe8,0xcb,0x69,0xa8,0xa8,0xa7,0x52,0x11,0x92,0x97,0x3d,0x5c,0xb2,0x4c, + 0xc8,0xba,0x15,0xe9,0xcf,0x8d,0x32,0x1a,0x38,0x18,0xf1,0x7e,0x1e,0xbd,0x2f,0x62, + 0xb9,0x4d,0x7a,0xdd,0x66,0xcd,0xc6,0x3c,0x7f,0xd4,0x3,0x69,0x46,0xd0,0x80,0xf3, + 0xdd,0xf,0xf2,0x6f,0xfc,0x5,0x95,0xbc,0x25,0x61,0x43,0x90,0x3,0xa2,0x9,0x42, + 0x5c,0xe2,0xca,0x9,0x8d,0x3b,0xeb,0x9,0x91,0x75,0x83,0xf5,0xf5,0x29,0x27,0xd9, + 0xa3,0x41,0x4a,0xe7,0x82,0xda,0x2,0x99,0xcf,0xf7,0xa3,0xaf,0xf3,0x74,0xa7,0x3f, + 0x5f,0xc4,0x66,0xdb,0xf1,0x32,0x58,0xba,0xca,0xd7,0x92,0x4b,0xc4,0x44,0x2,0x6a, + 0xa8,0x84,0xb2,0x8c,0xbc,0xe7,0x5c,0xb2,0x4f,0x7a,0xb9,0xa1,0x23,0x62,0xe4,0x61, + 0xf,0x3e,0xed,0x53,0xb1,0x8e,0x9d,0x24,0x91,0xd0,0x8e,0x2a,0x4e,0xc5,0x4e,0x7e, + 0x49,0xf7,0x6c,0x44,0x64,0x6c,0xb4,0xa3,0x22,0xf7,0xca,0xe6,0xba,0xe6,0x6b,0x9e, + 0x4c,0xd0,0x4e,0xdb,0xe6,0xb2,0x42,0x97,0x4f,0x78,0x69,0xfc,0x54,0x66,0xe9,0xf6, + 0x3c,0x8,0x7d,0x5e,0x89,0xcd,0xb3,0x23,0xe7,0x0,0x39,0x7a,0x4c,0x2e,0x18,0x3f, + 0x30,0x72,0x9a,0xa8,0x52,0xd7,0x92,0x9f,0x47,0xe3,0xea,0x24,0x4,0xb2,0xb7,0x35, + 0xd9,0x39,0xa7,0x86,0x7b,0x99,0x12,0x57,0x93,0x90,0x72,0x2d,0x6a,0xe0,0x30,0xf8, + 0xfd,0xab,0x5f,0x68,0x3,0x66,0xee,0x75,0x79,0x6d,0x50,0x68,0x26,0xd2,0x87,0xb5, + 0xf1,0xce,0x5f,0x4c,0xb5,0xd7,0x37,0xd4,0x29,0xf6,0x40,0x35,0xf0,0x26,0x67,0x9d, + 0xdb,0xdc,0x64,0xfe,0x31,0x94,0xd3,0x96,0x37,0x2f,0xd2,0xc9,0xd7,0x1a,0x35,0x7a, + 0x8c,0xd2,0x9e,0x20,0x12,0xd6,0x5e,0x7c,0xcb,0x88,0x85,0x4f,0xbe,0xbc,0x87,0x89, + 0x84,0x67,0xac,0xc0,0x0,0x1d,0x7,0xfb,0xb0,0x8c,0x95,0xaa,0x15,0x33,0x29,0xd4, + 0x45,0x81,0x14,0xd2,0x25,0x6a,0x94,0xf1,0xe0,0x2f,0x52,0xf3,0x2d,0x3a,0xe6,0xb3, + 0x1e,0xec,0xa2,0x6d,0x6e,0x11,0x36,0x4d,0x6a,0xa3,0x69,0xab,0x83,0x8f,0x7a,0x3e, + 0x62,0xea,0xd6,0x23,0x75,0x60,0xbc,0xb,0xf7,0x5,0x29,0xab,0x40,0x39,0xed,0x9, + 0xc5,0x74,0x82,0x72,0xe2,0x1b,0x2c,0x31,0xc4,0xf7,0x6a,0xa4,0xb2,0x4c,0x3a,0x4b, + 0xe4,0x64,0x1e,0x5a,0xfa,0xd1,0xa4,0xec,0x2,0x16,0xfe,0x71,0xf0,0x99,0x4e,0x9c, + 0x63,0xf0,0x46,0xc4,0x7a,0xc,0xb6,0x25,0x47,0xcf,0xc3,0xc3,0x64,0x24,0x5c,0xf6, + 0x94,0xf8,0x56,0xd2,0xa8,0x3f,0xd3,0xd9,0xc3,0x4c,0xc7,0x46,0x3b,0x85,0xe5,0x97, + 0x5e,0xb4,0xaf,0x87,0xae,0x71,0x5,0xc9,0xeb,0xba,0x6b,0xc4,0x45,0x64,0x55,0xc4, + 0x83,0x8d,0x58,0x11,0x73,0x7d,0xb6,0xa7,0xab,0xd2,0x31,0x91,0x8f,0x7a,0x0,0x3d, + 0x66,0x3,0x44,0xa2,0x4f,0xed,0x7,0x7b,0xc1,0x71,0xa9,0x9b,0x76,0xe5,0x4c,0xfa, + 0x91,0x5d,0x7f,0x5,0xc6,0x1,0xd4,0x9e,0x69,0xda,0x2a,0x5,0x4e,0x45,0x76,0xce, + 0xfb,0x26,0x8b,0xaa,0x54,0xec,0xe4,0x22,0x20,0x7d,0xfe,0x29,0x26,0xf6,0xa7,0xa7, + 0xa7,0xd9,0xc2,0x50,0x7c,0x69,0xe1,0xa2,0x71,0xfc,0x73,0x36,0xc5,0x15,0x5d,0x11, + 0x71,0xee,0xff,0xa6,0x57,0xa8,0x2f,0x65,0xe8,0xa8,0x4a,0x64,0x84,0xe6,0xc3,0x9e, + 0x65,0x8d,0x28,0x74,0x75,0xf9,0xb9,0xe6,0x53,0xb9,0x56,0x10,0xe7,0x47,0x27,0xd2, + 0xd4,0x8f,0x5b,0xa5,0x95,0x1e,0x27,0x1b,0x91,0xd4,0x87,0x27,0xb3,0xbe,0x5e,0x71, + 0x38,0x4f,0x63,0x4d,0x74,0xfa,0x53,0x42,0x11,0xd5,0xef,0xe7,0xfb,0xb,0xdf,0x62, + 0x68,0xbe,0x65,0xb4,0x23,0x2,0xfe,0x60,0x1f,0x3f,0x6,0x96,0x66,0x22,0x19,0x57, + 0x60,0x98,0x1e,0x77,0x68,0x3e,0x86,0x12,0xe,0xac,0xb0,0x2f,0xa9,0x5c,0x47,0x20, + 0x37,0xf0,0x17,0xd6,0x45,0x9b,0x5a,0xf8,0x25,0xb4,0x73,0xbe,0x9e,0x8,0x53,0x3e, + 0x20,0x2a,0x3,0x53,0x94,0x34,0xd3,0xed,0x96,0x65,0xe6,0x1e,0xe8,0x4c,0x8b,0x8a, + 0x50,0xa5,0xdb,0xf6,0xfd,0x51,0xaa,0x1e,0x84,0x32,0x35,0xe0,0x24,0xa5,0xb4,0x51, + 0x4f,0x6b,0x9f,0xca,0x51,0x54,0xc,0x70,0xdd,0x1f,0x92,0xbc,0xca,0x25,0xd1,0xd0, + 0xe2,0xf,0x5f,0x1a,0xae,0x2c,0x57,0x31,0xfd,0x4a,0x95,0x48,0x5c,0x51,0x9e,0x38, + 0xe6,0xa3,0xb6,0x9a,0xb0,0x2c,0xe0,0x21,0x83,0x11,0x22,0x44,0xa8,0xa3,0xde,0xf8, + 0x2d,0xf9,0xdd,0x55,0xa0,0x1a,0xff,0x75,0xa1,0x8b,0xb4,0xf0,0xf9,0xa9,0xa6,0x5c, + 0x77,0x3c,0x98,0xa2,0x6c,0x88,0x74,0x52,0x9b,0x72,0x72,0xc7,0x80,0xb8,0x8,0x2b, + 0xe6,0xa2,0xac,0x1a,0x2e,0xba,0x54,0x92,0xd1,0x94,0x9c,0x75,0x29,0x7,0xc2,0x4b, + 0xd3,0xd9,0xd2,0x3c,0x92,0x4f,0x77,0x78,0x80,0x20,0x3d,0x42,0x3b,0xc7,0x51,0x24, + 0x60,0x4d,0xb2,0xa0,0x98,0x47,0xa5,0x85,0x7a,0x5,0xe9,0x12,0xd0,0x9c,0xc7,0x18, + 0x19,0xd9,0x29,0xc4,0xe5,0x6b,0xf2,0xb6,0x26,0xfa,0xd9,0xe9,0xcc,0x90,0x5e,0xa, + 0xce,0x56,0x4b,0xb9,0x7c,0x38,0x29,0xa9,0xf8,0x2f,0x40,0xf0,0x3a,0x9c,0x73,0x97, + 0xe2,0x19,0xd4,0x30,0x8b,0x59,0xd4,0x51,0x43,0x1d,0x75,0xc1,0x88,0x91,0xf9,0xf7, + 0xd2,0xd5,0xfc,0xaf,0x1b,0xdd,0xa8,0x90,0x55,0xa5,0x8a,0x98,0xbf,0xc7,0xcf,0xd3, + 0xe6,0x74,0x50,0x77,0x33,0x92,0xeb,0x6f,0xf8,0xa9,0xdb,0x76,0x74,0x36,0x99,0xd4, + 0x4c,0xca,0x4a,0x93,0x1,0x31,0x32,0xbf,0x4b,0x7f,0x24,0xac,0x27,0x24,0x94,0x25, + 0x58,0xe,0xed,0x31,0xea,0x39,0x5f,0x10,0x86,0xac,0xad,0x58,0xe3,0x2,0xec,0x89, + 0x42,0x17,0xa9,0x45,0x4c,0xd4,0xe3,0x3f,0xc,0x90,0x5f,0x30,0x55,0x36,0xe7,0xf3, + 0x10,0xdd,0x35,0x33,0x6e,0x51,0x45,0x8b,0x3d,0x42,0xd7,0x44,0x9d,0xbc,0x63,0xf2, + 0xdd,0xf1,0xb2,0x86,0x69,0xcc,0x60,0x16,0x33,0x98,0x4d,0x1a,0xcc,0xa9,0x52,0x5, + 0x65,0x19,0xe,0x2a,0x71,0x2e,0xd4,0x50,0x33,0x9e,0xb7,0x82,0x1e,0x74,0xa3,0xb, + 0xbd,0xc6,0x9,0xa7,0xd9,0xcb,0x8f,0x2d,0xa9,0x70,0xbe,0x21,0x27,0xcb,0x0,0xfc, + 0xe8,0x7a,0x93,0x68,0xdb,0x50,0x54,0x8c,0xce,0xae,0xc,0x8a,0x1d,0x89,0x24,0x19, + 0xfb,0x4c,0x34,0xa4,0x99,0x8d,0x9b,0xd6,0xc,0x8f,0x59,0x20,0x3c,0xf7,0x2c,0xd5, + 0x6f,0x82,0x30,0x8e,0x83,0x6b,0xa1,0xc9,0xf2,0x34,0xc5,0x7e,0x80,0x8a,0x29,0xc7, + 0x4e,0xf6,0x52,0x70,0xa7,0xbc,0x49,0x63,0xe1,0x8d,0xb0,0x10,0x99,0xf2,0x32,0x9a, + 0x9a,0xbe,0xaa,0xd2,0x80,0x94,0xac,0x3a,0xa5,0x9c,0x86,0x3b,0x18,0x9d,0x94,0x9e, + 0xab,0x92,0x8e,0x87,0xca,0x49,0x92,0x79,0xb5,0xd5,0x5,0xd8,0x19,0x4c,0x63,0x1a, + 0x33,0x98,0x46,0xdd,0xa2,0xaa,0x10,0xc0,0xf,0xa9,0x13,0x32,0xfd,0xff,0x8,0xd3, + 0x98,0x6e,0xbc,0x8f,0x6e,0x74,0xa3,0x7,0xbd,0xe8,0x16,0xac,0x41,0xaf,0x3c,0xcd, + 0xb4,0x31,0x20,0x23,0x27,0x20,0x61,0x49,0x77,0xa,0xfc,0xaa,0xbe,0x9a,0x2c,0x5f, + 0x8b,0xf3,0x41,0x8,0x9,0x68,0x7a,0x9f,0x1,0x42,0xd5,0x75,0x31,0xee,0xb2,0x40, + 0xd8,0x3d,0x90,0xa4,0x86,0xf1,0xd7,0xdd,0x9f,0x28,0x55,0xb6,0x7f,0xd3,0x8e,0x35, + 0x75,0x69,0x3b,0x1e,0x8e,0x19,0xd0,0x8a,0x18,0xc5,0x9e,0x6,0x93,0x3f,0xea,0xb9, + 0xea,0x45,0x65,0xd9,0x9f,0x82,0x7f,0x65,0x5a,0x17,0x3d,0xa6,0x8c,0x78,0xe,0x7e, + 0x69,0xcf,0xcb,0xd,0xa7,0xf0,0xd1,0xf7,0x9c,0xba,0x5a,0xc7,0x14,0xa6,0x31,0xd5, + 0x80,0x5e,0x12,0x70,0x14,0xc5,0xb5,0x81,0xe8,0x8e,0x87,0x74,0xbc,0x98,0xc5,0x2c, + 0x26,0xa1,0xa1,0xd0,0x83,0x5e,0xf4,0xa2,0x3b,0x55,0x50,0xcd,0x7f,0x7f,0xc9,0xca, + 0x19,0x77,0xbd,0xa8,0x26,0x2f,0xab,0x74,0x54,0x9c,0x3f,0x43,0x93,0xe5,0xdc,0xc9, + 0xf2,0xb5,0xb8,0x6b,0x30,0xa,0xca,0x4,0xcd,0x5b,0x89,0x5e,0x8a,0x1,0x2,0x84, + 0xd1,0x66,0x95,0x3a,0xf1,0xe7,0x3f,0xec,0x35,0x48,0x76,0xc,0x98,0x39,0x15,0x48, + 0x82,0x69,0x1b,0xcc,0xe9,0xcc,0x8e,0x2f,0x4c,0xe3,0xaa,0x68,0x14,0xb3,0x8f,0x2a, + 0x62,0x73,0x43,0x55,0xa7,0x72,0x41,0x59,0x77,0x3d,0x9d,0x17,0x6a,0x8b,0xa6,0xfa, + 0xfa,0x27,0xdc,0xeb,0x50,0x70,0xd5,0xa3,0xae,0x1c,0x31,0x19,0x21,0x23,0x16,0x90, + 0xca,0xd0,0x6d,0x4f,0x60,0x12,0xd3,0xcd,0x29,0x60,0x9a,0x8c,0xb1,0xc5,0xc5,0x41, + 0x8a,0xd3,0x28,0x68,0xcc,0x60,0xa6,0x31,0xaf,0xba,0x7,0x3d,0xe8,0xb6,0x24,0x16, + 0x89,0x6f,0xa8,0xd9,0x4b,0x14,0xdf,0x3e,0x17,0x81,0xee,0x40,0xe4,0x1c,0xf0,0xe4, + 0x74,0x9a,0xb0,0x4c,0xd0,0xbc,0x95,0xa8,0x9a,0xd9,0x4c,0xe4,0x84,0x95,0xcd,0xe9, + 0xaa,0xc0,0x24,0x1d,0xe5,0x5e,0xa0,0xcb,0xa,0x56,0xa0,0xea,0xd7,0xe9,0x81,0x14, + 0xf6,0x97,0xab,0x99,0x2e,0x5,0xed,0xd4,0xf1,0x14,0x5c,0xcb,0x66,0x29,0x11,0x78, + 0x15,0x29,0xc1,0xa8,0xd4,0x6b,0xa1,0x86,0x5b,0xf8,0xfb,0x27,0xf8,0xf2,0x35,0x7f, + 0xbc,0x75,0x8b,0x29,0x54,0xd5,0x68,0xfa,0x11,0x6b,0x38,0xd6,0xe8,0x7d,0x4b,0x7f, + 0x4f,0x7c,0x1c,0xe4,0x81,0x98,0x25,0xe,0x52,0xa7,0xea,0x34,0xa6,0xa1,0x51,0x41, + 0x2f,0x7a,0xd0,0xb,0xbb,0x3f,0x42,0xb1,0xbd,0x7c,0xc9,0x8,0x4a,0x1,0x32,0x62, + 0x8b,0x11,0xe8,0x96,0x5f,0xf7,0x78,0xb2,0x28,0xf5,0x59,0x48,0x32,0x41,0x86,0x13, + 0x6d,0x22,0x40,0xa8,0x37,0xd9,0x19,0xc8,0x7c,0x1b,0x93,0x2d,0x63,0x68,0xb2,0x63, + 0x1e,0xc2,0x5c,0x90,0x52,0x40,0x6d,0x2,0x4a,0xf5,0x4f,0xa4,0xab,0x42,0x61,0xd5, + 0xa6,0xa6,0x2b,0x41,0x15,0x9b,0x5,0x6a,0x81,0x1c,0x64,0x3e,0x62,0x44,0x9e,0x7e, + 0xae,0xfc,0xd4,0xdf,0xd6,0x44,0xeb,0xa4,0x5c,0xae,0xeb,0x6,0x9f,0x9b,0xa0,0x46, + 0x38,0x8e,0xe3,0x98,0x60,0x80,0xea,0x8a,0x83,0x1c,0x21,0xcd,0x1b,0x7,0xed,0xa6, + 0xb8,0x29,0x4c,0x61,0x6e,0xc1,0xe9,0x1e,0xc3,0xc0,0xf6,0x47,0x40,0xed,0x34,0x2e, + 0x34,0x1,0x48,0x3b,0x2a,0x26,0x61,0xad,0x9c,0xeb,0x59,0x84,0x65,0x82,0xe6,0x3b, + 0x34,0x78,0xc,0x5,0x42,0x6c,0xb6,0x7d,0xae,0x39,0x79,0xa6,0x8f,0x18,0x91,0x3, + 0xb6,0xee,0x0,0x8e,0xd2,0x6c,0xf7,0x29,0xa6,0x88,0x69,0xa0,0xca,0x31,0xdd,0x8b, + 0x2f,0x62,0x93,0x67,0x84,0x5c,0x73,0x14,0x37,0x2,0xc3,0x2f,0xc8,0xb8,0xfb,0x1f, + 0x14,0x5c,0xbd,0x81,0x8a,0x5,0x9f,0xf2,0xa,0x32,0xae,0xc8,0x39,0x83,0x71,0x1c, + 0x23,0xe3,0x2d,0xd,0x45,0x1f,0x21,0x95,0xe8,0xa3,0xf2,0x38,0x98,0x3e,0x65,0x67, + 0x30,0x3,0xa0,0xb,0x3d,0xe8,0x41,0x97,0x93,0xa0,0x72,0x3a,0x29,0x35,0x9c,0xc2, + 0xd5,0x45,0x41,0xb5,0x53,0x45,0x5e,0x8,0x4a,0x81,0x98,0x7c,0x46,0x65,0xe1,0xcd, + 0x4,0xe1,0x26,0x90,0x19,0xc2,0xaa,0x6,0x57,0x57,0x89,0x92,0xb2,0x24,0x95,0x53, + 0x4c,0x13,0x92,0xad,0x2e,0xba,0xae,0x14,0x94,0x79,0x1f,0x19,0x7f,0x47,0xdb,0xed, + 0xca,0xe1,0x57,0xaa,0xc,0xc6,0x5,0x44,0x0,0xf6,0x19,0xf5,0xca,0xb2,0xe6,0x5d, + 0xa3,0xef,0x15,0x49,0xe9,0x15,0x9,0x93,0x90,0x36,0x5e,0x0,0x98,0xc0,0x18,0xa6, + 0x88,0x2c,0xdd,0x97,0xd,0xd2,0x84,0xd4,0x27,0xd0,0x64,0x8f,0x83,0xb6,0x92,0x58, + 0xc3,0x24,0xba,0xd0,0x8d,0xde,0xa6,0xcb,0x18,0x39,0x2d,0x1b,0x4a,0x27,0x55,0x44, + 0xe1,0x1b,0xdd,0x45,0x11,0x47,0x45,0x6e,0x61,0x99,0xac,0x99,0x60,0x32,0x16,0x36, + 0x23,0xfc,0xd9,0x97,0xf7,0xdc,0x3b,0x9b,0x0,0xe1,0xb,0xba,0x77,0x9f,0x4d,0xc9, + 0x32,0x73,0x71,0x90,0xcf,0x3,0xb9,0x48,0xa5,0x18,0x53,0xde,0x2e,0x8b,0xa6,0x92, + 0x69,0x38,0xd4,0x52,0xff,0x3d,0xee,0xfc,0x8f,0x37,0x2e,0xb8,0xbc,0x90,0x96,0x62, + 0x38,0xbf,0x50,0x11,0x51,0x8f,0x9a,0x48,0xd,0x50,0x23,0x2e,0xd2,0x1a,0xb0,0xe4, + 0x82,0xa0,0x58,0x70,0x1e,0xc7,0xd1,0xa6,0xf8,0xa2,0xbc,0xb9,0xa3,0x9b,0x90,0x86, + 0xf9,0x84,0x59,0xe3,0x60,0xfa,0x67,0x1d,0x75,0x4c,0x35,0x5d,0x46,0x8a,0x5a,0x6a, + 0xa7,0x20,0xa3,0x59,0xb3,0xc2,0xb5,0x70,0x28,0x65,0x92,0x84,0x49,0x32,0xdc,0x2d, + 0xe3,0x2c,0xe8,0x3e,0x72,0x36,0x86,0x12,0x20,0x1c,0x3e,0xbb,0xd2,0x43,0x69,0x69, + 0xc0,0x1a,0x47,0xa7,0x44,0xb2,0x3c,0x2d,0x2d,0xc5,0x68,0x62,0xc6,0x1a,0x65,0xce, + 0x2b,0xe7,0xf0,0xa,0xed,0xac,0xc8,0xe1,0xad,0x7f,0xd9,0x82,0x22,0x0,0x9c,0xa5, + 0x3,0x1a,0x20,0xec,0x7c,0x2e,0x2f,0xcc,0x56,0xbe,0xe6,0x92,0x5d,0x94,0x80,0x7a, + 0xd2,0x20,0x3d,0x81,0x6a,0xa3,0xb8,0xca,0x17,0x5,0xc3,0x55,0xd1,0xf2,0xe3,0x60, + 0x3a,0x5b,0x9c,0xc6,0x34,0x14,0xba,0xd1,0x83,0x8a,0xb7,0xb6,0x85,0xea,0xa8,0x50, + 0xc,0xc8,0x14,0x61,0x6c,0x68,0x4b,0x1b,0x45,0x62,0x8e,0xa8,0x4c,0x92,0xa1,0x6f, + 0x99,0xdf,0x44,0xf7,0xa6,0x79,0x10,0x56,0x9a,0x3b,0x8,0x97,0x50,0x1,0x58,0x1, + 0x7a,0xe1,0x14,0xcd,0xcc,0x9d,0xd2,0x64,0x21,0x90,0x4e,0xd1,0x0,0x7a,0x90,0x2a, + 0x37,0xb0,0x95,0x5a,0x4b,0x1e,0xf0,0xd,0x47,0x7,0xe9,0x94,0x71,0xcb,0x50,0x46, + 0x9e,0xfe,0x42,0xcd,0x8c,0xcd,0x4b,0x3e,0x43,0xe4,0x1c,0xd,0x44,0xaf,0x7e,0x80, + 0x94,0xb8,0x60,0xdb,0xcb,0xee,0x55,0x82,0xd3,0xc,0x43,0x63,0x12,0x4f,0xe0,0x90, + 0x31,0x66,0x4f,0x35,0xff,0x4b,0x82,0x31,0xb9,0xc7,0xbc,0x9d,0xfe,0xdd,0xf5,0x9b, + 0xeb,0xff,0x4a,0xd8,0x67,0x20,0xf9,0xa9,0x31,0x83,0x13,0x98,0xc0,0xc,0xec,0xfe, + 0x6,0x4d,0xc,0x55,0x34,0xbb,0x1c,0xe3,0xe9,0x6a,0x5c,0x17,0x85,0x36,0x80,0x9, + 0xe2,0x7c,0x92,0x96,0x69,0xbb,0x6f,0x25,0xea,0x47,0x37,0xa7,0x72,0xc2,0x68,0x33, + 0x8,0x97,0x10,0x50,0x58,0xc1,0xce,0x61,0xe6,0xcd,0x8,0x5b,0xfc,0x57,0xa4,0xe, + 0xaa,0x59,0x9a,0xca,0x8d,0x28,0x74,0x7b,0x6c,0xbe,0xd8,0x28,0x5d,0x6e,0x4b,0x46, + 0x3,0x29,0x41,0x6,0x90,0xf6,0x4,0xfa,0x97,0x98,0xe1,0xea,0x3d,0xdd,0x35,0x31, + 0x35,0x54,0x71,0x82,0x95,0x71,0xb2,0xa,0x33,0xb,0x19,0x7,0xd3,0x4,0xb5,0x86, + 0xe9,0x46,0x55,0xaa,0xf2,0x74,0xd4,0x53,0xd4,0x93,0xa2,0xa4,0x9a,0x88,0x96,0x5a, + 0xe4,0x34,0xcb,0xed,0x9,0xdb,0x29,0x8c,0xfd,0x88,0x79,0x61,0xe6,0x5c,0xda,0xda, + 0x45,0xa3,0x6e,0xd4,0x74,0xf4,0xb8,0x8f,0x17,0xcc,0x20,0x5e,0x9f,0x11,0x1f,0x42, + 0x40,0xed,0x41,0x19,0xb4,0xe9,0xcf,0x8f,0x3b,0xc,0xe9,0x4b,0xf7,0x5b,0xf4,0x10, + 0xaa,0xa5,0x61,0x64,0x34,0x29,0xee,0xc8,0x7,0xe0,0x47,0x38,0x8a,0x71,0x22,0xe7, + 0xe3,0x72,0xc1,0x30,0x61,0xa6,0xd5,0xf9,0x20,0x97,0x28,0xcc,0xe7,0x8a,0x68,0x0, + 0x11,0xce,0x16,0x27,0x9e,0xa6,0xd2,0xc7,0x9a,0xef,0x4c,0x5,0x2,0xd1,0x5,0x4b, + 0xe2,0x82,0x98,0x8e,0x84,0x38,0x9d,0xa3,0xa3,0xcb,0xe1,0x5a,0x1a,0x52,0xc1,0x5e, + 0x7c,0x31,0x1d,0x1,0x23,0x52,0x3a,0x50,0x44,0x41,0x92,0x22,0x84,0xfe,0xa4,0x88, + 0x92,0x5c,0x74,0xd4,0x35,0x36,0x50,0xba,0x88,0x9b,0x74,0x12,0x9b,0x3d,0x93,0x46, + 0xa6,0x96,0xca,0x2b,0x66,0x68,0x33,0x82,0x7,0x7c,0xfa,0x91,0xa6,0x31,0xd2,0xcc, + 0x2,0xb9,0x79,0x6,0x45,0xa,0x33,0xbe,0x78,0x58,0x46,0x1c,0x4c,0x3e,0x5a,0xd, + 0xb5,0x6,0x14,0x41,0x9c,0x4d,0xdc,0x82,0xe1,0xb4,0xc1,0xa6,0x53,0xa3,0xc6,0x34, + 0x51,0x5b,0x15,0x6a,0xce,0xdb,0x47,0x26,0x9c,0xc2,0xd3,0xd3,0x20,0x5c,0x9f,0x3c, + 0xa1,0x4c,0x3a,0xea,0xb2,0x24,0x28,0xc2,0xa4,0x2d,0x53,0x41,0xa7,0x4e,0x53,0x6d, + 0x1,0xd2,0xad,0x96,0x6a,0x91,0x20,0xe3,0x8a,0x8d,0xd2,0x69,0xe1,0x5c,0x49,0xb9, + 0x7d,0xe2,0xc1,0x21,0xd1,0x70,0x8e,0x9f,0xb,0x7e,0x14,0xf8,0x94,0xb7,0x56,0x26, + 0x7e,0xd6,0xb1,0x86,0x13,0x48,0xc5,0x40,0x77,0x14,0xcc,0x2a,0xcc,0xf8,0xe2,0x61, + 0x79,0x71,0x30,0x79,0xbe,0xd5,0x50,0x43,0x5,0x95,0xa6,0x91,0xc1,0x8d,0xb8,0xf0, + 0x45,0x3f,0x45,0xd4,0x4f,0x65,0x29,0xd3,0x76,0xbf,0x7f,0x63,0x5b,0x97,0x6,0x61, + 0x7f,0xfa,0x4b,0x9a,0x3,0x62,0x17,0x96,0xa,0x2c,0x9,0xaa,0x0,0x4c,0x13,0x6a, + 0x69,0x32,0xef,0xe3,0x1a,0x96,0x14,0x4b,0x30,0xed,0xf9,0xa4,0xca,0xaa,0xaf,0x71, + 0x8d,0xd4,0xd,0xfd,0x49,0xdd,0xf2,0xcf,0x99,0x51,0xec,0x80,0x7c,0x30,0x6e,0x68, + 0x1a,0x7e,0xca,0x9,0x5d,0xbb,0xa3,0x62,0xa,0x23,0x8d,0x4e,0x6f,0xed,0xb4,0x31, + 0x28,0xe8,0x65,0x29,0xdb,0x6e,0x87,0x38,0x98,0xbc,0x1d,0x35,0xe6,0xe4,0x56,0x0, + 0x36,0xd2,0x71,0xd1,0xcf,0x6,0x5f,0x3a,0x16,0x66,0x37,0xe7,0xa9,0x58,0xd8,0x1c, + 0x2,0xdc,0xcf,0x82,0x30,0x29,0xcb,0x2c,0xb7,0x62,0x94,0x62,0xd3,0x78,0x9d,0x32, + 0xcf,0x5d,0x66,0x4,0x3d,0xaf,0x5a,0x39,0x8,0xa8,0xbb,0xf1,0xc8,0xac,0xaf,0xa1, + 0x63,0x63,0xbe,0x8c,0x10,0xa9,0x28,0xae,0x12,0x3d,0x65,0x36,0x44,0xed,0xda,0xa3, + 0x74,0x2e,0x68,0x52,0x4f,0xf7,0x48,0x26,0xdf,0x3a,0xc3,0x55,0x1c,0x67,0xe2,0x9f, + 0x5c,0x9a,0x9,0x17,0x66,0xda,0x23,0xe,0xa6,0xb,0x16,0xa3,0xa6,0xe0,0x4f,0x9f, + 0x33,0x14,0xf5,0xb4,0xc1,0xe7,0xe3,0x50,0x72,0x73,0x1e,0x8e,0x45,0x15,0x62,0xcc, + 0x35,0x2c,0xa,0xb5,0x8e,0xfe,0xaa,0x96,0x7,0xcd,0x94,0x49,0xb2,0xee,0x8,0xf6, + 0x1c,0xf,0x5b,0xa8,0x8f,0x8,0xcb,0x81,0x1a,0x7a,0xc8,0xf7,0x95,0x99,0xf6,0x87, + 0x74,0x5d,0x1,0xd9,0x24,0x11,0xee,0x96,0x7f,0x99,0xb0,0x78,0x10,0xa0,0x62,0xde, + 0x49,0xfa,0x1e,0xb0,0xf3,0x61,0x5c,0x13,0x60,0x66,0x70,0xc0,0x80,0x20,0x1d,0x3, + 0x29,0x7b,0x22,0x6d,0x50,0xd8,0xb7,0x20,0xb2,0x25,0x14,0xf3,0x7f,0x5b,0xd6,0x47, + 0x2e,0x7b,0x42,0x79,0x6e,0x9b,0xd1,0xbb,0xde,0x1c,0xc0,0x41,0x77,0xd9,0x27,0x33, + 0x6f,0x38,0x6f,0xb9,0x47,0x37,0x49,0xec,0x89,0xf4,0x5e,0xe3,0xfb,0x5d,0xb9,0x69, + 0x69,0x2,0x84,0x7a,0x6d,0xfa,0x6a,0x6d,0xca,0x32,0x9a,0x1d,0x4,0xa0,0xd9,0x91, + 0x4d,0x49,0xe0,0x45,0xec,0x50,0x22,0x6e,0xe8,0xe,0x35,0xae,0x29,0x32,0xfc,0x1e, + 0xae,0xf3,0x9a,0x1b,0xf9,0xe3,0x77,0x7,0x29,0xbf,0x31,0xf2,0xb8,0x8f,0xfc,0x42, + 0xd1,0xf6,0x80,0xa4,0xc8,0x3,0xbf,0x34,0x6d,0x74,0x4d,0x5a,0xd3,0xd,0x43,0xfe, + 0x10,0x6a,0x6,0xcc,0x92,0xff,0x49,0xe0,0xc8,0x43,0xd1,0xed,0x14,0xaa,0x16,0xfa, + 0x83,0xca,0x4a,0x94,0xec,0xdb,0xca,0x82,0x4f,0x4,0x6a,0x9,0x70,0x29,0xf8,0xcc, + 0x3d,0xb2,0x71,0x4e,0x70,0x42,0x4f,0x91,0x4c,0xa5,0xb7,0xdf,0x0,0xe1,0xc5,0x2b, + 0xb1,0xd4,0x56,0xf0,0xe6,0xe8,0x68,0x44,0x9a,0xf1,0x9a,0x9c,0x8a,0xa6,0x9,0x3, + 0x94,0x5b,0x5b,0x5e,0x33,0x56,0xab,0x39,0x6e,0x4e,0x3b,0x46,0xfb,0x50,0xcb,0x8d, + 0xba,0x1d,0x37,0xc9,0x24,0x13,0x7a,0xf4,0xb9,0x26,0x86,0xc4,0x73,0x83,0x82,0x4d, + 0x22,0x97,0x6,0x67,0xc,0xcb,0x88,0x81,0x9f,0x16,0xc6,0x43,0x20,0xc2,0x8,0x46, + 0x9d,0x2e,0xa6,0x12,0x46,0xc1,0x93,0x29,0xe,0xda,0xb6,0x4c,0x28,0xf8,0x14,0x1, + 0xc7,0xec,0xe6,0xbc,0x7d,0x81,0x32,0x99,0xdf,0x6c,0xbf,0x91,0x13,0x4e,0xf4,0x2b, + 0x4b,0x50,0x99,0xdb,0xb3,0x94,0x28,0x79,0xe2,0x3a,0xe3,0x93,0xe5,0x6b,0xda,0x61, + 0x46,0x24,0xaf,0xf7,0x8a,0xac,0x1a,0xb5,0x39,0xbf,0x9d,0x27,0x29,0x62,0x3c,0x14, + 0x9f,0x17,0xe6,0xcb,0x6,0xed,0xd7,0xab,0x1c,0xee,0x60,0x44,0xe4,0x57,0x9a,0xcc, + 0x84,0x95,0xe5,0x5,0x2a,0xf8,0x7b,0xe5,0x67,0x31,0xd2,0x58,0xb,0x8,0x22,0xcf, + 0x52,0x2a,0xcc,0x14,0xd3,0x3f,0xb1,0x10,0xf9,0x20,0xfd,0x1b,0xac,0xbf,0x90,0xdd, + 0x2,0x63,0x55,0x84,0x17,0xaa,0xb9,0x9c,0xc2,0x8a,0x9,0xc2,0xca,0x3a,0xaa,0x84, + 0x58,0x35,0x75,0x1b,0x7b,0xde,0x89,0xfd,0x31,0x83,0x39,0x35,0x35,0x29,0x6c,0x70, + 0x80,0xe3,0x14,0x50,0xe5,0x98,0x4,0x93,0x96,0x94,0xd3,0x9d,0x8f,0x21,0xee,0xa0, + 0x3f,0x1,0x47,0x82,0x52,0xba,0xdd,0x41,0xbb,0x3a,0x48,0x31,0xfb,0x93,0xb1,0x90, + 0xaa,0x96,0x31,0xff,0x66,0x2,0x55,0x6f,0x41,0x37,0x7,0x4a,0xb7,0x41,0xe1,0x6b, + 0xe8,0x95,0xd4,0xcb,0xb4,0x56,0x17,0xa5,0x80,0x96,0x86,0x55,0x36,0xf0,0x81,0xd0, + 0xe8,0xc3,0x55,0x51,0x97,0x34,0x13,0xad,0x33,0x40,0x18,0xf5,0x2b,0xf2,0x8b,0x52, + 0xe8,0x49,0x45,0x22,0xdf,0x42,0x92,0xe9,0x8,0x18,0x31,0x66,0x4,0xed,0x34,0x72, + 0x2b,0x1f,0xd9,0x1f,0x91,0x8b,0x7a,0xfa,0x62,0xa3,0xcb,0x1d,0xd4,0x4e,0xd7,0x12, + 0x8c,0xca,0xab,0x9c,0x8d,0xbd,0xfe,0x15,0x94,0xec,0x75,0xe1,0xb9,0x6a,0x19,0xd, + 0x60,0x1c,0xc7,0x82,0xa2,0xb8,0xa4,0x7f,0xc2,0xa5,0x8a,0x9e,0xa,0x71,0xb0,0xe8, + 0x58,0x8,0x36,0x26,0x26,0x1e,0xdf,0x8c,0x84,0xaa,0x1f,0xc,0x1d,0xed,0x26,0xfb, + 0x4,0x54,0x8a,0x80,0xf2,0x43,0x20,0xec,0x25,0xcf,0xf8,0x11,0xbe,0xf6,0x47,0xc4, + 0x75,0xe7,0xf3,0xc6,0xad,0x6b,0xd6,0xa9,0x66,0x97,0xf0,0x6,0xbb,0xa2,0x22,0x60, + 0xaf,0x93,0x94,0xb6,0xf3,0x55,0x50,0xcd,0x8c,0x72,0xc2,0x4f,0xa5,0xf2,0x4c,0x3b, + 0x1e,0x56,0x31,0x25,0x26,0xd7,0xa1,0x95,0xa3,0x45,0xf4,0x11,0xb6,0x5f,0x1c,0x94, + 0x40,0xd1,0xb5,0x7,0xe2,0xb,0x8c,0x3b,0x16,0xda,0x67,0x96,0x32,0x23,0xa1,0x5e, + 0xa9,0xc8,0x38,0x8,0xf4,0x34,0xa4,0x12,0xc5,0x5e,0xdf,0xe9,0x6e,0xfb,0xf4,0x8b, + 0x52,0x64,0x9,0x11,0x58,0x3f,0x31,0x72,0x48,0x2c,0xc9,0xa3,0x5c,0xdd,0x81,0xda, + 0x3,0x2f,0x3e,0x76,0xb8,0x2a,0x1d,0x34,0x71,0xaa,0x86,0x8f,0xbb,0x48,0xc2,0x4f, + 0x11,0x4c,0xc3,0xae,0x1e,0xad,0x63,0xd4,0xe8,0x8d,0x8,0x89,0x81,0xa1,0x95,0xa3, + 0xd9,0xeb,0x46,0xdb,0x2f,0xe,0xfa,0x29,0xa9,0x3f,0xe,0x86,0x66,0x82,0xae,0x58, + 0x68,0x7c,0x27,0x2b,0x4d,0xb3,0x7e,0x9,0x18,0x3a,0xda,0xc5,0xb6,0xe9,0x82,0xbc, + 0x6,0x52,0x4f,0xa6,0x99,0x2,0x6f,0xda,0x9c,0xe7,0xa3,0xa2,0x7d,0x9,0x30,0x63, + 0x1b,0x6f,0xd1,0x87,0xe7,0x82,0xe9,0xd8,0xc9,0x43,0x57,0x33,0xb6,0x3c,0x67,0xde, + 0xdb,0x24,0x5b,0x11,0xc5,0x6a,0x74,0xed,0xe8,0xc,0xaa,0xe4,0x5a,0xc7,0x32,0x71, + 0x46,0x56,0x39,0x9a,0xb7,0x6e,0xb4,0xdd,0xe3,0x20,0x3c,0x6,0x3d,0xbf,0x27,0x7b, + 0x2c,0x64,0xcd,0x7a,0xa0,0xd7,0xa4,0xa3,0xbd,0x94,0xbc,0xd,0xa0,0x91,0x13,0x72, + 0xb,0x88,0x29,0x66,0x4,0x3a,0x2c,0x29,0x85,0xee,0x1d,0x8f,0x2c,0x80,0xd3,0x51, + 0x91,0x9a,0x3b,0xea,0x9a,0x10,0x62,0x9f,0xc2,0xe1,0xb9,0x60,0x3a,0x76,0x72,0xb, + 0x89,0x72,0xf5,0xa4,0xbe,0xa8,0x68,0xeb,0xa0,0x74,0xf5,0xe8,0xfc,0x9e,0x29,0x8c, + 0x5,0x4c,0x50,0xcd,0x5a,0x39,0x2a,0xed,0x9f,0xe0,0xe2,0x61,0x2b,0xe3,0x20,0x15, + 0x11,0xb3,0xaa,0xa1,0x34,0x9,0x55,0x6c,0xbd,0x74,0xb8,0x2a,0x4a,0x96,0x30,0xf6, + 0xb2,0x91,0x30,0x49,0x47,0x35,0x51,0x6c,0x6,0x2b,0xb2,0x51,0xb0,0x54,0x56,0x2e, + 0xc8,0x99,0x11,0xae,0x15,0xdd,0x35,0xf1,0x88,0x10,0xb8,0x82,0xd4,0xc,0x36,0x7f, + 0x46,0xa8,0x9c,0xd1,0x8e,0x92,0x62,0x28,0xf0,0xd3,0x5,0xdc,0x76,0x7f,0x25,0x4d, + 0x46,0xa9,0x7a,0xd2,0x13,0x18,0xf7,0x68,0xa0,0x10,0xe8,0xa5,0xd9,0x84,0x99,0x76, + 0x8d,0x83,0x14,0x34,0x43,0xd5,0x50,0x9f,0x18,0x13,0x1a,0xb,0xfd,0x31,0x31,0xf1, + 0xbd,0x2c,0x31,0x2b,0x66,0x7a,0x79,0x3a,0x9a,0x6e,0xfb,0xb7,0xd,0x6a,0xbe,0x88, + 0x8d,0x2e,0x69,0xd3,0x8c,0x59,0xe,0x63,0xa1,0x30,0x6e,0xe5,0xde,0xf4,0x51,0x2e, + 0xbb,0xde,0xb5,0xba,0x2b,0x9f,0xb,0x4a,0x8a,0xd8,0x94,0x75,0x11,0xd1,0x56,0x51, + 0x14,0x1c,0x6b,0xdb,0x72,0xe5,0x6b,0xda,0xb2,0xfa,0xe7,0xfe,0x3b,0x86,0x63,0xde, + 0x7a,0x18,0x8,0xaa,0x66,0x42,0x2b,0x66,0x42,0xeb,0x65,0x5a,0x59,0x27,0x23,0xfb, + 0x2d,0xb4,0x3a,0x86,0xda,0xe3,0x2f,0x54,0x93,0x98,0xf4,0xe4,0x85,0xd3,0x4,0xa1, + 0x49,0x47,0x93,0xf,0xd3,0x6d,0x54,0x68,0x48,0x16,0x98,0x8e,0x98,0x25,0x42,0x93, + 0xb7,0x22,0x68,0xe7,0x8a,0x3b,0x51,0x6a,0x1d,0x3d,0xb0,0x47,0x21,0x35,0xf4,0xd5, + 0xbd,0x72,0x81,0xa,0x5c,0x85,0x8e,0xef,0xa2,0xe0,0xeb,0x49,0x95,0x63,0x39,0x50, + 0x58,0xf5,0x33,0xb0,0xc0,0x67,0xd7,0x10,0x1d,0xc5,0x89,0xcc,0x45,0x6,0xae,0xc1, + 0x16,0xfe,0xca,0xd1,0xb0,0x7a,0x99,0xd6,0xd6,0xc9,0x48,0x7e,0xcb,0x52,0x1d,0x43, + 0xed,0xe1,0x2e,0x10,0x12,0xe8,0xd9,0x17,0x2e,0xc3,0x27,0x4c,0xd0,0xd1,0x5e,0x5b, + 0x44,0x9f,0xfb,0xa3,0x49,0x74,0x3,0x8e,0x31,0x47,0x9c,0x31,0x91,0x24,0xac,0x76, + 0x4e,0xc7,0x9b,0x11,0x14,0x71,0x55,0x4e,0xea,0xc9,0xf7,0x26,0xa6,0x87,0x5e,0xf0, + 0x19,0xa1,0x8c,0x9a,0xf2,0x4b,0xb5,0xa5,0x45,0x25,0xf7,0x52,0x6e,0xe9,0xe5,0x62, + 0xd2,0x52,0x4e,0xfc,0x9e,0xeb,0x18,0x6b,0xea,0xa1,0x61,0x55,0x3f,0x5a,0x5c,0x33, + 0x53,0x54,0x1f,0xe1,0xc2,0xe4,0x83,0x72,0x69,0x26,0x1b,0x9,0xd,0xcb,0xb,0xc3, + 0xd4,0xd1,0x4,0x1d,0x8d,0x58,0x75,0xf4,0xbb,0x38,0xcc,0xae,0x9f,0xcb,0xd,0x3d, + 0xd2,0xa9,0x55,0xc5,0xdd,0xc4,0x34,0x22,0xd,0xe9,0x34,0x9d,0x8d,0x98,0xa6,0x4c, + 0xca,0x92,0xe0,0xa,0xb8,0xb9,0x25,0xaf,0xe0,0x80,0x13,0x15,0xf5,0x94,0x45,0xa5, + 0x93,0x47,0xd9,0x64,0x34,0x59,0xd4,0x9d,0x24,0xa3,0xe9,0xd8,0x67,0x5e,0xf0,0xea, + 0x18,0x33,0xa,0xb4,0xb3,0xc6,0x40,0x49,0xe5,0xa8,0x9c,0x90,0x42,0x74,0xf5,0x5f, + 0xb8,0x38,0x28,0xa7,0xa4,0x32,0x12,0xca,0xc5,0xc2,0xec,0x74,0x54,0x5b,0xc2,0x8c, + 0x45,0x47,0x93,0x9,0xe4,0x2c,0xfe,0x1d,0xbb,0x99,0xf5,0xdb,0x4d,0x9a,0xea,0x6b, + 0xfc,0x89,0x88,0xc2,0x64,0xcd,0x42,0x9a,0xca,0x9d,0xe2,0x85,0xb1,0x23,0xb8,0x9b, + 0x9b,0xe8,0x78,0xa9,0x84,0x50,0xa3,0x7a,0x2d,0x34,0x91,0x37,0x82,0x5c,0x3e,0x5b, + 0x11,0x23,0x87,0xe0,0xcd,0x5,0x69,0x21,0x6a,0xe,0x82,0xb2,0xdc,0x4f,0x39,0xa1, + 0x1a,0xd6,0x3f,0x11,0x96,0xf,0xaa,0x36,0xcb,0x7,0x55,0x4e,0xf0,0xd1,0x70,0xcc, + 0xd2,0x29,0xc1,0x7d,0x3e,0x8a,0xce,0x9,0x4d,0x75,0x34,0x7d,0x70,0x84,0xbb,0xf1, + 0xb0,0xe3,0xba,0xf,0x62,0x74,0x21,0xd7,0x31,0x11,0x1,0xce,0x8e,0xb,0xee,0x2f, + 0x29,0x81,0x46,0x33,0xbd,0x83,0x10,0xaf,0x5a,0x6e,0x43,0x8d,0x33,0xf7,0x35,0x1b, + 0x19,0xed,0x38,0x1c,0x39,0x7,0x12,0xcf,0xf7,0x18,0x6a,0x76,0x5d,0xfa,0xf9,0x23, + 0x6b,0xa8,0x36,0x20,0x28,0x81,0x19,0xf,0x51,0x64,0xca,0x6,0xb3,0x8c,0x37,0x2c, + 0x33,0xe,0xa2,0x80,0x38,0x98,0x3f,0x27,0xc,0x89,0x85,0x4a,0x22,0xcd,0xf4,0x32, + 0xea,0xa8,0x22,0xfe,0xe4,0x11,0xdc,0x4b,0x46,0x3c,0x7b,0xb4,0xb8,0x66,0xda,0x78, + 0x29,0xa1,0xc6,0x8e,0x46,0x69,0x9a,0xea,0x5a,0x6,0x24,0x6e,0x9,0xe2,0x0,0x4c, + 0xb7,0x3d,0xb9,0x9a,0x83,0x95,0x27,0x52,0x26,0x69,0xac,0x22,0x49,0xa9,0x4a,0xb5, + 0x3d,0xe9,0x94,0x35,0xf,0x7,0xfc,0xe2,0xfd,0xb3,0x38,0xda,0x78,0xac,0xbc,0xfd, + 0x1f,0x92,0x99,0xa3,0x92,0x3e,0x42,0x38,0xaf,0xeb,0x65,0xc7,0x41,0x15,0x14,0x7, + 0x21,0x4,0x1f,0x84,0x70,0x54,0xe0,0x84,0xcb,0x30,0x55,0xd4,0xa2,0xa3,0x4b,0x4c, + 0xb3,0xbe,0x3b,0x6d,0xa6,0xa7,0xff,0x7c,0x17,0xa6,0xf0,0x4c,0x74,0xb3,0x69,0xa8, + 0x5d,0x13,0xe3,0x5a,0x7d,0x90,0xa2,0x8e,0xe9,0xa4,0xd9,0xed,0xe,0x52,0x45,0x6c, + 0xfc,0x7a,0x74,0xd4,0x52,0x21,0x4a,0x24,0x66,0xa4,0x3b,0x45,0x38,0xf7,0x10,0x64, + 0xa5,0x90,0x7d,0x8f,0xb6,0x7c,0x41,0xca,0x3b,0x9d,0x83,0xa0,0xcf,0x17,0xcc,0x2a, + 0xcd,0x64,0x13,0x66,0xe4,0x63,0xe,0xcb,0x98,0xab,0x96,0xa5,0x50,0x2d,0x44,0x90, + 0xf1,0x49,0x34,0x20,0x5d,0x4b,0x59,0x7d,0xc,0x5b,0x2f,0x3,0xdd,0x63,0x44,0x42, + 0x6d,0x14,0x24,0x56,0x98,0x6b,0xde,0x21,0xfc,0x7,0x8e,0x13,0x2,0xb,0x15,0x15, + 0xd3,0x62,0xbc,0x66,0x6,0xaf,0xd2,0x51,0x11,0x8c,0x3b,0xa8,0x5,0xb2,0x8c,0x6b, + 0x61,0x6a,0x1d,0x90,0xb,0x42,0x44,0x4a,0xe1,0x28,0x2d,0x48,0xbf,0xae,0x88,0x1d, + 0x78,0x91,0xa6,0xac,0x33,0x4d,0x8,0xca,0x49,0x68,0x88,0x34,0xe3,0x13,0x66,0x70, + 0x92,0xc4,0xc1,0xa2,0x8c,0x9,0x49,0x2c,0x84,0xf7,0x93,0xa1,0x8c,0xa,0x35,0x63, + 0x62,0x6e,0x1a,0xe4,0x97,0x92,0xfc,0xff,0x71,0xfc,0x80,0xd4,0x4a,0x61,0x69,0x97, + 0xb6,0x2f,0x48,0x77,0xe3,0x4b,0x0,0x9,0x46,0x4d,0xd5,0x2,0xb8,0xd2,0x63,0x37, + 0x7c,0xb9,0xa0,0x2,0xd8,0xd5,0xee,0x34,0xeb,0x17,0x6a,0x56,0x1b,0xd,0x23,0xa3, + 0x33,0x18,0x27,0x80,0x22,0x95,0x65,0x7c,0x46,0x7e,0x98,0x4d,0x2f,0x1f,0x67,0xb1, + 0x70,0xf9,0x60,0x11,0x6,0xbd,0x54,0x1f,0x2d,0x86,0x8e,0x1a,0x8f,0x3b,0x6d,0x82, + 0x70,0x86,0x53,0x47,0x93,0xff,0x9f,0xc5,0xdd,0xd8,0x41,0x8a,0x33,0x0,0x3d,0x73, + 0xc6,0x97,0xb,0xba,0x65,0x17,0xde,0x84,0x48,0x6b,0x97,0xb4,0x40,0xc3,0x3,0xd6, + 0xce,0x5,0xb5,0x37,0x46,0xd2,0x31,0x8f,0x1b,0x6a,0xa1,0x5,0x73,0xba,0xd3,0xb9, + 0xa0,0xc2,0xb4,0x35,0xb6,0x29,0x4c,0x96,0xa1,0xfe,0x26,0x9f,0x4d,0xdf,0xee,0x71, + 0x50,0xe5,0x0,0x9f,0xd4,0x98,0xe0,0x34,0xd2,0x10,0xe8,0x91,0xa0,0x36,0x41,0xa8, + 0x67,0x28,0x8f,0x90,0x4e,0x2a,0x1f,0xc3,0x3,0xa8,0x13,0xb3,0x63,0xc0,0x5a,0x16, + 0x54,0xc4,0xe3,0xb,0xdf,0x92,0xb2,0x8b,0x16,0x4c,0x14,0xd5,0xec,0x12,0x35,0x60, + 0xb,0xba,0x39,0xf1,0x85,0x83,0x90,0x22,0x5f,0x29,0x7d,0x79,0xf0,0x41,0x8f,0x5a, + 0x16,0x66,0x7e,0x7e,0xe8,0x71,0x23,0x7f,0xf1,0x83,0x4e,0x5,0x1d,0x85,0xc0,0x38, + 0x98,0x65,0xf9,0x17,0x14,0xc,0xc0,0xe2,0xe3,0xa0,0xa,0x4,0x9e,0x2c,0x16,0xfa, + 0xeb,0x64,0x48,0x28,0x72,0x74,0x54,0x79,0xaf,0x7c,0x7b,0xf1,0x63,0x4c,0x90,0x30, + 0x84,0x45,0x53,0x69,0xc7,0x2f,0x39,0xee,0x50,0x3b,0x32,0xc5,0x18,0x8a,0x11,0xe0, + 0xf4,0x5,0xb9,0x2,0x70,0xc5,0x2c,0x10,0xe2,0xcb,0x5,0xdd,0x6b,0x1c,0x70,0x7e, + 0x61,0x5a,0x33,0x95,0x55,0x92,0xce,0xdd,0x9a,0xc2,0x71,0x16,0x7c,0x3e,0xda,0xa9, + 0xa,0xaa,0x1c,0x95,0xfb,0x84,0x65,0xc5,0x41,0xb5,0x0,0x71,0x30,0x6b,0x2c,0x94, + 0x1b,0x13,0x8a,0xcc,0xc6,0x13,0x91,0xb0,0x32,0x63,0x7f,0x5d,0x2e,0x9c,0x8f,0xe3, + 0xc7,0x38,0xe2,0x99,0xa5,0xa6,0x19,0x33,0x5e,0x33,0x36,0x86,0x66,0xb3,0x40,0xf3, + 0x56,0xc4,0xdc,0x7,0x51,0x29,0x79,0xd2,0xf4,0x77,0x39,0x82,0x31,0x99,0x8d,0x8, + 0xfb,0x82,0x9b,0x4,0xa7,0xd8,0xa1,0x87,0xfc,0xb2,0x2e,0xf3,0xbf,0x4f,0x62,0x82, + 0x25,0x8f,0x59,0x6d,0x8a,0x3c,0xc2,0x4c,0xbb,0xc5,0xc1,0x7c,0xd2,0x4c,0xd6,0x9c, + 0x50,0x79,0x3e,0xdd,0x70,0x3a,0xaa,0xb9,0x48,0x28,0xa7,0xa3,0x71,0x76,0xf8,0x33, + 0x3c,0x6e,0x8d,0x43,0xa4,0x73,0x37,0x77,0x2e,0xa8,0x49,0xa5,0x55,0xe2,0xe,0xba, + 0xc1,0x48,0x97,0x76,0xc3,0x92,0xe0,0x7d,0xb9,0xa0,0x62,0xfd,0x42,0x45,0x2a,0xa0, + 0x54,0x7e,0x48,0x67,0x93,0xe6,0x28,0x8b,0x29,0x4c,0x7a,0x8,0xa4,0x54,0x94,0x71, + 0xff,0x65,0x5e,0x42,0xba,0x70,0x71,0xb0,0x35,0x6,0x3d,0x4f,0x40,0x95,0x28,0x26, + 0x86,0x65,0x86,0x9a,0x13,0x66,0xe4,0xf,0xb3,0xb,0xf7,0x63,0x26,0x15,0x7,0x23, + 0x46,0x6,0xe1,0xab,0x68,0xb8,0xa9,0xa6,0xfc,0xc8,0x5b,0x6a,0xb1,0x19,0xed,0xc9, + 0xfe,0x6c,0x9b,0x41,0x7,0xe7,0x82,0xc9,0x22,0x36,0xc5,0x36,0x39,0xf9,0xda,0x9a, + 0xec,0x82,0xb5,0x13,0xd,0x8,0xba,0xa4,0x94,0xb0,0x78,0x58,0x9c,0x30,0x53,0x5c, + 0x1c,0x54,0x28,0xb3,0x50,0x2d,0xdc,0xa0,0x97,0x51,0x53,0x5f,0xbe,0x2d,0x33,0x24, + 0x68,0x71,0xa6,0xc2,0x5b,0x14,0x72,0x3d,0xac,0x8a,0xbb,0x71,0xc4,0xbb,0x1c,0xa3, + 0x66,0x87,0xe1,0xbb,0xcc,0xa,0xed,0xb4,0x2e,0xa8,0xbc,0x90,0x9e,0x6,0xa3,0x89, + 0xfa,0x1a,0x57,0xd4,0x55,0x4c,0x7b,0x55,0x1a,0xc8,0x54,0x55,0xa9,0x9d,0x1f,0xa6, + 0xb3,0xe5,0x74,0xc9,0x9a,0x6,0x30,0x81,0x69,0x47,0x8e,0x27,0xd1,0x3f,0x8b,0xa8, + 0x1c,0x45,0xe9,0x71,0x10,0x5e,0x18,0xe6,0x89,0x83,0xe5,0x1b,0x13,0xf6,0x3f,0x29, + 0x1d,0x65,0x9b,0x99,0x38,0x75,0x34,0xec,0xfa,0x37,0x83,0x7,0xf0,0xb8,0xa1,0x96, + 0xfa,0xd6,0xaa,0xc8,0x6a,0x56,0x44,0x90,0xc,0xce,0x97,0x15,0xb1,0x41,0xec,0x8, + 0xd2,0xd3,0x6f,0xa8,0xd5,0xe8,0x29,0x6d,0x54,0x5b,0x19,0x23,0x35,0x71,0x7b,0x2, + 0x33,0xe,0x78,0x70,0x90,0x83,0x10,0x9c,0xf0,0x66,0x83,0xf2,0x5,0xb2,0xf3,0xc7, + 0x41,0x94,0x1e,0x7,0xcb,0x34,0x26,0x5c,0xb1,0x50,0xfe,0xff,0x8a,0x79,0x86,0x48, + 0xd4,0x51,0xd9,0xff,0xf7,0xe1,0xe7,0x98,0xf2,0xe4,0x82,0x54,0xb4,0xd4,0x1,0x35, + 0x33,0x69,0x77,0xd0,0xbf,0x8a,0x45,0x12,0x56,0x8a,0x20,0x98,0x48,0xc5,0x46,0x1e, + 0x76,0x9a,0x5c,0xc1,0x9c,0x6a,0x72,0x52,0x16,0xf5,0x4c,0x66,0x8c,0xe9,0xf6,0xa5, + 0x9,0x23,0x13,0x8,0x8d,0x86,0x59,0xa5,0x19,0xd5,0xf2,0x38,0xa8,0x16,0x3c,0xe, + 0xe6,0x37,0x26,0x68,0x68,0xe6,0xc9,0x8,0xd3,0x66,0xfd,0x51,0x29,0xba,0xe9,0xaf, + 0xe1,0x18,0xee,0xc5,0x41,0x47,0x2e,0xe8,0x1e,0x84,0xe1,0x3,0x24,0x57,0x35,0x6a, + 0x67,0x89,0xdc,0x71,0x8a,0x2c,0xe0,0x96,0x64,0x81,0x9c,0x71,0xa1,0x1d,0x8d,0x4a, + 0x69,0xea,0xc9,0x93,0xd1,0x13,0x8d,0x86,0x5d,0x2a,0x4f,0xcb,0x23,0xcb,0xc8,0xa5, + 0x19,0xb4,0x24,0xe,0xa2,0x2d,0xe3,0x60,0x38,0x9,0x2d,0x22,0x23,0x4c,0x9c,0x35, + 0x47,0x4d,0x8b,0xe2,0x88,0x3f,0xc8,0xba,0xbf,0x86,0x8,0xdb,0xf1,0x68,0x43,0xa6, + 0x71,0x91,0x52,0x9f,0x36,0xa,0xef,0xbc,0x1a,0x2a,0x2f,0x4,0x73,0x1,0xb0,0x97, + 0x4c,0xd3,0xce,0xd8,0xe8,0x2f,0x62,0x33,0x2d,0xb,0x25,0x2a,0x1,0x48,0x93,0xd1, + 0xf8,0xde,0xe3,0xcd,0x86,0x5d,0x9e,0x8a,0x66,0xaf,0x1e,0x95,0x55,0x8e,0x4a,0x84, + 0x19,0xb4,0x59,0x1c,0x2c,0xc7,0x98,0x90,0x93,0xd0,0xd0,0x58,0xc8,0x16,0xad,0x41, + 0x37,0x70,0x37,0x37,0x6,0x7f,0x44,0x59,0xe6,0x76,0x78,0x37,0xd9,0x8,0xc6,0xb1, + 0x5,0x6b,0x13,0x50,0x53,0xe4,0x2c,0x69,0x95,0xa2,0x9e,0x69,0xe7,0x8c,0xfb,0x3b, + 0x6a,0xb6,0x36,0x65,0xd7,0x53,0xf3,0x26,0x75,0xea,0xcb,0xb2,0x27,0xb1,0x25,0x61, + 0xa7,0x88,0x88,0x6a,0x3e,0x86,0xf9,0xfe,0xa8,0xe5,0xb3,0xe9,0xc8,0x3c,0xbf,0x45, + 0x98,0x48,0xcc,0x10,0x55,0xcc,0x45,0xd0,0x95,0x85,0x80,0x81,0x3e,0xff,0x17,0xe5, + 0xf4,0x4f,0xf8,0xfa,0x26,0x20,0x58,0x78,0x13,0x90,0xf,0xb2,0x90,0xf7,0x4e,0xf8, + 0xe7,0x6a,0xbb,0xee,0x49,0xdf,0xeb,0x5f,0xa3,0xc2,0xf5,0x7f,0x10,0xf3,0xd6,0x2a, + 0x23,0x46,0x24,0xec,0x19,0x81,0xf0,0x6a,0xe8,0x64,0xb8,0x98,0xc5,0x63,0xd8,0x8e, + 0x59,0x4f,0x2e,0xe8,0xef,0x9f,0xf0,0x57,0xd1,0x70,0xee,0xa2,0x76,0x92,0x59,0xae, + 0xea,0x94,0x13,0x5f,0xb4,0x87,0xac,0x2a,0x82,0x86,0x52,0x35,0x33,0x48,0xc5,0xec, + 0x39,0x8,0x42,0x48,0x45,0x8b,0x6b,0xea,0x55,0x25,0xf4,0x11,0x16,0x1f,0x7,0x51, + 0x6a,0x1c,0x2c,0x4a,0x90,0xe1,0xe9,0xa8,0x24,0x2a,0x36,0x2e,0xc5,0x26,0x8,0xa3, + 0x23,0xe9,0x13,0x37,0x2c,0x2b,0x34,0xff,0x8d,0x62,0x5b,0x63,0xcd,0x20,0x6e,0xc6, + 0x9a,0xaf,0x7f,0x82,0x36,0xe,0xc0,0x66,0x81,0x9c,0x52,0x99,0x6,0x9e,0x66,0x6, + 0x37,0x2a,0x67,0xb1,0xb6,0xb2,0xa6,0x0,0x50,0x5d,0x14,0xc9,0xa3,0xe9,0x85,0x42, + 0xe7,0xa5,0x9a,0x18,0x82,0x32,0x2a,0x9a,0x6f,0x93,0x51,0x52,0x78,0xe5,0x98,0x2c, + 0xf9,0xa0,0xca,0x94,0xf,0x4a,0xa,0xd5,0x80,0x56,0x56,0xc7,0x84,0x99,0xf5,0xf2, + 0x2,0xee,0x79,0xdc,0x55,0x0,0x60,0x87,0x51,0xbc,0x1f,0xfe,0xe0,0xb0,0xe2,0xe1, + 0xe3,0xd8,0x8e,0x69,0xa6,0xcc,0x59,0x8b,0xf2,0x41,0x6a,0xfe,0x28,0xb7,0xc7,0x37, + 0x9f,0x54,0xb3,0x15,0x9b,0x20,0xd6,0xec,0xe5,0xaa,0x46,0xe9,0x5e,0x8b,0x34,0x20, + 0xdd,0x35,0x33,0xa,0x40,0xad,0x1,0x41,0xe,0x6,0x61,0xd5,0xa3,0x72,0x69,0xc6, + 0x2f,0xcc,0xa0,0xf0,0x38,0x88,0xd2,0xe2,0x60,0x98,0x41,0x9f,0xd7,0x11,0x84,0x30, + 0x26,0x42,0x70,0x9,0x33,0xb7,0xee,0x91,0xa4,0x6d,0x31,0x2,0x23,0x1f,0xb,0xc3, + 0x36,0xf5,0xb2,0xc7,0xf0,0x10,0xe,0x11,0xb1,0x2f,0x9d,0xb,0xba,0x1,0x19,0x79, + 0xe2,0x26,0x55,0xc4,0xc6,0x1b,0x13,0x9c,0x85,0x4f,0x29,0x9f,0xee,0xc2,0x35,0xca, + 0x11,0xa4,0x1,0x99,0x5e,0xbd,0xb1,0x86,0xc9,0x26,0x65,0xf5,0xc9,0x24,0x79,0x6d, + 0x8a,0x2c,0x83,0x2d,0x90,0xe1,0xbb,0x5f,0xb8,0x38,0x98,0xd7,0xa0,0xf,0x77,0x4, + 0x55,0x26,0xa3,0x82,0x21,0xa4,0xfa,0x9c,0x51,0x6,0x84,0x2a,0x93,0x28,0x63,0xbf, + 0xe0,0x3a,0xf6,0xe0,0x31,0x4c,0x39,0xa9,0x27,0x4d,0x2d,0x35,0xb1,0x9e,0x3b,0x35, + 0xbc,0xc9,0x2e,0x62,0x53,0x64,0x9f,0x3,0xd,0x76,0x3a,0x63,0xf4,0x59,0x16,0x34, + 0x4d,0xe5,0x1,0xa9,0x12,0xe5,0x6b,0xb3,0x98,0x64,0xbe,0x10,0x25,0x8a,0x86,0x40, + 0x79,0x95,0xa3,0x59,0x7c,0xc2,0xd6,0xc4,0xc1,0x56,0x1b,0x13,0xa1,0xf1,0xd0,0x4f, + 0xdb,0x19,0xb4,0x1c,0xbd,0xb3,0x96,0x4,0xe1,0x11,0x4e,0x81,0xf3,0x67,0x87,0xfc, + 0x4b,0x3c,0x81,0x47,0xb1,0x1b,0xb3,0x4c,0xa4,0xf3,0x49,0x20,0xae,0xf5,0x6a,0xdd, + 0x63,0xa2,0xa8,0x3a,0x19,0x45,0x3e,0x16,0x6d,0xc4,0xd3,0xf5,0xa2,0xa,0xd4,0x52, + 0x34,0x1a,0x20,0xd7,0x1f,0xb6,0xdd,0xc1,0x19,0x4c,0x33,0xa7,0xb8,0x5c,0x98,0x29, + 0xc2,0x9e,0x28,0xae,0x8f,0xb0,0x35,0x71,0xb0,0xd5,0x6d,0xbb,0x32,0x41,0x86,0x8b, + 0x85,0x52,0x51,0xc6,0xc4,0x5c,0x77,0x3a,0x12,0x22,0xe0,0xe1,0x94,0x37,0x58,0x6b, + 0x8c,0x62,0x1c,0x67,0x35,0x8d,0xb,0x6e,0xd2,0x76,0x72,0x4e,0xb7,0x6b,0x70,0x94, + 0x4e,0xad,0x5e,0xc8,0xd,0x86,0x82,0xd3,0x92,0x48,0x4b,0x3e,0xa6,0x35,0xc1,0x59, + 0x16,0xfc,0x90,0x28,0x7b,0xf5,0x1d,0xbb,0xf1,0x69,0x96,0x98,0xa4,0xad,0x1c,0xc6, + 0x83,0x12,0x9c,0x8,0x7e,0x73,0x22,0x6c,0xf2,0xb6,0x64,0xee,0xb6,0x74,0xce,0xb6, + 0x6b,0x51,0x97,0x2c,0xb,0x9d,0xb9,0xac,0x88,0xa2,0x8d,0x9,0xce,0x9c,0xe0,0xfe, + 0x42,0x89,0xd7,0x32,0x4e,0x6c,0x4d,0xcc,0x55,0x92,0xb6,0x61,0xc6,0xc0,0xea,0xdc, + 0x6a,0xd8,0x8b,0xc7,0x1b,0xeb,0x29,0x68,0x46,0x46,0xd1,0xc4,0x7c,0xd2,0xc8,0xa3, + 0xa5,0x72,0x91,0x4e,0x23,0xbd,0xa4,0xa,0x6f,0x49,0xd0,0xb5,0x34,0x7c,0xbd,0x28, + 0x4f,0x50,0xed,0x26,0x27,0x33,0x56,0x4e,0x1b,0xb5,0x31,0x6e,0x59,0x24,0x7b,0xf5, + 0xa8,0x4c,0x9a,0xf1,0x9,0x33,0xed,0x11,0x7,0x55,0xc1,0x71,0x30,0x5c,0x90,0xc9, + 0x92,0x83,0xfb,0xf3,0x69,0xe5,0x2,0x21,0xe,0x84,0x3f,0xa0,0x2b,0x59,0x4d,0xbf, + 0x95,0x49,0xc,0x62,0x57,0xb3,0xf1,0x89,0x8a,0x89,0xdc,0xe2,0x30,0x94,0x7b,0x48, + 0xad,0x40,0x4b,0x57,0xd0,0x80,0x58,0x9e,0x45,0x39,0x7a,0x10,0x25,0xd9,0x21,0x4d, + 0x50,0xf9,0x29,0x73,0x1a,0x93,0xa8,0x3b,0x4e,0x74,0x7f,0x66,0x58,0x64,0x53,0x6f, + 0x51,0x7d,0x84,0x65,0xe6,0x83,0x59,0xa4,0x99,0xd6,0xb,0x32,0x32,0x71,0xc6,0x51, + 0xb4,0x76,0x20,0x45,0x47,0xd5,0x70,0x92,0x24,0x66,0xf3,0x3d,0xdc,0x6f,0xe0,0x18, + 0x8e,0x63,0xd,0x4e,0x6f,0x2e,0x3c,0xaa,0x89,0x97,0x49,0xad,0xec,0xc7,0x2f,0xd2, + 0x99,0xae,0xa2,0x89,0x2c,0x2a,0x4a,0xad,0x3f,0x1f,0xc1,0xac,0xac,0xa1,0x28,0x6b, + 0x92,0x6c,0xd9,0x34,0x95,0x22,0xae,0xe9,0x57,0x37,0xbf,0xd5,0x31,0x93,0x8a,0xbd, + 0x7e,0x32,0xaa,0xc4,0x14,0x94,0xdb,0x7c,0x33,0x47,0xc3,0x8,0x69,0x68,0x9d,0xc, + 0x3c,0x6b,0xc,0x66,0x9d,0x27,0x5a,0x2e,0x9,0x95,0x92,0x4f,0x8e,0xbc,0x4a,0x88, + 0x69,0x62,0x8d,0xca,0x21,0xb,0x84,0x9a,0x8d,0x82,0x7e,0x51,0x46,0x1a,0xc2,0x35, + 0xc6,0x30,0x8e,0x75,0x58,0x8b,0x4a,0x2a,0x17,0xb4,0x4f,0x1d,0x45,0x2c,0x2a,0x9a, + 0x5c,0x1f,0x87,0x5b,0x84,0x9b,0xca,0xf7,0x28,0x9b,0xc2,0x56,0x55,0x5d,0x20,0xd3, + 0xd6,0xa9,0x4c,0x17,0x11,0x24,0x1,0x39,0x97,0x9,0x2a,0x31,0x0,0x55,0xe,0xe0, + 0x71,0x7f,0x95,0x67,0x81,0xec,0x74,0x5e,0xe8,0x5a,0x85,0x89,0x5f,0xb1,0x28,0x6f, + 0x3e,0x98,0x75,0xd5,0x79,0x39,0x24,0xa5,0x60,0x73,0x41,0xd5,0x75,0xd9,0x22,0xc7, + 0x7d,0xa5,0x41,0x58,0x1b,0xea,0x22,0xc9,0xa8,0x3f,0xc8,0x86,0x6,0xee,0x8,0x87, + 0x31,0x8a,0xb5,0xe8,0x6b,0x30,0x61,0xcd,0x7e,0x88,0x9a,0x1,0xa4,0x62,0xec,0x89, + 0x34,0xe0,0x4c,0xa1,0x87,0x8e,0x8a,0x69,0xb5,0xd4,0x5,0x32,0x6a,0x8f,0x62,0x97, + 0x50,0x9b,0xbb,0x6f,0x6,0x75,0xe7,0x27,0x97,0x55,0x98,0x51,0xe2,0x8,0x48,0x45, + 0xc1,0x90,0x5,0xb2,0xed,0x2b,0x39,0x16,0x38,0xe,0xd2,0xb7,0x42,0x17,0x3a,0xcb, + 0x26,0xc8,0x28,0xe7,0x6a,0xc8,0x7e,0x51,0x26,0xf5,0x7a,0x86,0x53,0x39,0xe1,0xae, + 0x3,0xcd,0x96,0x40,0x8b,0xa4,0x79,0xa5,0xd6,0xe0,0x6b,0x74,0x84,0x23,0x18,0xc2, + 0x48,0x62,0xf8,0x2e,0xd5,0x74,0xcb,0x45,0x48,0x10,0xb9,0x18,0x2d,0xe2,0x28,0x2b, + 0x6a,0xd2,0x3,0x79,0xed,0x4c,0x8e,0x96,0x60,0xec,0x22,0x36,0x2e,0x2f,0xac,0x63, + 0xca,0x28,0xd1,0x76,0xe5,0x5d,0xe1,0xc2,0x8c,0xcc,0x9c,0xc8,0x3f,0xe0,0x9,0xa4, + 0xcc,0x12,0x92,0xf,0xa2,0x80,0x7c,0xb0,0x88,0xb9,0xda,0x45,0x56,0xc7,0xc8,0xc4, + 0x19,0x3f,0x6e,0x66,0x86,0xd2,0xc2,0x8c,0xc6,0x2e,0xbf,0xf9,0x18,0x26,0xca,0xb8, + 0xdf,0x5a,0x1d,0x23,0x18,0xc6,0xa8,0x91,0xa1,0xd9,0x7a,0x25,0x4,0x6d,0x4e,0xe6, + 0xea,0x85,0x14,0x60,0xed,0x45,0xb6,0x6d,0x5,0x35,0xad,0x69,0x2a,0xcb,0x69,0xb4, + 0xab,0x66,0xa8,0xfa,0x9a,0x18,0x90,0x35,0xa3,0x4f,0x9a,0x2a,0x61,0xe2,0xb,0xc6, + 0x8a,0x6d,0xeb,0xcd,0x27,0xcc,0x28,0xd1,0xb8,0x5b,0xb7,0x54,0x93,0x57,0x17,0xcd, + 0xae,0x8d,0x16,0x51,0x9e,0x1d,0x76,0x8e,0xfb,0x13,0x39,0xe3,0xec,0x9c,0xde,0x73, + 0x20,0xd,0x42,0x83,0xa1,0x86,0x64,0x87,0x21,0x57,0x8,0xfb,0x5f,0x1d,0xa3,0x18, + 0xc6,0x11,0xcc,0x38,0x8a,0xd7,0xec,0x71,0x87,0x20,0x97,0xed,0x54,0xde,0x2,0x37, + 0xc5,0x2a,0xa3,0x7e,0xb3,0x22,0xbd,0xac,0x27,0x9c,0xbd,0xf6,0xd3,0x98,0x15,0xd9, + 0x3c,0x21,0x96,0x7d,0xbe,0xa6,0xde,0x2c,0x3,0x9e,0xc2,0xe3,0xa0,0x12,0xc6,0x41, + 0x14,0x1e,0x7,0xb3,0x1a,0x13,0x8,0xa,0x1c,0x79,0x2d,0x8a,0xc4,0xb6,0x2b,0xb6, + 0xbb,0xbb,0x6d,0x86,0x2a,0xb,0xaf,0x45,0x6d,0x11,0x8e,0x62,0x1c,0x2b,0x71,0x1a, + 0x7a,0x1b,0xa,0x27,0x48,0x3,0x22,0x6d,0xaa,0xd3,0x9d,0x15,0x3a,0x41,0x14,0xe9, + 0x3a,0x19,0x45,0xc4,0xb7,0xf4,0x22,0xdb,0x74,0x1e,0x65,0x1b,0xd5,0x76,0x96,0x53, + 0x47,0x2d,0x40,0xb6,0x2e,0x4b,0x98,0xa1,0x4d,0xfa,0x7c,0x7d,0x84,0xfe,0x7c,0xd0, + 0x2d,0xbd,0xc8,0x57,0x5c,0x92,0xa8,0xa1,0xe1,0x39,0x21,0x97,0xf1,0x85,0x7c,0xa6, + 0xfe,0x7c,0x91,0xcf,0x4,0x53,0x97,0x8c,0xa1,0xf8,0xf7,0x18,0x84,0x43,0xa6,0x24, + 0x52,0xf1,0x46,0x41,0x95,0xf3,0x5f,0x12,0x6a,0xc7,0x71,0x1c,0x4b,0xb1,0x1a,0x2b, + 0x52,0xa7,0x8f,0x62,0xcc,0xa,0x9d,0x30,0x53,0x28,0xf8,0xd8,0x65,0x6f,0x9a,0x84, + 0x65,0x6c,0x6c,0x28,0x87,0xe0,0xa2,0xc8,0x3e,0x45,0x5b,0x4d,0x9d,0x25,0xf3,0x40, + 0x9e,0x45,0x84,0xb4,0xf5,0x66,0x5d,0xb3,0x3e,0x9b,0x30,0x13,0xae,0x8b,0xc2,0xdb, + 0xaa,0xeb,0x16,0x64,0x42,0xd4,0xd0,0x62,0xab,0x63,0x24,0x0,0x93,0xc0,0x95,0xff, + 0xfc,0xec,0xd2,0x46,0x4d,0x81,0x30,0x1a,0x56,0x1,0x49,0x66,0xfe,0xcd,0x6,0xe6, + 0x34,0x8e,0xa0,0x8a,0x15,0x58,0xd5,0x78,0x51,0xe6,0x17,0xcf,0x99,0x15,0xf4,0x35, + 0x90,0x8f,0xa0,0xb4,0x25,0x41,0xa9,0xa5,0x69,0x8f,0x30,0x7d,0x71,0xb0,0xe3,0x65, + 0xd,0xf5,0xe6,0xf3,0xc9,0xac,0x5b,0x89,0x4b,0xa8,0x82,0xa1,0xa8,0x99,0x48,0xa8, + 0x8,0x28,0x6a,0xe1,0xe9,0xb3,0x98,0xe2,0x60,0x36,0x47,0xb0,0xc8,0x8d,0x8b,0x86, + 0x89,0x67,0x19,0x26,0x23,0x21,0x82,0x9c,0xc2,0xfc,0xf1,0x8f,0x96,0x6b,0x8e,0xe1, + 0x38,0x96,0x61,0x5,0x96,0x91,0x53,0x4c,0x15,0x13,0x21,0xa9,0x45,0x48,0x55,0xe2, + 0x37,0x4d,0x12,0x53,0xe,0x54,0xbc,0x3b,0x68,0x5e,0x94,0xcc,0x81,0x1a,0x35,0xa3, + 0x45,0x29,0x5b,0x2c,0xc,0x21,0xa9,0x60,0x80,0x45,0x79,0x84,0x8a,0x0,0xa7,0x8b, + 0x90,0xfa,0x6d,0xfa,0x85,0x8e,0x83,0x79,0x49,0x68,0x3e,0xd2,0xe9,0x8e,0x95,0xf6, + 0xa7,0x47,0x13,0x52,0x45,0x81,0xb0,0xb6,0xa3,0x9b,0x38,0x81,0x55,0xc1,0x16,0x85, + 0x4,0xa0,0x1a,0x93,0x98,0x44,0x37,0x96,0x63,0x39,0x7a,0x88,0xab,0xba,0xab,0x66, + 0x26,0x59,0x40,0x6d,0x97,0x76,0xdb,0xb0,0x54,0xa9,0x93,0x90,0xce,0xb,0xe3,0xf, + 0xd8,0xae,0xdb,0x89,0x10,0x35,0x34,0x5e,0xb0,0x72,0xbd,0xbc,0x34,0x4b,0xea,0x23, + 0xfa,0xa3,0xa3,0xfd,0x1e,0x7c,0x24,0x94,0xa2,0xa1,0x68,0x49,0x1c,0x74,0xfd,0xe6, + 0x2,0x5f,0x56,0x47,0x30,0xf,0xe9,0x94,0xc4,0x40,0x97,0x6f,0xd8,0xd8,0x76,0x90, + 0xdf,0xdf,0xc0,0x1e,0x9c,0x3d,0xbf,0xb3,0xa7,0x39,0x63,0x58,0x19,0xbf,0x99,0xff, + 0x6f,0xcd,0xbf,0x6e,0x2c,0xc7,0xb2,0xe6,0x95,0xc2,0xce,0xe9,0x94,0x95,0x5,0x2a, + 0x8b,0x54,0xda,0x7f,0x21,0xc9,0xc7,0x14,0x21,0xc1,0xa4,0x63,0xb0,0x42,0xd4,0x18, + 0x7c,0x8c,0xe0,0x18,0xe8,0xfa,0x2d,0x4f,0x77,0x5,0x9c,0x8b,0xb3,0xb9,0x96,0x2d, + 0xe7,0x8f,0xa2,0xff,0xaf,0x9d,0xfb,0xb4,0x68,0x2f,0xf7,0x5b,0xd8,0x2d,0x6e,0x92, + 0x91,0xf4,0xde,0x62,0xff,0xf1,0x2b,0x4c,0xcf,0xc6,0x9f,0x71,0x7d,0x66,0xd5,0xde, + 0x49,0xcb,0xa2,0x0,0xb0,0x8d,0xcb,0x2a,0x7c,0xe5,0x6a,0x45,0x9,0x34,0x34,0x3d, + 0x3d,0x8c,0x11,0x4c,0xa0,0x4e,0xac,0x38,0xa8,0x52,0x66,0x41,0xda,0xbe,0x50,0xa4, + 0x8d,0x4f,0x97,0x71,0x6b,0x8b,0xbf,0xa7,0xed,0xf8,0xb4,0xa5,0x11,0x61,0xa6,0xf9, + 0xb1,0xba,0x65,0x7c,0xe5,0x30,0x2,0x92,0x8b,0x66,0xa9,0xd4,0x1e,0x65,0x99,0x13, + 0x7e,0x3,0xdf,0xde,0xab,0x3c,0xcf,0xe3,0xf3,0x9,0xfd,0xfe,0x20,0x84,0xfe,0xe0, + 0x42,0x18,0x13,0xf9,0xcb,0xb3,0xb3,0xb9,0x85,0x36,0x6e,0xc,0xce,0xb6,0x7d,0xaf, + 0xb1,0x2,0x10,0x9,0x42,0x18,0x6b,0xa6,0xfb,0xa2,0x46,0xf1,0x2,0x8d,0xfd,0x1c, + 0x33,0x18,0xc7,0x61,0x8c,0xe2,0x78,0xa3,0x12,0xd3,0x9e,0x33,0x13,0x1,0x44,0xc7, + 0xbc,0xdd,0xa3,0x6f,0x83,0x8c,0x6f,0x6b,0x32,0x1d,0xc1,0xf4,0x51,0x75,0xcc,0x34, + 0xb2,0x40,0xb7,0x5b,0x6,0x41,0xcd,0xc,0xf5,0x7f,0x37,0x10,0xe5,0xcd,0x4e,0x8a, + 0x60,0x33,0xd2,0xcb,0x3,0x4a,0xf6,0x7,0x8b,0x9c,0xab,0xed,0x77,0x4,0x8b,0x72, + 0x3,0xe5,0x6e,0xa1,0xc3,0xa8,0x7,0x1e,0x30,0x6f,0x74,0xd3,0x77,0x68,0xc7,0x83, + 0xe6,0xbd,0x9e,0x64,0x3,0x27,0x50,0x43,0xd,0x13,0xa8,0xa0,0x17,0xbd,0xe8,0x45, + 0x5,0xe9,0xf5,0x99,0x40,0xec,0xa1,0xb2,0xc4,0xc8,0x12,0x35,0xec,0xbc,0x30,0x9, + 0x66,0x93,0x9a,0x46,0xcd,0x61,0x4e,0xd2,0xb8,0x0,0x91,0xdd,0xe3,0xf7,0x13,0xe5, + 0x97,0x40,0xcd,0x64,0xd2,0xe9,0x9e,0x94,0x74,0xdf,0x47,0xbb,0xe4,0x83,0xe1,0xda, + 0x68,0x11,0xe5,0xd9,0xf9,0x4,0x19,0x5f,0x6e,0x28,0x4,0xa1,0xda,0xa6,0x49,0x87, + 0x8e,0xbb,0x8a,0x65,0xbd,0x9e,0x64,0x3,0x69,0xc,0xa7,0x69,0xcc,0x0,0xe8,0x42, + 0x2f,0xba,0xd1,0xd3,0x74,0x34,0xed,0xaf,0x7,0x96,0x59,0xa1,0x59,0xf,0x11,0xd6, + 0x72,0x6b,0x2a,0xe1,0x24,0x2,0xa,0xb5,0x4,0xc9,0x95,0x8f,0x7e,0x97,0xb4,0xc6, + 0xca,0xed,0x7c,0x7e,0x9f,0xf6,0xe8,0xa3,0x1c,0x14,0xf5,0x2,0xeb,0xa2,0x72,0x57, + 0x30,0x9f,0x31,0x51,0xb6,0x20,0x23,0xbd,0xcc,0x0,0x40,0xb4,0x8d,0x1,0xe1,0x39, + 0x8f,0xee,0x9e,0xc6,0x12,0xf3,0xab,0x2b,0x9f,0x8c,0x4a,0x41,0x6a,0x6f,0x11,0xa6, + 0xa0,0x0,0x74,0xa1,0xbb,0xf1,0xaf,0x2,0xae,0x8a,0x86,0xee,0xb5,0xd0,0x84,0x25, + 0x61,0xc6,0xbe,0xb8,0x89,0x37,0x2,0x5d,0xd6,0x9e,0x3d,0x16,0x86,0x80,0x56,0xfa, + 0xc9,0x2b,0x67,0x3c,0xe4,0x6a,0x8e,0x38,0x20,0xb6,0x6f,0x1c,0x6c,0x4d,0x75,0x4c, + 0x11,0x2e,0x21,0xb7,0x4,0x2,0xa0,0xb7,0xb1,0xdf,0xdc,0xc0,0xfd,0xb8,0x6c,0xfe, + 0xf7,0xa5,0xa9,0x5c,0x22,0x5e,0x91,0x2d,0xb9,0x3e,0x5b,0xb1,0x9,0x6d,0x9e,0xa3, + 0x2b,0xe8,0x42,0x17,0xba,0x50,0x41,0x97,0x1,0x3d,0xd7,0x29,0x4d,0xa9,0xa5,0x31, + 0xfc,0xd2,0xe5,0xdb,0x9c,0xbc,0x10,0x1a,0xb,0xe5,0xc7,0xe7,0xa3,0xa3,0x12,0x75, + 0x54,0x3b,0x7f,0xb6,0x4e,0x17,0x95,0xab,0xa4,0x6e,0xad,0x53,0xa6,0x60,0x96,0xab, + 0x8b,0x72,0xa,0xe9,0x4c,0x5c,0x92,0x79,0x6c,0xf0,0x34,0xf3,0x4b,0xea,0x46,0x92, + 0xa9,0x5e,0x96,0x26,0xa4,0x2e,0x32,0xda,0xa,0x81,0xc6,0x9f,0x66,0xc7,0xb1,0x51, + 0xa3,0xd6,0xbc,0x3c,0x54,0x1a,0xff,0x29,0x54,0x9a,0xfa,0x13,0x65,0xf1,0xeb,0xc4, + 0xdf,0x83,0x0,0x9e,0xa4,0x0,0x39,0x2c,0x16,0xca,0xdb,0x7f,0xe4,0x64,0x34,0x9d, + 0x9,0xfb,0xe9,0x28,0x1d,0xb,0xd5,0x82,0xc4,0xc1,0x72,0xda,0x76,0x5b,0x1d,0xf, + 0xdd,0xef,0x33,0x32,0x71,0xa6,0x39,0x61,0x6,0xea,0x1,0xed,0xcc,0x30,0x54,0x21, + 0xf0,0x2a,0xfa,0x11,0x68,0xc3,0x3f,0x6a,0x56,0x71,0xf2,0x91,0xdb,0x37,0x5c,0x4f, + 0x26,0xb5,0xcb,0x29,0xa6,0xe4,0xef,0xb3,0xd3,0x51,0x7a,0x11,0x39,0x9e,0x8e,0x52, + 0x79,0xa1,0x4a,0x15,0x22,0xb4,0x26,0x1f,0xc,0x33,0xe8,0x8b,0x16,0x64,0x42,0x44, + 0x99,0xec,0x96,0x7d,0xe2,0x6f,0xb7,0x25,0x8f,0xaf,0x80,0xb9,0x33,0x62,0xfa,0xdf, + 0xc2,0x15,0xd1,0xa2,0xfe,0x4e,0x22,0x46,0xbb,0x7d,0x24,0x7e,0xfd,0xb,0x25,0x70, + 0xb3,0xb2,0xc7,0x42,0x65,0xfd,0x4c,0xde,0x6,0x53,0x12,0x1,0xd6,0x70,0x90,0x34, + 0x32,0x51,0xb7,0x90,0x4a,0x2d,0xdc,0xaf,0xab,0x55,0xfe,0x60,0x51,0x43,0xed,0xc3, + 0xdb,0x95,0x42,0x3,0x43,0xc8,0x79,0x9b,0xd4,0x54,0xea,0xe6,0xe5,0xf1,0xc1,0xe4, + 0xa3,0x26,0xe9,0xe8,0x7d,0x26,0x8,0x5b,0x49,0x46,0xb3,0x3b,0x3b,0x52,0xcf,0x48, + 0xb6,0x9e,0x81,0x6f,0x20,0x6d,0xd6,0x58,0xa8,0x82,0x32,0x4b,0x1f,0xff,0xf0,0x8f, + 0xb7,0x50,0x22,0x3a,0x9a,0xbe,0x45,0x13,0xd3,0x22,0xe3,0x60,0xd9,0xc6,0xc4,0x42, + 0xa,0x32,0x20,0xde,0x3f,0xc,0x6b,0x2b,0xde,0xba,0xee,0x73,0x44,0xc2,0x9d,0x87, + 0xe2,0x8a,0xb6,0x28,0x23,0x19,0x2d,0xb7,0x82,0x6,0x39,0x0,0xe9,0xbe,0x55,0x6e, + 0x2c,0x84,0x23,0x1a,0x52,0x51,0x31,0x29,0x88,0x65,0x1d,0x6f,0x1,0xc0,0x61,0xd6, + 0x53,0x2b,0x6b,0xd9,0xb4,0x9d,0x7b,0x7f,0xd2,0x4b,0x53,0x6b,0xe7,0x89,0xb6,0xae, + 0x3a,0x46,0x9a,0x18,0x28,0x3b,0x23,0x9c,0x5c,0x72,0xaf,0x8b,0x8e,0x42,0xdf,0x95, + 0x8e,0x85,0xad,0xae,0x40,0xc8,0x2e,0xd0,0x48,0x67,0x50,0x96,0x13,0xb,0xb9,0x4a, + 0x12,0x95,0xaa,0xb7,0x4d,0x9e,0xe6,0x36,0xfd,0xe3,0x8b,0xd7,0x42,0xe9,0x28,0x4, + 0x74,0x34,0x59,0x88,0x68,0x5f,0x22,0x28,0x5a,0xaa,0xc4,0x17,0xa6,0x22,0x17,0xbe, + 0x6e,0xb7,0xea,0x18,0xc9,0x73,0x28,0xba,0xb5,0xfa,0x9e,0x87,0x66,0x9c,0x20,0xc4, + 0x5d,0xc9,0xac,0x10,0xd6,0x29,0xd6,0x2a,0x32,0x9a,0x4d,0xe2,0xc9,0x43,0x4c,0xcb, + 0x88,0x85,0x94,0x28,0xe4,0xfa,0xe9,0x2a,0x5e,0x93,0x41,0x11,0x8e,0x7c,0x90,0xcb, + 0x4,0x5d,0x39,0xab,0x6c,0x92,0x4c,0x2b,0xe3,0x60,0xde,0xd9,0x31,0xad,0x39,0x47, + 0x93,0xef,0x25,0x62,0x30,0x46,0x82,0xb0,0xcb,0x38,0xa0,0x1e,0x48,0x46,0xcb,0xec, + 0xa6,0x40,0xc6,0x38,0xb8,0xd0,0xb1,0x30,0x14,0x86,0x4a,0x40,0x47,0x7d,0xdf,0x82, + 0x8f,0x8e,0xaa,0x60,0x8,0x2e,0x5c,0x1c,0x94,0x91,0xd0,0xd6,0x9f,0x8f,0x32,0xea, + 0x4b,0xcb,0x32,0x5e,0x10,0xee,0x78,0x4,0xa3,0x9c,0x34,0xe3,0x7b,0x83,0xad,0x16, + 0x69,0xa4,0xd9,0xa2,0x4,0x8c,0xc5,0x6b,0xa4,0x54,0x29,0x43,0x28,0xc,0x5b,0x45, + 0x47,0x7d,0x10,0x54,0x4,0x81,0x96,0x49,0x55,0x79,0xe3,0x60,0x1e,0x12,0xba,0x10, + 0xdc,0x8c,0x13,0xd1,0x8c,0x48,0xa8,0x67,0x7e,0xe4,0x1,0x21,0x34,0x7e,0x64,0x7a, + 0x6d,0xe9,0x13,0xac,0x38,0xaf,0xaf,0x58,0x81,0x26,0xd4,0xac,0x80,0xf7,0x84,0xc8, + 0x17,0xb,0xa9,0x6c,0x50,0x2,0xc3,0x85,0xa7,0xa3,0xfe,0xba,0x28,0x79,0x1c,0x54, + 0x5,0xc6,0xc1,0x56,0xf,0x30,0xcc,0x7e,0xb6,0xdb,0x9f,0x93,0x36,0x23,0xe1,0xc3, + 0x7b,0x47,0x7d,0x20,0x4c,0x65,0x85,0x72,0x5d,0xb4,0xd8,0x37,0x92,0x97,0x9c,0xca, + 0x73,0xc2,0x32,0x62,0xa1,0x72,0x40,0xd1,0xd,0xc3,0x70,0x3a,0xaa,0xa,0xa5,0xa3, + 0x9c,0x30,0x3,0x42,0xd1,0xcd,0x17,0x7,0x51,0x2,0x9,0x2d,0xf2,0xfc,0xcb,0x2f, + 0xf4,0x28,0x4a,0x19,0x4d,0x48,0x9f,0x2c,0x8,0x75,0x22,0x2b,0x54,0x4e,0xaf,0x6a, + 0xa1,0x92,0xe1,0xbc,0xee,0x61,0x78,0x86,0x18,0x12,0xb,0x15,0x3,0x45,0x3f,0xc, + 0x21,0x6e,0xed,0xb5,0xfb,0x4,0x95,0xd3,0x9e,0xf0,0x99,0xf4,0xee,0xd7,0x9,0xa7, + 0x48,0x93,0x2d,0xe,0xca,0xc,0xfa,0xf6,0x16,0x64,0xa4,0x49,0x92,0x9,0xc2,0x8a, + 0x4,0x84,0xb3,0xf7,0x60,0x86,0x92,0x66,0x8a,0xe9,0xa,0x2c,0x37,0x11,0xce,0x46, + 0x4c,0x55,0xa1,0xb1,0x30,0xf,0xc,0x15,0x7c,0xad,0xbd,0xc8,0x95,0xf,0xc2,0x13, + 0xb,0x25,0x10,0x2c,0x36,0xe,0x66,0xcf,0x9,0x5b,0x2f,0xc8,0x84,0x9f,0xf1,0xa4, + 0x2c,0xf3,0x43,0x1,0x8,0xf7,0x4e,0xaa,0xfb,0x62,0x3a,0x1a,0x5,0xbc,0x80,0x56, + 0xf5,0x2d,0xe7,0x15,0x68,0xca,0x8d,0x85,0xd9,0x61,0x8,0x11,0x1d,0xa5,0x89,0x27, + 0x3f,0x3c,0x3f,0xb,0x1d,0x55,0x82,0x13,0xb2,0xc8,0x38,0x98,0x2d,0x27,0x6c,0xb5, + 0x40,0x98,0xe5,0xb9,0x54,0x3a,0x23,0x3c,0xb8,0x73,0x87,0x0,0x84,0x0,0xfe,0x35, + 0x69,0x53,0x94,0xab,0x46,0x95,0xd1,0x83,0x5f,0x96,0x59,0x1,0xe1,0x35,0x5f,0x39, + 0xf2,0x29,0xbe,0x56,0x93,0x97,0x67,0x68,0x3a,0xca,0xe7,0x82,0xc5,0xd0,0x51,0x30, + 0x64,0xb7,0xfc,0x38,0x28,0xcb,0x9,0x8b,0xaf,0xe0,0xca,0x7f,0xf6,0x52,0xf9,0x7a, + 0xdd,0x34,0xea,0xbf,0x4f,0x3d,0xa,0x1,0xc2,0xe8,0xe,0x83,0x9c,0x6,0xbb,0x33, + 0xa1,0x1f,0x40,0xf1,0x7f,0x5f,0x44,0x15,0x4d,0xd6,0x9e,0xa,0x9b,0xd4,0xf1,0x56, + 0x5,0x5f,0xbc,0x96,0xcf,0xa6,0xc8,0x4a,0x47,0xdd,0xd6,0x84,0x7d,0x4c,0x79,0x71, + 0x50,0x5,0x9e,0x73,0x45,0x1,0xab,0x9c,0x92,0xca,0x9a,0xa9,0xb8,0xdc,0x2e,0x4, + 0xe1,0xd0,0xf,0x63,0xaf,0xb0,0xe6,0xbc,0x2e,0xb5,0xa3,0x53,0x83,0x80,0x9c,0xb0, + 0xe8,0x58,0xa8,0x58,0x1a,0xaa,0x9c,0x30,0x74,0xa9,0xa4,0x1c,0x1d,0xe5,0x7,0x3f, + 0x49,0xe8,0x28,0x8,0x38,0xc9,0x5b,0xb6,0x55,0x86,0x38,0x58,0x96,0x31,0xd1,0x4a, + 0x41,0x26,0x4b,0xfd,0xa8,0x32,0xc9,0x68,0x54,0xf9,0x8e,0x10,0x84,0xa8,0x27,0x9, + 0xa9,0x2a,0x1,0x74,0xad,0x11,0x68,0xb2,0x55,0xd1,0x20,0x63,0x2c,0x54,0xde,0x8c, + 0x30,0x6b,0xf1,0x9a,0xac,0x88,0xdb,0x4f,0x47,0x81,0xd0,0x9a,0x51,0x3f,0xc,0xa5, + 0x71,0x50,0x5,0x81,0x2f,0xb,0xff,0x5a,0x58,0x11,0x86,0x57,0x46,0xd,0x10,0xde, + 0xb7,0xf3,0x90,0x14,0x84,0xc0,0xed,0x65,0x13,0xd2,0x32,0x92,0xe4,0xa2,0xaa,0x68, + 0x54,0x70,0x2c,0xc,0x19,0xf6,0x51,0x7e,0xd5,0xc,0x9c,0xf9,0x60,0x78,0xc1,0x9a, + 0xef,0x7d,0x0,0x72,0x5b,0x5e,0xe,0xbe,0x85,0x15,0x64,0xf2,0x91,0x51,0x4,0x91, + 0x51,0x6,0x84,0xf5,0xdb,0xe3,0x5c,0xb2,0x86,0x3c,0x75,0x9,0xb,0xed,0xdc,0xf8, + 0x0,0x99,0xc5,0xb8,0xe7,0xd4,0x50,0x94,0x2,0xc3,0x90,0xaa,0x99,0x10,0x3a,0x9a, + 0xf,0x82,0x2e,0x18,0x86,0x1a,0xf4,0x4a,0x0,0xbc,0x62,0xd,0xb2,0xb2,0xc9,0xa8, + 0x79,0x94,0x19,0xc4,0xba,0x42,0x40,0xb8,0x6b,0x7f,0xdc,0x63,0x5f,0x4f,0xad,0x18, + 0xd8,0x4a,0xb5,0xaa,0xd8,0x12,0x6f,0x64,0xf0,0xa,0xfd,0xb1,0x30,0xdf,0xe9,0x9b, + 0x95,0x8e,0x72,0xef,0x36,0x8c,0x8e,0x4a,0xb5,0x51,0xc9,0xb0,0x2d,0x79,0xf4,0xb, + 0x8d,0x83,0x2a,0xf3,0x79,0x54,0x96,0x60,0x18,0xc2,0x9,0x8d,0x48,0x58,0xdd,0x71, + 0x77,0x0,0x8,0xdd,0x84,0x34,0xbb,0x50,0xb3,0xb0,0x2e,0x4e,0x71,0x2d,0xbf,0x10, + 0x41,0x90,0x96,0xf6,0x43,0x8b,0xd7,0x24,0x55,0x33,0x21,0xf6,0x44,0x96,0xb2,0x6d, + 0xdf,0x7b,0xc8,0x12,0x7,0x43,0x72,0xc2,0x85,0xe0,0x58,0xd9,0x2b,0x53,0x93,0x10, + 0x34,0xa6,0x36,0x7d,0x27,0xe9,0xda,0x7b,0x41,0xa8,0x9,0x10,0xe6,0xad,0x5c,0x29, + 0x23,0x46,0x66,0xbd,0x56,0x15,0x63,0xdc,0xbb,0x21,0x98,0xb5,0x86,0xd4,0x5f,0x35, + 0xe3,0xa6,0xa3,0x20,0x8b,0xda,0xf2,0xd7,0x8c,0xca,0x4a,0xbb,0xcb,0x30,0x26,0xca, + 0x13,0x64,0xca,0x24,0xa3,0xe9,0x0,0x56,0xb9,0x83,0xfb,0xb,0x6,0x84,0xe7,0xfe, + 0x10,0x47,0x4d,0x34,0x17,0x9,0xbc,0x22,0x99,0x7a,0x5e,0x81,0x26,0x5f,0x2c,0xe4, + 0xf3,0xc1,0x22,0x8a,0xd7,0xc2,0x7b,0xa,0x7d,0x4b,0xc1,0xc0,0x11,0x7b,0xe5,0x1a, + 0x2f,0x17,0xe7,0xca,0x6c,0xdb,0x2d,0x4b,0xe4,0x2b,0x93,0x8c,0x2a,0x0,0x46,0xb, + 0xbd,0xae,0x7d,0x3b,0x10,0x84,0x77,0xd6,0x54,0xd3,0xd1,0xd0,0x98,0xc9,0xc,0xbc, + 0x85,0x72,0x75,0xca,0xae,0xa2,0x9,0x6b,0xfe,0xc9,0x3,0xc3,0x56,0xd2,0x51,0x59, + 0x66,0xcb,0xfd,0x96,0x2d,0xe,0xca,0x8c,0x89,0x85,0x6e,0x11,0x8,0x57,0x45,0xe7, + 0xc2,0x97,0xa1,0xa7,0xdc,0xb7,0x6b,0x7f,0x20,0x8,0x81,0xe8,0x2b,0x74,0x56,0x58, + 0x6,0x21,0x6d,0x87,0x1e,0xfc,0x3c,0xce,0x61,0xf8,0x69,0x2c,0x19,0x80,0x8,0x22, + 0x2b,0xf3,0xd9,0x14,0x1c,0x1d,0xf5,0xc5,0x42,0x69,0xcd,0x28,0x67,0xcb,0xb4,0xa6, + 0x6d,0xb7,0x2c,0x61,0xaf,0x28,0x50,0xa6,0x8f,0x48,0x4,0xaf,0x5b,0xf8,0x47,0x67, + 0x41,0x38,0x7d,0x1b,0x8e,0xc7,0x20,0xd4,0x99,0x55,0xc8,0xf6,0x74,0x78,0x24,0xf2, + 0xb8,0xef,0x64,0x52,0xce,0xd3,0x52,0x1a,0x51,0xf8,0x1a,0x52,0x6e,0x2,0xa9,0x74, + 0xda,0x1a,0x1c,0x8f,0x57,0xac,0x35,0xa1,0xbc,0x99,0x61,0x7b,0x57,0xc7,0xa8,0xc2, + 0x62,0x1f,0x4b,0x46,0x51,0xf9,0x4a,0x6,0x10,0xee,0x9b,0xd0,0xdf,0x74,0x13,0xd2, + 0xf0,0xb8,0x58,0x4e,0x4f,0x7e,0x51,0xe4,0x34,0x24,0x16,0xca,0x68,0xa9,0xbf,0x9c, + 0xdb,0x5f,0x43,0x8a,0xc,0x3,0x2e,0x40,0xca,0x3a,0xfe,0x81,0xbf,0x9c,0xb6,0xeb, + 0x27,0xa4,0x10,0x89,0x34,0xc5,0x55,0xc7,0x0,0x65,0x8a,0x30,0xc5,0xc8,0x90,0x9, + 0x32,0x7a,0xf7,0x8e,0x9d,0x19,0x40,0x8,0xa8,0x9b,0x8d,0xb8,0x98,0x99,0x32,0x94, + 0xf,0xb2,0x7c,0x25,0xde,0x3e,0x30,0xd2,0xb0,0xf4,0x93,0x31,0x59,0x39,0xb7,0xab, + 0x86,0xb4,0x1c,0x3a,0xaa,0x4,0x35,0xa3,0x4a,0xac,0xfd,0xd2,0x65,0x6c,0x79,0x5c, + 0xc1,0xf2,0x4,0x99,0x32,0x54,0x76,0xd7,0xfb,0x32,0x31,0x83,0x9b,0x5c,0x7f,0xe9, + 0x0,0x61,0xf4,0x2d,0x8c,0xcb,0x9,0x69,0x76,0xf7,0xb0,0xdd,0x44,0x1a,0xb9,0x5a, + 0x9a,0x4d,0xa0,0xe1,0x61,0x28,0x91,0x67,0xf2,0xd3,0x51,0x20,0xbc,0x66,0x94,0xcb, + 0xb,0xdd,0x60,0x6c,0x65,0x75,0x4c,0xab,0x84,0x18,0x79,0x8,0x32,0x95,0x51,0x7d, + 0x6b,0x46,0x10,0xe,0x4f,0xe1,0x36,0x6,0xd7,0x85,0x86,0xed,0x72,0x12,0xf0,0x3c, + 0xee,0xa1,0x4f,0x48,0x50,0x9e,0x53,0xd0,0x6f,0x53,0xc8,0x8b,0xd7,0xb2,0xd0,0x51, + 0xe5,0xa4,0xa3,0xd9,0xb2,0x42,0x69,0x24,0x74,0x51,0x52,0x7f,0x1c,0x2c,0x5f,0x90, + 0x29,0x83,0x8c,0x52,0xdb,0xac,0x49,0x46,0x7f,0x34,0xb4,0x2b,0x23,0x8,0x81,0x8a, + 0x41,0x48,0x67,0x72,0x65,0x83,0xad,0x17,0x6b,0x8a,0x58,0xc9,0x82,0x7e,0xa7,0x7c, + 0x24,0xcc,0x27,0xf5,0x2b,0x21,0x1d,0xd,0x2b,0xdf,0x56,0x99,0xb,0xd6,0x42,0x4, + 0x19,0xb7,0x87,0x1a,0x92,0x13,0x96,0x2d,0xc8,0x94,0x41,0x46,0xa9,0x7b,0x4d,0xbc, + 0xa8,0x9b,0xdc,0xcf,0xe0,0x4,0x21,0xee,0x88,0x2d,0xfb,0x19,0x63,0x0,0xa2,0x2a, + 0xe8,0xa,0xb2,0xd0,0xe,0x50,0x16,0x62,0x2a,0x8b,0x84,0x45,0xd4,0x90,0xba,0xd6, + 0x67,0x82,0x70,0x5f,0xb6,0x82,0xb5,0x3c,0xc3,0xaa,0x54,0xa9,0xd5,0x31,0xf9,0xf3, + 0xbb,0x62,0xc8,0xa8,0xef,0x5e,0x6d,0x32,0xc7,0xa8,0xeb,0xd6,0x1c,0x20,0xdc,0x31, + 0xad,0xff,0xc5,0x24,0xa4,0x2a,0xe3,0x8b,0x2b,0x5e,0xac,0x29,0x86,0x88,0xa8,0xc0, + 0x58,0xa8,0xc4,0x91,0x30,0x7f,0x29,0xb7,0x7b,0x2,0xa9,0x7b,0xde,0x4c,0x8,0x1d, + 0xd,0x2b,0xdb,0x56,0x9e,0x18,0xa8,0x44,0x97,0xb3,0xec,0x62,0x4c,0x11,0xf3,0x18, + 0x50,0x52,0xec,0x33,0xef,0x4d,0x90,0xd1,0x1f,0x6c,0x7f,0x22,0x4f,0x24,0x4c,0x28, + 0xa4,0x53,0x99,0xaf,0xc,0xed,0x21,0xd6,0xe4,0xe9,0xc1,0x4f,0x53,0xd1,0xf0,0x48, + 0x18,0x5a,0xca,0xcd,0x15,0xaf,0x15,0x4d,0x47,0x15,0xf9,0x1a,0x39,0x99,0x86,0x23, + 0xa4,0xf6,0x25,0x24,0xbb,0x31,0xd1,0xea,0x69,0xee,0x28,0x24,0xf6,0x25,0xb7,0x49, + 0xe3,0x77,0x7d,0xb3,0xef,0x39,0x3c,0x20,0xdc,0xf8,0x6d,0xb5,0x2f,0xf6,0x3d,0x6a, + 0x39,0x5f,0x5a,0xde,0xf,0xbd,0xd5,0x3d,0xf8,0x60,0xa9,0x28,0x3c,0x2a,0xa3,0x4f, + 0xf2,0xcf,0x5e,0xbc,0xc6,0x15,0x71,0xe7,0xa3,0xa3,0x61,0x5a,0xae,0x3f,0x12,0x16, + 0x53,0x1d,0x93,0x97,0x13,0xb5,0x4a,0x84,0x49,0xdf,0x1b,0x99,0x19,0xe1,0x74,0xcf, + 0x4d,0x39,0x41,0x78,0x67,0x4d,0x7f,0x2e,0xbe,0x35,0x41,0xa8,0x5d,0xd9,0xc0,0x57, + 0x46,0x2,0x9d,0x47,0xa0,0xf1,0xcb,0xe8,0x2e,0xea,0xe5,0x22,0xa3,0x32,0x2a,0x9a, + 0x85,0x8e,0xf2,0xe6,0x44,0xc8,0xf0,0xfb,0x90,0xd7,0x9,0x76,0xda,0x1a,0x77,0x79, + 0xca,0x57,0x1d,0x53,0x46,0x79,0x76,0xd9,0x44,0x14,0x50,0x89,0x38,0x88,0x5b,0xb7, + 0x1f,0xc9,0x9,0x42,0xa0,0x7e,0x7d,0x4c,0x6f,0xa7,0x73,0x5d,0x25,0xda,0x4b,0xac, + 0x9,0xad,0xa2,0x81,0x57,0x63,0xc,0x99,0x62,0xed,0xb7,0x2a,0x8a,0xa6,0xa3,0x2a, + 0x47,0xcd,0xa8,0xf2,0xd0,0x50,0xfa,0xd3,0x9,0x23,0xa1,0xb,0x21,0xcc,0x15,0x17, + 0xfb,0x92,0x9b,0x99,0xb8,0xa9,0x1b,0xfc,0xaf,0xc9,0xb,0xc2,0x5d,0x43,0xf8,0xb7, + 0x26,0xbb,0x4d,0xe5,0x85,0x45,0x92,0xd2,0xd6,0x89,0x35,0x21,0xaf,0x25,0x7d,0xfa, + 0x49,0x22,0x61,0xe8,0xc8,0xb,0xc9,0x20,0x60,0x49,0xd5,0x8c,0x8f,0x8e,0xa2,0x50, + 0x5d,0xd4,0xff,0xb3,0xc8,0xe5,0x3d,0x17,0x62,0xdd,0xe7,0xb0,0x57,0x6c,0x9a,0x13, + 0x71,0xef,0xae,0x1e,0xdc,0x79,0x67,0x1,0x20,0x4,0xd4,0xf5,0x54,0xc2,0xa9,0x72, + 0x5e,0x41,0x16,0xae,0x5,0x2a,0x9b,0x7b,0xa8,0xd8,0x2b,0xbe,0xca,0x5d,0xce,0x4d, + 0xcd,0x2e,0xf5,0xd1,0x51,0xea,0x7d,0xa9,0xa0,0x69,0xa3,0x21,0x65,0xdb,0x52,0x41, + 0x86,0x5f,0xd3,0x77,0x61,0x4,0x99,0x32,0xca,0xb2,0x7d,0x60,0x9c,0x4c,0x62,0x47, + 0x17,0x2,0xc2,0xa5,0x5f,0xc3,0xe1,0xf9,0xdf,0x67,0x9b,0x83,0x9f,0x8a,0xc,0xdf, + 0x79,0xc9,0x49,0xf9,0x3d,0xf8,0xdc,0xb8,0xc0,0x90,0x22,0x36,0x79,0x29,0xb7,0x6c, + 0xe4,0x93,0xac,0x9b,0x50,0x79,0x5,0xa5,0x3c,0x25,0xdb,0xd2,0x75,0x7c,0xb3,0x93, + 0xc1,0x56,0xf,0x29,0x94,0x47,0x47,0x6e,0x33,0x92,0xb6,0xda,0xec,0xe7,0x25,0xaf, + 0x4a,0x0,0xc2,0x87,0x66,0xf0,0x5,0x5a,0x7c,0xcd,0xf,0xbe,0x62,0x6a,0xe6,0xf3, + 0x2,0xd5,0xfd,0x9a,0x24,0xab,0xd2,0x4b,0xcb,0xb9,0x65,0xa5,0xdc,0xa,0xf0,0xc, + 0x3e,0x44,0x86,0x61,0x87,0x21,0x9d,0x84,0x4a,0x58,0xa8,0xc6,0xc7,0x40,0x3a,0x16, + 0xe6,0x11,0xce,0xca,0x10,0xf2,0x8a,0x89,0x7d,0xe6,0x36,0x61,0x86,0xbe,0x6f,0xec, + 0xd9,0x57,0x10,0x8,0x81,0xfa,0xd,0x66,0xd2,0xa9,0x45,0x57,0x84,0x85,0x31,0x31, + 0xf2,0x93,0x16,0x5a,0x8c,0x1,0x2b,0x3e,0xe4,0x29,0xe7,0x96,0xd4,0x90,0x86,0x14, + 0x71,0xfb,0xe9,0x68,0x58,0x56,0x28,0x2f,0x54,0x53,0x2c,0x65,0xcf,0x5f,0x1d,0xd3, + 0x4a,0x11,0x46,0xe5,0x6,0x63,0x22,0x48,0xdd,0x20,0x7b,0x9d,0x22,0x10,0xee,0x7a, + 0x4,0x3f,0x88,0x3d,0x90,0xc9,0xc,0xd7,0x87,0xa2,0xe3,0x62,0x51,0x89,0xbc,0xf4, + 0x8a,0xaa,0x2,0xa4,0x19,0x64,0xb6,0x0,0xc2,0x26,0x90,0x66,0xa1,0xa3,0x61,0x59, + 0x61,0x48,0x24,0xf4,0xc5,0xc0,0xf2,0xcb,0xb3,0x8b,0x10,0x61,0x64,0xe7,0x28,0x7f, + 0xcf,0xb4,0x39,0xe2,0x70,0xef,0xe0,0xb7,0xb,0x4,0x61,0x52,0x9c,0x99,0x28,0xd, + 0x7c,0x65,0x10,0x8e,0xfc,0xd7,0x4a,0xe5,0xb8,0xce,0x17,0x23,0xd0,0xf8,0x61,0x28, + 0xb3,0x29,0xc2,0xe8,0x28,0x72,0x58,0x13,0xd2,0x18,0xa8,0x5a,0x28,0xba,0xa9,0x5, + 0x8a,0x7d,0x49,0x32,0x6a,0x6c,0x9f,0xe1,0x46,0x1c,0x66,0x5,0xe1,0x4d,0x38,0xd0, + 0xcc,0x36,0xad,0x2,0xb6,0x3c,0x6f,0xa4,0x2c,0xb1,0x46,0x9a,0x46,0xcb,0xbe,0x48, + 0x49,0x7e,0x18,0x22,0xd0,0x84,0xd6,0x90,0xf2,0x45,0xdc,0xd9,0xe9,0xa8,0x2a,0xdc, + 0x9a,0xe0,0x81,0x58,0x5c,0xbf,0x7c,0x51,0x89,0x46,0x11,0x21,0xc2,0x9e,0x32,0x6a, + 0x88,0x32,0x33,0xb3,0x9f,0x92,0xbe,0x4a,0x21,0x8,0x77,0x4c,0xab,0x4f,0xc4,0xb7, + 0x4e,0xe4,0xb8,0x56,0x94,0xdd,0x2,0xe5,0x82,0x51,0x96,0x2f,0x58,0x79,0x8,0xa9, + 0x24,0x12,0xe6,0x29,0xe5,0x2e,0x9b,0x8e,0xca,0x74,0xdb,0x3c,0x82,0x4c,0xb1,0x22, + 0x5b,0x99,0xfd,0xf1,0x59,0x88,0xa8,0xf9,0x37,0x27,0xcc,0x3b,0xfe,0x49,0x26,0xca, + 0x4,0x80,0x10,0x98,0xfe,0x78,0xfc,0x1c,0x33,0x98,0xcd,0xcc,0x9a,0x8b,0xb8,0x62, + 0xb5,0x6e,0x1d,0x60,0x3f,0x0,0x91,0x41,0xa0,0xa1,0xed,0x0,0x49,0xf1,0x9a,0xaf, + 0x6a,0x86,0xa2,0xa3,0x80,0xaf,0x60,0x4d,0x5,0xf7,0xd0,0x87,0x90,0x51,0xd5,0x32, + 0x31,0xa6,0xfc,0x6a,0x18,0xf7,0xfa,0x4b,0x26,0x19,0xd5,0x1f,0x95,0xbf,0x6e,0x31, + 0x8,0xf7,0x8e,0xc2,0xa8,0x22,0x3d,0x5e,0xd8,0x4b,0x6f,0x8f,0x9e,0x7c,0x3f,0x95, + 0x75,0x13,0xd2,0x3c,0xfd,0xf6,0x2e,0xab,0xc2,0xdf,0x53,0x48,0x13,0x52,0x40,0x52, + 0xb0,0x26,0x7f,0x3d,0xa1,0x31,0x50,0x79,0x62,0x61,0x5e,0x31,0xa6,0x28,0x32,0x5a, + 0x14,0x11,0xb5,0x30,0x71,0xfb,0xd0,0xcf,0x4b,0x0,0x21,0xd0,0xfd,0x91,0x38,0xd1, + 0x9c,0x4a,0xe5,0x9c,0xc5,0x82,0xaf,0xf5,0x3d,0xf9,0x2a,0x28,0xe,0x4a,0xe2,0x61, + 0x88,0x40,0xa3,0x44,0xc5,0x6b,0x45,0xd2,0xd1,0x2c,0xc3,0xee,0xe1,0x71,0x4a,0x29, + 0x32,0xca,0xc5,0xc2,0x85,0x2b,0xcd,0x2e,0x87,0x88,0x2,0x3a,0x29,0xca,0x7c,0x24, + 0xe4,0xdd,0x4,0x80,0x70,0xfb,0x20,0xfe,0x25,0x7e,0xca,0x63,0x19,0xae,0x15,0xd9, + 0x65,0x9c,0x85,0x70,0x99,0xf8,0xd3,0x49,0x12,0xf,0xc3,0x5,0x1a,0xff,0x2a,0xf6, + 0x7e,0x20,0xca,0xe8,0x68,0x1e,0x5d,0x94,0xf7,0x48,0xdd,0xff,0x6f,0xcd,0x77,0xb5, + 0x30,0x44,0x74,0x2e,0x1f,0x34,0xda,0x78,0xb7,0xd,0xfe,0x6b,0x49,0x20,0x4,0xf4, + 0x87,0x4d,0x31,0x56,0x17,0xfa,0x36,0xca,0x6c,0x81,0xca,0x42,0x76,0x14,0x4b,0xac, + 0x64,0xf1,0x30,0x8b,0x40,0xc3,0xf7,0x24,0xd0,0x55,0x33,0x60,0x3b,0xec,0x5d,0x74, + 0x14,0x5,0xe9,0xa2,0xca,0x21,0xc4,0x28,0xf2,0x22,0xd6,0xba,0xd2,0xec,0x72,0x44, + 0x18,0x57,0x54,0x4c,0x90,0xd1,0xff,0x2b,0xa9,0x18,0xcd,0x8,0xc2,0xa1,0xbb,0xf5, + 0x8f,0xe2,0x58,0x78,0x3c,0x53,0xd8,0x2e,0x9a,0x94,0x96,0xe5,0x38,0xb9,0xe3,0x60, + 0x11,0x2,0x8d,0x6f,0x2a,0x37,0x6d,0x28,0xb8,0x3b,0x27,0xe8,0xb5,0x98,0x10,0xfc, + 0x3a,0xec,0x4b,0x7,0x32,0xc7,0x40,0xd5,0x12,0x11,0xad,0xf5,0xb1,0xcf,0xdc,0x26, + 0xcc,0xf4,0x6c,0x4f,0xdf,0xcd,0x61,0xef,0xa5,0x12,0xf8,0xd6,0x3f,0x62,0x26,0xa2, + 0x91,0x8,0x80,0xe5,0x92,0xd2,0x62,0xc5,0x1a,0x8e,0x86,0x52,0x80,0xf4,0xa9,0x8f, + 0xd9,0xca,0xb9,0xfd,0x6e,0xa1,0x74,0xf8,0x2f,0x1d,0xaf,0xa4,0x65,0xdb,0xf2,0x1, + 0xc5,0x6e,0xe0,0xd1,0x9f,0xe4,0x62,0x17,0x61,0x92,0xc7,0xeb,0x78,0x40,0x2f,0x0, + 0xfd,0xd1,0x7b,0x67,0x4b,0x5,0xe1,0xe0,0x3f,0x63,0xc7,0xfc,0xef,0x51,0x23,0x2f, + 0xcc,0xfe,0xe2,0xcb,0x8f,0x8b,0xa1,0xf1,0x51,0x91,0xfa,0x1e,0x7d,0x62,0x85,0x94, + 0xb2,0xd9,0x2,0x8d,0xa,0xaa,0x21,0xf5,0x15,0x71,0x53,0x7b,0xfc,0xd5,0x32,0x2a, + 0x87,0x20,0x3,0x11,0x19,0xe5,0xee,0x59,0xdc,0x22,0x4c,0xfa,0x9e,0x9,0xb3,0x58, + 0xed,0x68,0xd7,0xf5,0xa1,0xef,0x30,0x10,0x84,0xa8,0xab,0xf,0x26,0x63,0xa1,0x2a, + 0xf4,0x9a,0xd2,0x9a,0xb8,0x18,0x2a,0xc7,0x84,0x11,0xd3,0xac,0xfd,0xf6,0x92,0xaa, + 0x19,0xd9,0xb4,0x35,0x20,0x6b,0xc1,0x9a,0x44,0x90,0x51,0x81,0x82,0x8c,0xca,0x5, + 0xc1,0x3c,0x64,0x54,0xa1,0x68,0x8d,0x82,0xde,0x7b,0xcc,0xbc,0xf1,0xff,0x76,0x8c, + 0x97,0xd,0x42,0xec,0xfc,0x2,0x1e,0x5,0x19,0x86,0x51,0xd8,0x9b,0x2a,0xd2,0xc4, + 0xc8,0x46,0x80,0x94,0x58,0xa0,0x9,0xcf,0xc,0x81,0xec,0x55,0x33,0x79,0xe8,0x68, + 0x68,0xe7,0x44,0x76,0x7b,0x9e,0xbe,0x8c,0xa9,0x4c,0xdf,0x45,0x91,0x2d,0x49,0xc5, + 0x11,0x51,0x73,0x3b,0x6e,0xc6,0xc1,0xb1,0xe8,0xa3,0xe1,0x97,0x94,0x60,0x10,0xa2, + 0x8e,0xff,0x15,0xdf,0x38,0x61,0x24,0xa4,0xad,0x24,0xa5,0x45,0x92,0x17,0xff,0xd7, + 0xe6,0x8f,0x83,0xbe,0x5e,0x43,0x20,0x5f,0x47,0x85,0x7f,0x59,0x18,0x39,0x1d,0x55, + 0x41,0x82,0x4c,0x78,0x89,0x9a,0x12,0xec,0x29,0x5b,0x84,0xc9,0x7a,0x6e,0x85,0xef, + 0x4d,0x5,0xa2,0xff,0x3b,0x3c,0xd6,0xa,0x10,0x62,0xf0,0xcb,0xd8,0x16,0xe7,0x85, + 0xe3,0x39,0xde,0xc0,0xc2,0xc4,0x45,0x7f,0x8c,0xe4,0xaf,0xe3,0x32,0xe7,0x50,0xe5, + 0xd0,0x48,0x65,0xc5,0x6b,0xee,0x69,0x6b,0x3e,0xc9,0x28,0xbf,0x35,0x81,0x4c,0x24, + 0xd4,0x1f,0xb,0x8b,0x12,0x61,0x8a,0xa5,0x9b,0xae,0x5e,0xd3,0xe3,0xa6,0x2e,0x7a, + 0xa4,0xe7,0x63,0x59,0x2e,0x32,0x19,0x40,0x88,0x8,0x1f,0xe0,0x34,0xd2,0xec,0xd7, + 0x95,0x72,0xe2,0x62,0xd6,0x2f,0x5d,0x39,0x9,0x55,0x31,0xbd,0x15,0x72,0xab,0x82, + 0x5f,0x9f,0xc9,0xbd,0x14,0x8c,0x12,0x95,0x6d,0xcb,0x4b,0xb6,0xb3,0x8,0x32,0xf6, + 0x6f,0xc5,0xa,0x6b,0x79,0x46,0x51,0x14,0x1,0x51,0x33,0x1f,0xd4,0x1f,0x7a,0xec, + 0x58,0xab,0x40,0x88,0xc1,0xaf,0xea,0x9f,0xc5,0xe1,0xf8,0xa8,0xf0,0xaa,0xb1,0x38, + 0xc4,0x1a,0xe5,0x1,0x62,0x5e,0x81,0x26,0x6c,0x32,0x77,0xc8,0xe0,0x43,0xa4,0x14, + 0x54,0x5f,0xcd,0x28,0x47,0x50,0xdd,0xa5,0x3,0xd9,0x4,0x99,0x30,0x28,0xb6,0x3a, + 0xf6,0x65,0xe7,0x71,0xc7,0xcc,0x7c,0xf0,0xc0,0xf4,0x27,0xb3,0x25,0x3e,0x99,0x40, + 0x8,0x8d,0xf7,0x51,0x89,0xa9,0x2a,0xed,0x7a,0xd3,0x3a,0xb1,0x6,0x29,0xc9,0x3f, + 0x44,0x31,0xd,0x15,0x68,0x24,0xfd,0xc,0x1c,0x1d,0xa5,0xa3,0xb7,0xac,0x60,0x4d, + 0x2d,0x80,0x20,0x93,0x8e,0x98,0xb,0xb3,0x52,0x44,0x5e,0x11,0x26,0xb9,0x37,0x4a, + 0x4,0x20,0xf5,0x7f,0xf6,0x4d,0xb4,0x12,0x84,0x18,0xfa,0x6,0x7e,0x12,0x23,0x72, + 0xac,0xb0,0xb7,0xd6,0x2e,0x62,0x8d,0xec,0x7a,0xae,0x72,0xf4,0x56,0x84,0x58,0x15, + 0x45,0xd1,0x51,0x17,0x1d,0xe,0xb1,0x26,0xa4,0x82,0xc,0xc7,0x2b,0x8a,0xfb,0xae, + 0x8a,0x27,0xa2,0x21,0x7b,0xc7,0x8d,0x54,0x4c,0xed,0x9b,0xbe,0x1e,0x68,0x29,0x8, + 0x81,0xe8,0x7d,0xa6,0x46,0x3a,0x55,0xda,0x1b,0x6d,0xad,0x58,0xa3,0xbc,0x74,0x34, + 0x44,0xa0,0xc9,0x5a,0xc4,0xe6,0xea,0xe3,0x8,0xa3,0xa3,0x28,0xcd,0x9a,0xc8,0x4a, + 0x42,0xf3,0xda,0xf5,0xb,0x29,0xc2,0x24,0xb7,0x5a,0x52,0x17,0xfd,0xc0,0xde,0xc9, + 0x96,0x83,0x70,0xf8,0xdb,0xea,0xdf,0xe3,0x5b,0xa3,0xa9,0x8a,0x55,0x55,0xd2,0xf5, + 0xa7,0x6c,0xb1,0x26,0x4,0x88,0x21,0xa5,0xdd,0xbe,0x2e,0x43,0x97,0x38,0xe2,0xb2, + 0x29,0x7c,0x74,0x54,0xe5,0xea,0xe2,0x70,0x97,0x69,0xab,0x60,0x41,0x46,0x15,0x40, + 0x48,0xcb,0x2b,0x3e,0xf3,0x1d,0x9f,0xde,0x33,0x62,0x9e,0xf3,0x3b,0x96,0x7e,0x16, + 0x68,0x39,0x8,0x81,0xfa,0x3b,0x63,0x75,0x76,0xc6,0x28,0xe7,0xe,0x79,0x53,0xc5, + 0xd2,0x55,0x79,0x3,0xa9,0x5c,0x94,0x71,0x53,0x2a,0xe5,0xe9,0x26,0x97,0x75,0x19, + 0x4a,0x4b,0xb9,0xb3,0xd0,0x51,0xb9,0x2e,0x8b,0xc0,0x18,0x88,0x80,0x58,0x18,0x12, + 0xd,0xcb,0x23,0xa2,0xf9,0x33,0xc2,0x78,0xcf,0x54,0x72,0xf9,0xb3,0x77,0x3f,0x34, + 0xb3,0x20,0x20,0x1c,0xbe,0x5f,0x7d,0x26,0xbe,0x55,0x45,0x94,0xe3,0xaa,0x52,0x86, + 0x86,0x2a,0x8f,0x8b,0x72,0x3a,0xa,0x41,0x64,0x4c,0xc7,0xb,0x99,0x40,0xe3,0x2f, + 0xe5,0xf6,0x3,0xd1,0x3e,0x86,0x17,0x66,0xe4,0x2b,0x25,0xfa,0xc9,0x28,0x3c,0xc4, + 0x93,0xfa,0x54,0x17,0x9b,0x8,0x93,0xdc,0xa3,0x31,0x62,0xee,0xfa,0xd7,0xa1,0xaf, + 0x3,0xb,0x2,0x42,0x0,0xef,0x8d,0xe5,0xa1,0x3a,0xc6,0x72,0x3,0xb0,0x58,0xd, + 0x35,0xab,0x0,0xe0,0x8f,0x82,0xbe,0x2,0x65,0x15,0x68,0x55,0x84,0xae,0xd3,0xe4, + 0x9b,0xb6,0xe6,0xee,0xa7,0xf,0x2f,0xd9,0xe,0x2d,0xd3,0x96,0x44,0xc3,0x32,0x44, + 0x98,0xb2,0x92,0x20,0x7b,0xef,0x31,0x73,0x5,0xc2,0x3a,0xde,0x99,0xb,0x45,0xf9, + 0x40,0xb8,0xf3,0x90,0xfe,0x8b,0xf8,0xd6,0x38,0x66,0xb,0x7,0x60,0x71,0x1a,0xaa, + 0x1f,0x9e,0x4a,0x40,0x4c,0x25,0x71,0x30,0x7f,0x97,0xa1,0xb,0x86,0xe1,0x74,0x54, + 0xfa,0x5c,0x28,0x59,0x90,0x51,0x5,0x5d,0x42,0x8b,0x23,0xa2,0x59,0xcf,0xc6,0x3a, + 0xaa,0xe6,0x5d,0x7f,0x3f,0xf8,0xc0,0x2,0x82,0x10,0x58,0xfe,0xb7,0xd8,0x1e,0x5b, + 0x15,0x23,0x2d,0x0,0x60,0x16,0x31,0x5a,0x3e,0x4e,0x4f,0x5,0xfc,0xee,0x73,0xc, + 0x43,0x7b,0x2b,0x64,0xc5,0x6b,0xd9,0xe9,0xa8,0xca,0x29,0xc8,0x64,0x75,0x5,0x41, + 0x74,0x7c,0xc8,0x8,0x69,0x2b,0x88,0x68,0x16,0x78,0x56,0xcd,0x2a,0xb1,0x6a,0xf7, + 0x9f,0x3,0xb,0xa,0xc2,0x87,0x66,0xf4,0x7f,0x8b,0x6f,0x4d,0x34,0x92,0xd5,0xec, + 0x0,0xcc,0x52,0x6f,0x53,0x44,0x5c,0x54,0x81,0x40,0x84,0x87,0x92,0x49,0xe3,0x21, + 0x90,0xa5,0x78,0x2d,0xdd,0x3f,0x18,0x42,0x47,0x65,0x63,0x35,0x24,0x64,0x54,0x65, + 0x90,0x61,0x7c,0x84,0xb4,0xb8,0xd8,0x57,0x4c,0xee,0x47,0x6d,0xb3,0x49,0x6b,0xe2, + 0xfd,0xfe,0x95,0x78,0x4b,0x6,0x21,0x30,0xf4,0x75,0x65,0x4c,0xdc,0x3f,0x5c,0xf8, + 0x9b,0x6e,0x55,0x6b,0xb0,0xa,0x8a,0x88,0x61,0xc4,0x14,0xc1,0x91,0x50,0x4a,0x47, + 0x41,0xee,0x9,0x83,0x20,0xa,0x10,0x64,0x42,0x2f,0x63,0x45,0x3b,0xc3,0x65,0x8a, + 0x30,0xe9,0xcd,0x3c,0xc7,0xd5,0x23,0x7d,0x9f,0x0,0x16,0x1c,0x84,0x40,0xed,0x5d, + 0x71,0x32,0x38,0x8b,0xd1,0x96,0x0,0x30,0x2b,0x29,0x95,0x92,0xd1,0xec,0x40,0x74, + 0xb,0x35,0x6e,0x8d,0xd4,0xd,0xc3,0x7c,0x74,0xd4,0xaf,0xc3,0xba,0x63,0x60,0x1e, + 0x57,0xd0,0xf5,0xd9,0x66,0xcd,0xde,0xcb,0x4c,0x6e,0x5c,0xc7,0x8d,0x27,0xd7,0x5d, + 0xfa,0xa3,0xd0,0x51,0x16,0x25,0x81,0x70,0xd7,0x23,0xca,0x98,0xba,0x5f,0xc5,0x4c, + 0xc0,0x5b,0x5a,0x58,0xb1,0xc6,0x4d,0x46,0x5d,0xd1,0x11,0x82,0xbc,0x30,0xc4,0xba, + 0x97,0x94,0x72,0xbb,0x8a,0xb8,0x7d,0x74,0xd4,0x3d,0x69,0x3b,0xa4,0x5f,0x42,0x15, + 0x8,0xc0,0xb0,0xf1,0xcb,0xad,0x11,0x61,0xdc,0xc7,0xd5,0x93,0xd6,0xc4,0x6d,0x3b, + 0xef,0x0,0xda,0x2,0x84,0x80,0xfa,0x1f,0xd8,0x1b,0xdf,0x3a,0x18,0xf0,0x6,0xcb, + 0x14,0x95,0xb3,0xe7,0x18,0x7e,0x50,0x66,0x71,0xe,0x43,0xba,0xc,0x95,0xb7,0x78, + 0x8d,0x1b,0x6f,0x61,0x3f,0xbf,0x54,0x83,0xa5,0x2f,0x15,0xc5,0xb8,0x82,0x7e,0x42, + 0xda,0x8a,0x51,0x14,0x79,0xb3,0x41,0xe0,0x90,0x29,0xc9,0x4c,0x74,0xbf,0x3,0x68, + 0x1b,0x10,0xee,0x18,0xc7,0xef,0xc5,0xb7,0xa6,0x51,0xd,0x7a,0x63,0x45,0x4a,0x38, + 0x59,0x49,0x29,0x25,0x18,0x14,0x49,0x4c,0xb3,0x9,0x34,0x76,0xdf,0x9f,0x9c,0x8e, + 0x2a,0xc8,0x27,0xca,0xf0,0xe3,0xc,0xf3,0xb8,0x82,0x70,0x2,0x50,0x65,0x52,0x45, + 0x8b,0xac,0x79,0x9,0x3d,0x4e,0xe1,0x58,0x72,0xc9,0x97,0xff,0xbe,0x7d,0xb0,0x8d, + 0x40,0x8,0xc,0x7e,0x13,0x5f,0x89,0x6f,0x8d,0xa6,0x1c,0xc3,0xd6,0x5c,0xa9,0xf2, + 0x8e,0x35,0x50,0xc2,0x93,0x26,0xbb,0x73,0x18,0x2e,0xd0,0xd0,0x35,0xa4,0x6e,0x41, + 0x46,0x5e,0xb0,0x6,0xef,0x38,0xc3,0x10,0x57,0x50,0x76,0xe9,0xa2,0x9,0x69,0x3b, + 0xe8,0x9e,0xbe,0xe3,0x22,0x24,0x64,0xd0,0xbb,0x7,0x3f,0x6,0xb4,0x15,0x8,0x81, + 0xe8,0xf,0x63,0x7,0x33,0x8a,0x17,0x33,0x2c,0x3c,0x33,0x2c,0x97,0x94,0x16,0x7, + 0x44,0x88,0x8,0xa9,0xb4,0xbb,0x41,0xc1,0xd7,0x53,0xa8,0x4,0x5,0x6b,0xd9,0xac, + 0x89,0x7c,0x59,0xa0,0x8b,0x63,0xb4,0x9b,0xee,0xe9,0xfe,0xcb,0xc3,0x66,0x3,0x6f, + 0x2d,0x7a,0xab,0x74,0x9,0xd0,0x16,0x82,0x70,0xf8,0x80,0xe9,0x18,0x4e,0x36,0xbd, + 0x14,0xb5,0x80,0x0,0x94,0x82,0x4f,0x15,0x0,0x44,0x78,0x68,0x9b,0x12,0x77,0x19, + 0x86,0xda,0x14,0x4a,0x30,0xde,0x29,0x9b,0x35,0x1,0xb1,0x2d,0x2f,0x33,0x22,0xfc, + 0x94,0xb4,0xb5,0xc5,0x67,0x21,0xd0,0x9c,0x48,0x34,0xf0,0xea,0xff,0x33,0x7c,0x3f, + 0xd0,0x76,0x20,0x4,0x86,0x3e,0x3,0x63,0x19,0x8c,0xc3,0xa8,0xb5,0x19,0x0,0x25, + 0x4b,0x81,0x66,0x7,0x62,0x16,0x62,0xa,0xc8,0xca,0xb9,0x15,0xfc,0xeb,0x33,0xc1, + 0xca,0x8,0xfd,0x65,0xdb,0x3e,0x6b,0x22,0x8f,0x2b,0x18,0x72,0x2b,0xbf,0xee,0xa9, + 0x4a,0x5,0xa2,0x42,0xd4,0x94,0x1b,0x1,0x0,0x8f,0x76,0x7d,0x10,0x68,0x4b,0x10, + 0x42,0xd7,0xaf,0x8b,0x33,0xd7,0xba,0x97,0x92,0x16,0x4f,0x55,0xb3,0xc6,0xc5,0x2c, + 0x40,0x74,0x3f,0x82,0xcc,0x39,0xf4,0x97,0x73,0xc3,0x41,0x47,0x21,0xa6,0xa3,0xfc, + 0xd4,0xd3,0x90,0x12,0xb5,0xb0,0xda,0x50,0x5f,0x9d,0xcc,0xc2,0x89,0x30,0x59,0xfe, + 0xf2,0xb0,0xa9,0x72,0x44,0xfa,0x77,0x77,0x4c,0xb7,0x2b,0x8,0xb1,0x6b,0x28,0x39, + 0x93,0x74,0xb4,0x90,0xab,0x50,0x1e,0xb5,0x54,0x5,0x5f,0x55,0xa5,0x40,0x94,0x67, + 0x88,0xfe,0x78,0x28,0xb1,0x2a,0xe8,0xd6,0xde,0x2c,0x74,0xd4,0x55,0xb2,0xed,0x1f, + 0x5c,0x91,0x1f,0x80,0xb,0x9d,0xfb,0x85,0xf7,0xf6,0x1f,0x4f,0x76,0x8,0x7d,0x6a, + 0xe8,0x3f,0x81,0xb6,0x5,0x21,0xb0,0xf1,0x23,0xb8,0xcf,0xbc,0x7e,0x4c,0xb5,0xc, + 0x80,0xd9,0x29,0x8d,0x2a,0x1,0x88,0x60,0x5,0x9a,0x2c,0x3,0x11,0xa9,0xac,0x30, + 0x94,0x8e,0x42,0x10,0x61,0xa5,0x82,0xc,0xa,0x2,0xa0,0x6a,0x11,0xeb,0xc9,0xb7, + 0x67,0x16,0xfb,0xcd,0xdd,0x7b,0xf1,0xa7,0x40,0x5b,0x83,0xf0,0xce,0x5a,0xfd,0xd, + 0xf1,0x92,0xa5,0x1a,0xfb,0x98,0xa9,0xa4,0x59,0xb7,0x72,0xc4,0x1a,0x25,0x0,0x22, + 0x32,0xeb,0xa4,0x12,0x42,0x2a,0x1b,0x90,0x9f,0x8d,0x8e,0xca,0x57,0x42,0x84,0x63, + 0x1,0x97,0xd0,0xe2,0xec,0x2c,0x0,0x2c,0x36,0xd1,0x28,0x6,0x88,0x1a,0x7,0x4c, + 0x19,0x34,0xc2,0x1b,0x7,0x8f,0xb6,0x39,0x8,0x81,0x5d,0x8f,0xc0,0x50,0x49,0x67, + 0x70,0xa8,0xf0,0x2b,0x53,0x39,0x57,0x4d,0x15,0x64,0x57,0x20,0x93,0x54,0xa3,0xa, + 0xb0,0x2a,0x42,0xe9,0xa8,0x4b,0x17,0x2d,0xc7,0x94,0x8,0x5,0x60,0xeb,0x8a,0xcf, + 0xb2,0x6c,0xa3,0x49,0x83,0xfe,0xaf,0x6,0xbf,0xf,0xb4,0x3d,0x8,0x81,0xc1,0x4f, + 0x28,0xa3,0xd9,0xbf,0x9a,0x5c,0xb3,0xa6,0x2d,0x1,0x98,0xd,0x88,0xa1,0x9a,0x29, + 0x48,0x0,0x86,0x35,0x1c,0xc1,0x61,0x52,0xc0,0x1,0x41,0xc9,0xe8,0x8c,0x85,0x0, + 0x60,0x96,0x8c,0xb0,0x35,0x24,0x74,0x6e,0x9b,0x4e,0xf4,0x4c,0xe8,0x9f,0x2d,0xfb, + 0x33,0x60,0x51,0x80,0x10,0x50,0xd7,0x99,0x34,0x7a,0x9f,0x69,0x72,0x96,0x98,0x48, + 0x67,0x13,0x6b,0x94,0x0,0x88,0xc8,0x4,0x44,0x38,0xe4,0xd,0x77,0x3c,0xe4,0x2d, + 0x85,0x74,0x5e,0x68,0x13,0x52,0x80,0x2b,0xdb,0x2e,0x46,0x90,0xc9,0x3,0x40,0xff, + 0xb7,0xdb,0x5e,0x40,0xd4,0xd8,0x6b,0x4e,0x54,0x9b,0xd0,0xaf,0xcf,0x33,0xce,0xa9, + 0xc5,0x20,0xdc,0x71,0x58,0xbd,0x39,0x7e,0xf5,0x75,0xec,0x2b,0x98,0x24,0x14,0x1b, + 0x29,0x55,0xa0,0x34,0x23,0x35,0x2f,0x64,0xc4,0x94,0xce,0xe1,0x64,0xc5,0x6b,0x6e, + 0x3a,0x8a,0xc0,0x51,0x4e,0xa1,0xae,0x60,0x48,0xc9,0x83,0x74,0x4f,0x19,0x94,0x33, + 0xfb,0x5f,0x1e,0x44,0xc2,0x89,0x78,0xf7,0xf0,0xa3,0x28,0x65,0xeb,0x2a,0xe7,0x61, + 0xab,0x3b,0xd6,0xac,0x55,0xbf,0x10,0x67,0x86,0x15,0xac,0x0,0x9c,0x43,0x86,0x8a, + 0xdc,0x13,0x76,0x1c,0x9f,0x69,0x21,0xe8,0x36,0xbc,0xbf,0xc3,0xf9,0x7f,0x3f,0xc, + 0x95,0x88,0x8e,0xba,0x33,0x4c,0xfe,0x27,0x9c,0x71,0xdc,0x7,0xb9,0x62,0xf9,0x4d, + 0x2b,0xd,0x8,0xee,0x71,0x8e,0x25,0x9d,0xee,0xdb,0x7,0xff,0x8,0x25,0x6d,0x95, + 0xb2,0x1e,0xb8,0xeb,0x8f,0xe3,0x5,0xd4,0x80,0x43,0x38,0x56,0xc8,0x7,0x53,0xec, + 0x55,0xd3,0x5f,0x44,0x95,0x35,0x22,0x86,0x3a,0x87,0x80,0xac,0xf1,0xc8,0xa6,0xa3, + 0xf6,0xa8,0xb,0xe5,0x85,0xa0,0xaf,0x44,0x2d,0xa4,0x38,0xdb,0x5f,0xb,0x23,0xd3, + 0x9e,0x17,0x36,0xf7,0xa3,0xb2,0xc1,0xbd,0xe6,0xcd,0x43,0xfa,0x4d,0xa9,0xf9,0xd6, + 0x8b,0x1,0x84,0x3b,0xa6,0x2b,0xaf,0x8f,0x9b,0x90,0x35,0x9e,0x48,0x34,0xfb,0x96, + 0xa7,0x67,0x15,0x4b,0x4c,0x8b,0x77,0x11,0x69,0x40,0xaa,0xc,0x6e,0x21,0x1f,0x8d, + 0xa5,0xcd,0x4b,0x72,0x57,0x50,0x9e,0x5,0x66,0xa3,0xa0,0xb,0x47,0x39,0xe9,0x2d, + 0xc2,0x1e,0xd3,0x5c,0xd3,0x78,0xd3,0xd0,0x41,0x60,0xd1,0x81,0x10,0xd8,0xf1,0x90, + 0x59,0xd2,0x5d,0x4b,0x26,0xb9,0xb,0x72,0x75,0xf3,0x51,0xac,0xec,0x57,0xf2,0x90, + 0x22,0x6f,0xde,0x39,0xa4,0x4,0x1a,0x9f,0x5b,0xa8,0x82,0x1c,0x42,0x97,0x2c,0x83, + 0x16,0xe8,0xa0,0xfe,0x1c,0xb0,0xb5,0x94,0x93,0xdb,0xb3,0x27,0xb1,0xba,0x8a,0xfa, + 0xc8,0xe0,0xb7,0x50,0xe2,0xd6,0x55,0xe6,0x83,0x8f,0xdd,0xd3,0xb7,0x9,0x4f,0x9d, + 0xbf,0x35,0x8b,0x1a,0x56,0x67,0xca,0xf3,0xca,0xcb,0x15,0xe5,0xf9,0xa0,0x64,0x8f, + 0x24,0x47,0xf4,0x65,0x88,0x6e,0x7b,0x81,0xae,0x9a,0xa1,0xe9,0x28,0x5d,0x4,0x80, + 0x20,0x5b,0x5e,0xa,0x15,0x15,0xc,0xb6,0x76,0xa0,0x9c,0xdc,0x76,0x28,0x51,0x70, + 0xa9,0xef,0xdc,0xf8,0x5f,0x86,0xa3,0x32,0x71,0x52,0x41,0xa9,0x5b,0xf4,0xfb,0x66, + 0x19,0xdb,0x68,0xaa,0x9a,0xb4,0x5c,0x62,0xa,0xf1,0x23,0x67,0xd3,0x4c,0xfd,0x75, + 0x35,0xc8,0xa4,0x94,0x2,0xb4,0x49,0x4f,0xd1,0x51,0xa4,0xa2,0x22,0x57,0xb6,0x2d, + 0xeb,0x97,0xc8,0x52,0x1b,0x2a,0x8d,0x80,0xb2,0x7d,0xe5,0x68,0x4,0x61,0x8f,0x7a, + 0x2,0x87,0xcc,0x9b,0xfb,0xa3,0xd7,0xdf,0x59,0x2b,0x17,0x25,0x25,0x83,0x70,0x78, + 0x4a,0xbf,0x52,0x1b,0xb3,0x71,0xf6,0x61,0x22,0xf7,0x87,0x54,0xc6,0x1e,0xa9,0x58, + 0x9e,0xcf,0xce,0x87,0x97,0x90,0x4a,0x35,0xd2,0x50,0x3a,0x9a,0x47,0x90,0xc9,0xef, + 0x4,0x4a,0x24,0xaf,0x85,0xd6,0x8,0x62,0xbe,0xb6,0xcb,0x4c,0x9b,0x66,0x71,0xcd, + 0xae,0xfd,0xc0,0xa2,0x6,0x21,0x30,0xb4,0xb,0xaf,0x8b,0x8b,0xef,0x34,0x76,0x19, + 0xd6,0x7d,0x39,0x57,0xb2,0xac,0x57,0xcc,0xec,0x57,0xf0,0x22,0x32,0x44,0x25,0x2a, + 0x62,0xe3,0x5a,0x7b,0x39,0x3a,0x1a,0x2e,0xc8,0x40,0x38,0x25,0x66,0x61,0x9c,0xc0, + 0x72,0x48,0xa8,0x32,0x4,0x99,0xe1,0x64,0xc3,0xfc,0xdb,0x7,0x7f,0x80,0xd2,0xb7, + 0xae,0xf2,0x9f,0x62,0x6c,0xb0,0xf,0xf8,0xa5,0xf8,0x6d,0x4e,0xa0,0xaf,0xc5,0xb9, + 0xa0,0x6f,0x84,0x92,0x2f,0xf7,0x2b,0xcf,0x45,0x74,0x39,0x87,0xfc,0x2b,0x7,0x3b, + 0x6d,0x4d,0x22,0xca,0xc0,0x1a,0x43,0x2f,0x1,0x60,0xf1,0xa2,0x58,0xb9,0x97,0xd4, + 0x6c,0x89,0xc9,0x9e,0x84,0x95,0xa6,0x3f,0x37,0xf4,0x5e,0xe0,0xa4,0x0,0x21,0x50, + 0xfd,0x8f,0xbe,0x4b,0xf1,0xe4,0x38,0xc2,0x4f,0x63,0xcd,0x2,0xca,0x33,0x74,0xbe, + 0xe5,0x83,0x5c,0xab,0x81,0xe8,0x2e,0x2f,0xf0,0xd1,0x51,0x9f,0x2e,0xea,0x16,0x64, + 0xf2,0x5b,0xf1,0xf9,0x64,0x98,0xd6,0x93,0xd0,0xb9,0xfb,0xf7,0x27,0xa7,0x8a,0xfe, + 0x7c,0xfa,0x95,0xc7,0x66,0x5b,0x81,0x8f,0x4a,0x2b,0x9e,0x4,0x3a,0x7a,0x33,0x76, + 0x18,0xb1,0x51,0xd0,0x75,0xdf,0x1a,0x62,0xaa,0xc4,0xc4,0xb4,0x3c,0x17,0x51,0x26, + 0xd0,0xd8,0x30,0xe4,0xe9,0x28,0x57,0xb2,0x8d,0x60,0x57,0x30,0x8b,0x15,0x1f,0x26, + 0xc3,0xb4,0x56,0xf7,0x74,0xfd,0xc5,0x68,0x52,0x90,0xa9,0x76,0xbf,0x72,0xdf,0x44, + 0x4b,0xd0,0xd1,0x22,0x10,0x62,0x78,0x4c,0xbf,0xca,0xec,0x9,0x39,0x20,0x1a,0x97, + 0xdf,0x1a,0xd,0x55,0x36,0x89,0x34,0xab,0x54,0x13,0x5a,0xe4,0xcd,0x9,0x34,0xca, + 0xaa,0x21,0xb5,0xe9,0x28,0x25,0xc0,0x28,0xc8,0xcb,0xb4,0xcb,0x2,0x60,0xd8,0x67, + 0x5c,0x36,0xe5,0xa4,0xb7,0x63,0xd8,0x63,0xde,0xac,0x47,0xaf,0x2b,0x6a,0xaa,0x68, + 0xdb,0x80,0x10,0x18,0xda,0x86,0x6b,0xcc,0x9c,0x77,0xb7,0xa3,0x90,0xad,0x55,0xf2, + 0x4c,0xf8,0x55,0x5a,0x2e,0xd5,0xc8,0x3a,0xe8,0x54,0xa0,0x40,0xe3,0xa2,0xd1,0xf0, + 0xfa,0x84,0xbe,0x32,0xed,0x7c,0xb5,0x30,0xf9,0x79,0x45,0x2b,0x28,0x27,0xbd,0x4d, + 0x61,0x28,0x51,0x4a,0xa2,0xde,0x35,0xfc,0x6d,0xe0,0xa4,0x3,0x21,0x30,0xf8,0x2d, + 0xf5,0x7,0x6,0x43,0xc5,0x10,0xbb,0x90,0xda,0x42,0x50,0xd5,0xb0,0x78,0x98,0x17, + 0x88,0x3e,0x62,0xa,0xb8,0xc7,0x40,0x71,0x74,0x54,0x5a,0xfa,0xd,0x7,0x1d,0x2d, + 0xce,0x88,0x28,0x9f,0x84,0xe6,0x3d,0x53,0x54,0x43,0xa5,0xd8,0x99,0xd4,0x44,0xff, + 0xdf,0xce,0xbf,0x43,0xb,0xb7,0xae,0x56,0x3e,0x59,0xf5,0xde,0xbe,0x35,0x78,0x76, + 0xc,0xc3,0xa3,0x58,0x8b,0xae,0xdc,0x82,0x4c,0x1e,0x79,0x46,0x26,0xc9,0xe4,0xd3, + 0x51,0x5d,0x62,0xd,0xd8,0xae,0x78,0xe5,0x85,0x15,0x45,0x47,0x55,0x6,0x41,0x26, + 0xbf,0xe,0x5a,0xfe,0xaa,0x5a,0x65,0xfe,0x45,0x84,0x9d,0x89,0x22,0x35,0xdc,0x36, + 0xf8,0x96,0xf2,0x8a,0xb5,0x17,0x38,0x12,0x2,0xc0,0xe0,0xbb,0xf1,0xd5,0xf8,0xd6, + 0x2c,0x76,0x58,0x33,0x68,0x54,0xb,0x3e,0xf6,0xf0,0xd3,0xa0,0xd8,0xee,0x44,0x77, + 0x86,0xe8,0xaf,0x3,0xf5,0xd1,0x51,0x57,0xe4,0x94,0xc5,0xe4,0x22,0xb2,0xc0,0x22, + 0xb4,0xd0,0x22,0x29,0x27,0xa3,0x19,0x62,0x28,0x39,0xc0,0xe2,0xa7,0x27,0x5e,0x5b, + 0xdc,0x6c,0xed,0xb6,0x4,0x21,0xa2,0x99,0x37,0xa8,0x1f,0xc7,0x37,0x27,0xb1,0xd3, + 0x39,0xa,0xaa,0x2c,0x2,0x82,0xc,0xf9,0x61,0x48,0xbe,0xe3,0x3e,0x4e,0x9,0x4a, + 0xda,0xe0,0xd4,0x48,0x5d,0x74,0x94,0x8b,0x84,0xee,0x2c,0xb0,0x35,0x0,0xf4,0x5f, + 0xe4,0x5a,0xfd,0x8d,0xef,0x4e,0x4c,0xd6,0xc6,0xb0,0x7e,0xf9,0xc1,0x13,0x2d,0xc6, + 0x44,0xcb,0x41,0x88,0xbd,0x93,0x5d,0xaf,0x30,0xed,0x8a,0x71,0xc,0xe6,0x88,0xfd, + 0x79,0xbe,0x0,0x15,0x18,0xf7,0xf2,0x65,0x88,0xd2,0xba,0x1a,0xb7,0x40,0xa3,0x4, + 0x74,0x94,0x5e,0x56,0xcd,0x95,0x5,0x16,0x9,0x40,0x4,0x7f,0xaa,0x45,0x18,0xf8, + 0x59,0xef,0xdf,0x9b,0x5c,0xe4,0xe5,0xa8,0x7a,0x45,0x99,0x2d,0x4b,0x6d,0x3,0x42, + 0x60,0xfb,0x91,0xfa,0xaf,0xc6,0x8b,0xc7,0x0,0x63,0x4d,0x18,0xaa,0x12,0x21,0x57, + 0x4,0xdc,0xc2,0x4,0x9c,0xec,0xe6,0x85,0x6f,0x61,0x17,0x9,0x1d,0x55,0xc8,0xe2, + 0xa,0xe6,0x2f,0x3d,0xb,0x8f,0x81,0xad,0x2c,0xe1,0x4f,0x6e,0x4f,0x24,0xfd,0xea, + 0x59,0xbc,0x6a,0xe7,0x83,0xc0,0x29,0x1,0x42,0x60,0xd7,0x23,0x95,0x57,0x9a,0x3d, + 0xbe,0x55,0xec,0x2a,0x21,0xa,0x4a,0x73,0xb8,0xa2,0x0,0x5a,0xc4,0xfc,0x1a,0xde, + 0x39,0x44,0x20,0x1d,0xe5,0xc9,0xa8,0x74,0xc1,0x96,0xe2,0xf2,0xbd,0xfc,0x52,0x4c, + 0x19,0x97,0xe7,0x7d,0xc9,0xa1,0xbe,0x5a,0xbf,0xb9,0x8c,0x71,0x86,0x6d,0xb,0x42, + 0x60,0xc7,0x9d,0xea,0x35,0xe6,0x10,0xb6,0xc3,0x4,0xc,0x8b,0xf7,0x91,0xc2,0x4f, + 0x91,0xfc,0xf1,0x30,0xbb,0x79,0xe1,0x5f,0x7b,0x9e,0xa2,0xa3,0xae,0x7e,0x89,0xd0, + 0x65,0x3b,0x8b,0xce,0xf7,0xc2,0x92,0x85,0x72,0x61,0x79,0x10,0x4f,0x24,0x5,0x9a, + 0x3f,0x1e,0xba,0x11,0x38,0xa5,0x40,0x8,0xec,0xfc,0x67,0xfd,0x26,0x53,0x93,0x39, + 0x94,0x9c,0xe9,0xd1,0xd2,0x2f,0x45,0x15,0x1a,0xf,0xcb,0x1,0x22,0xc0,0x8d,0xa8, + 0xa2,0xd6,0xb9,0xf7,0xc5,0x40,0x49,0x2b,0x91,0xa,0xfa,0x34,0x8a,0xfb,0x64,0x5b, + 0xb1,0x1d,0x49,0xd6,0xc7,0x40,0xbf,0x77,0xe8,0xaf,0x16,0xee,0xd5,0x54,0x16,0xee, + 0xa9,0x87,0x6e,0xc4,0x75,0xa6,0x26,0xb3,0xaf,0x39,0x1a,0x71,0x21,0x36,0x55,0xe0, + 0x3d,0x59,0x87,0xd,0xbb,0xa6,0xd2,0xd0,0x30,0x53,0x56,0xc1,0x9a,0x4f,0x90,0xc9, + 0x93,0x5,0x16,0x17,0x3,0xcb,0x95,0x5b,0x7c,0xf7,0x8f,0xa6,0xc5,0xc0,0xff,0x37, + 0xf4,0xc1,0x5,0x3c,0xf5,0x5a,0x6b,0xd6,0xa7,0xb7,0xea,0xfd,0x7d,0xc7,0xf0,0xcb, + 0xf1,0xed,0x71,0x74,0x63,0x15,0x24,0x96,0x7c,0x31,0x6,0xbf,0xd4,0xaa,0x2f,0xf2, + 0x9e,0xd0,0x5e,0xc,0xd7,0x54,0x6d,0x1b,0xa2,0xee,0x41,0x86,0x59,0xad,0xf8,0xa2, + 0xf3,0xbd,0xa2,0x32,0xc1,0x8c,0x67,0x9d,0x29,0xce,0x3,0x50,0x1f,0x1b,0x7c,0x27, + 0x70,0xca,0x82,0x10,0xa8,0xfe,0xa8,0xf,0x78,0x41,0x7c,0xfb,0x28,0x20,0x9a,0x43, + 0x13,0x76,0xbf,0xd4,0xee,0x96,0xd,0xd6,0xcd,0x5b,0x67,0x13,0xa,0x44,0x38,0x17, + 0x48,0x3,0xb3,0x4e,0x7d,0x16,0x0,0xa2,0x30,0xc1,0x5,0x2d,0xa1,0xa1,0x59,0x62, + 0xe3,0x8,0x76,0x24,0xa2,0xa0,0xfe,0xdc,0xe0,0xef,0xb7,0xb6,0x3e,0xa6,0xed,0x40, + 0x8,0x54,0xff,0xbd,0x6f,0x19,0xae,0x34,0xa3,0x61,0x64,0x75,0x1b,0x96,0x55,0xd8, + 0x56,0x3e,0xc,0xf3,0x0,0x11,0x82,0x75,0x7,0x29,0x7b,0xc2,0xd7,0x2b,0x58,0xc, + 0x0,0xcb,0x81,0x60,0xf1,0x26,0x54,0x5a,0x8e,0x49,0x11,0xd1,0xaf,0x9e,0xfb,0xdb, + 0xc3,0xf5,0x85,0xc6,0xc0,0x82,0x83,0x10,0xa8,0x7e,0xbf,0x6f,0x3d,0x9e,0x19,0xdf, + 0x3e,0x86,0x59,0xf4,0x89,0x46,0xe1,0xe6,0x85,0x64,0xbb,0xc3,0x90,0x3,0x1a,0x1d, + 0x15,0xe9,0x5a,0xd1,0x3c,0x0,0x2c,0x4b,0xd9,0x5c,0x88,0xcc,0x1e,0x0,0xe,0x60, + 0x28,0x79,0xf4,0xb7,0x2b,0xbf,0x79,0xdf,0xec,0xc2,0x23,0xa0,0xb2,0xf0,0x2f,0x1, + 0x7a,0xf0,0xf,0xf1,0x59,0xe7,0xf5,0xaa,0x6d,0xb6,0x6c,0x19,0x50,0x76,0x83,0xdf, + 0xae,0x2d,0xb5,0xab,0x61,0xf8,0x65,0x3f,0xed,0xd7,0x15,0x36,0xf5,0xac,0x78,0x8, + 0xb6,0xa2,0x44,0x9b,0xdb,0xf6,0xa6,0x20,0x88,0xef,0xd4,0x7f,0xbd,0xd8,0x65,0xaf, + 0x17,0x33,0x8,0x81,0x68,0xf0,0x2d,0xf8,0x68,0x12,0x86,0xdb,0x3,0x46,0x5,0xa3, + 0x85,0x5f,0x7b,0x16,0x57,0x11,0x81,0xf5,0x22,0x1c,0x70,0x14,0xbb,0x76,0x13,0x35, + 0x49,0x46,0xe2,0x4,0x16,0x6f,0x2e,0xb4,0xe,0x9e,0x61,0x7f,0xb7,0x1b,0xbb,0x93, + 0x3b,0xbe,0x19,0xfd,0xda,0xf0,0x54,0x7b,0x5c,0xda,0xbb,0xd0,0x26,0x5b,0xf5,0x8e, + 0x35,0x5d,0xea,0xf9,0xf1,0xed,0x49,0x9c,0x40,0x3f,0x2a,0xa5,0x89,0x32,0x2e,0xd2, + 0x99,0x95,0x92,0x96,0xab,0xa3,0x82,0x74,0x4,0x29,0xeb,0x82,0x8a,0x80,0xb,0x1f, + 0xe9,0x16,0x52,0x13,0x1d,0x4a,0x5b,0xf3,0x37,0xad,0x7d,0xcd,0x23,0x33,0xed,0x72, + 0xee,0xb7,0xd,0x8,0x81,0xb1,0x7f,0xeb,0xd3,0xf1,0x54,0xb6,0x18,0x86,0xaa,0x24, + 0x51,0xa6,0x1c,0x18,0x16,0xb,0x51,0x38,0x57,0xe2,0xa5,0x2d,0x7d,0x79,0xc3,0x72, + 0xbb,0x44,0xb3,0xb2,0x7,0x3e,0x3f,0x9e,0x9e,0x69,0xf4,0xe9,0xa1,0x37,0xed,0xaf, + 0xb5,0xcf,0x99,0xdf,0x46,0x20,0x4,0xaa,0xff,0xbe,0xe6,0x88,0xba,0x3a,0xfe,0x46, + 0xa6,0x50,0x45,0x3f,0xba,0x4b,0x31,0x2b,0xf2,0x80,0xb0,0xb5,0x91,0xd2,0x7,0x44, + 0xc5,0x9a,0x12,0x59,0x0,0x58,0x16,0x4,0x5b,0x67,0x4c,0xa4,0x32,0x1d,0x3c,0x92, + 0xec,0x94,0x0,0x3e,0x31,0xf8,0x36,0x44,0xed,0x74,0xde,0x57,0xd0,0x56,0xdb,0xd0, + 0xc7,0xd5,0xef,0x99,0x1f,0xd0,0x9,0xdc,0x8f,0xe3,0xb,0xa2,0xa4,0xb5,0xfe,0xaa, + 0x2e,0x95,0x47,0x4c,0xb8,0x29,0xb2,0x5f,0xc2,0x2f,0x9,0xb5,0x3a,0xd2,0x2d,0x54, + 0x1c,0x9c,0xc6,0xcf,0xd3,0x4b,0x2f,0x7c,0x78,0xf0,0xf,0xda,0xb,0x82,0x6d,0x7, + 0x42,0x60,0xe7,0x3f,0xe0,0xd,0x66,0x69,0xf7,0xc,0xb6,0x99,0x7d,0x4f,0xb,0xf6, + 0x75,0x16,0x5,0x60,0x95,0x9,0x86,0x34,0xb8,0xb8,0x61,0xbe,0x59,0x35,0xcf,0xf2, + 0x2e,0x3d,0xb,0x63,0x5a,0x9c,0xc0,0xcf,0xd3,0x97,0xf0,0x3f,0x1f,0xfc,0x13,0xb4, + 0xdd,0x56,0x69,0xbf,0x97,0x34,0xf8,0x25,0xbc,0xd6,0x6c,0x74,0xaa,0xe3,0x41,0xc1, + 0x9c,0xd2,0xc5,0xb3,0x65,0x35,0xb9,0x29,0x90,0x29,0xc2,0x94,0x28,0x27,0xdf,0x6b, + 0x5f,0xf7,0x8f,0x3b,0xba,0x8a,0xfb,0x93,0xcb,0x5d,0x6b,0xf5,0xf6,0xc1,0xf7,0xb7, + 0xe3,0x19,0x51,0x69,0xc7,0x17,0x35,0x78,0xab,0x7a,0xa1,0x49,0xe4,0x35,0xb6,0xa7, + 0x8a,0x8d,0xda,0x9b,0x90,0xb6,0xa,0xa2,0xb6,0x26,0xea,0x8e,0x81,0xb,0xdb,0xb9, + 0xd0,0xda,0x6d,0x3f,0x1e,0x4c,0x8e,0x8a,0x99,0xc6,0x1b,0x5a,0x3b,0x43,0x6d,0x91, + 0x83,0x10,0xd8,0x79,0x97,0x7a,0xe,0x1e,0x37,0xf7,0x3c,0x81,0x47,0xda,0x8a,0xca, + 0xab,0x5,0xb9,0x97,0x83,0xe1,0xa9,0x8,0x33,0xd7,0x36,0x9c,0xf6,0x99,0x47,0xf5, + 0x4b,0x7,0xbf,0xd8,0xae,0xaf,0xb6,0xd2,0xae,0x2f,0x6c,0xe7,0xe,0xfd,0x8b,0xb8, + 0xdb,0xdc,0x73,0x18,0xdb,0x30,0x7b,0xca,0x9f,0x5e,0x2a,0x8,0xd0,0x8b,0x9d,0x9e, + 0x67,0xd9,0xea,0x78,0x38,0xdd,0x22,0xbe,0x3,0xcf,0x1e,0xfa,0x8f,0xf6,0xfd,0x4, + 0x2a,0xed,0xfb,0xd2,0x86,0xe,0x46,0xcf,0xd7,0x37,0x99,0x7b,0xc6,0x70,0x4f,0x72, + 0x36,0xd6,0x49,0xb9,0xe9,0xa0,0x7b,0xf5,0x49,0xfe,0x7e,0x43,0xb7,0x49,0xdc,0x9b, + 0x5c,0x53,0x2,0xea,0xc7,0xea,0x8a,0xc1,0xc7,0xdb,0xf9,0x13,0xe8,0x6a,0xe7,0x17, + 0x37,0x56,0x1b,0xbb,0x35,0xd9,0xea,0x54,0xc7,0x41,0x74,0xe1,0xb4,0xc2,0x8a,0xb7, + 0x51,0x8a,0x53,0xd8,0x3a,0xf,0x12,0x50,0xa9,0x93,0x58,0xe3,0x54,0xde,0x46,0xb0, + 0xd,0xa9,0x5a,0xb4,0x5b,0x67,0x7e,0x7d,0x57,0x9b,0x5f,0xb9,0xbb,0xda,0xfd,0x63, + 0xad,0xde,0xb9,0x66,0x9f,0xba,0x3a,0x8e,0xd8,0x1a,0xa3,0x98,0x6c,0x54,0xd2,0xe4, + 0x5,0xe1,0x62,0x80,0x19,0xb5,0xf2,0x92,0x4a,0x99,0x14,0x3a,0xd9,0x21,0xe7,0x0, + 0xe2,0xe2,0x84,0xa8,0xf4,0x55,0xef,0xc2,0xa3,0xa9,0xb9,0xbd,0xfa,0x6f,0x87,0xae, + 0x1b,0x6f,0xfb,0x1c,0xa6,0xd2,0xfe,0x5f,0xc1,0xd0,0xf5,0xfa,0x95,0xc9,0x21,0xc9, + 0x7,0x70,0x1f,0xa6,0xda,0xf8,0x24,0xd3,0x99,0xef,0x95,0xc3,0x47,0x37,0x1,0xa7, + 0x89,0xfb,0x79,0x20,0xea,0x52,0x5e,0xf7,0xc2,0x6f,0xb3,0xb8,0x1f,0x3b,0x93,0xaf, + 0xb1,0xa6,0x7e,0x6f,0xe8,0x1d,0xed,0x66,0xcc,0x2f,0x52,0x10,0x2,0x43,0xdf,0x88, + 0x9e,0xa1,0x1e,0x31,0xf7,0x8c,0xe3,0xee,0xe4,0x82,0x8e,0x6d,0x4,0x24,0x14,0xe, + 0x41,0x4d,0x42,0x4c,0x1b,0xff,0xf1,0x47,0x15,0x9,0xc3,0xb2,0x3e,0xaf,0xfc,0xf0, + 0x3e,0x66,0x9f,0xf,0x47,0x70,0xf5,0xce,0x4f,0x2d,0x8e,0x48,0x5f,0x59,0x1c,0x2f, + 0x73,0xf8,0xd1,0xfa,0x73,0xf1,0x8d,0xf4,0x95,0x6f,0xb8,0x8d,0x4,0x81,0xfc,0x27, + 0xb9,0xe,0x0,0x20,0x1a,0x30,0x84,0x15,0xf,0x75,0x86,0xc7,0x5c,0xec,0x91,0x72, + 0x3f,0x7e,0x9a,0x62,0x46,0xea,0xc7,0x95,0xa7,0xd,0x7e,0x6f,0xb1,0xd0,0xed,0xae, + 0xc5,0xf2,0x42,0xc7,0xa6,0xaa,0x5f,0xee,0x9b,0xc4,0x2f,0x99,0x97,0x8d,0x51,0x1c, + 0xc5,0xda,0x8c,0x5,0xde,0x65,0x89,0x32,0xc5,0xe4,0x7b,0xae,0x2c,0x50,0x11,0x26, + 0x7d,0x1a,0x92,0x79,0xe2,0xe1,0x42,0x44,0xca,0xec,0x8f,0x54,0xc7,0x23,0x69,0x1a, + 0xa,0xfd,0xf,0xcb,0xae,0x79,0xac,0x8a,0x45,0xb3,0x55,0x16,0xcf,0x4b,0x85,0x1e, + 0xfc,0xb0,0x7a,0x79,0xb2,0x1e,0x77,0x4,0x3f,0x4a,0x9,0xd2,0xe5,0x9f,0x14,0xba, + 0xf0,0xfb,0x74,0x40,0x4,0x8c,0xc9,0x28,0x12,0x74,0x54,0xa7,0x8e,0xf1,0x47,0xbe, + 0xe2,0xf3,0xc6,0xd6,0x43,0xf4,0x28,0x7e,0x94,0xea,0x14,0xc4,0x94,0xbe,0x6e,0xe8, + 0xad,0xf,0xcd,0x2c,0xa2,0xf3,0x7a,0x51,0x81,0x10,0xc0,0xce,0x3b,0xf0,0x34,0xdc, + 0x93,0xa6,0xa5,0xf,0xa0,0x56,0xe8,0xd7,0xab,0x5b,0x78,0x1f,0x7,0x10,0xee,0x18, + 0x93,0x8c,0xda,0xb0,0xe4,0xe2,0xa1,0xec,0x79,0xca,0x25,0xac,0x52,0x32,0xab,0xc5, + 0xdf,0xd2,0x10,0xee,0x46,0x6a,0x59,0xf9,0x3d,0x78,0xde,0xd0,0xa7,0xb1,0xc8,0xb6, + 0xca,0x62,0x7b,0xc1,0x83,0xbb,0xa3,0xe7,0xe1,0x33,0xc9,0x7d,0xfb,0xf0,0x63,0x8c, + 0xb7,0x69,0x4e,0xe7,0xa6,0x84,0xb2,0x18,0x68,0xb,0x32,0xb4,0x3a,0xaa,0x49,0x70, + 0xba,0x9f,0x2f,0x4b,0x3c,0x6c,0x7d,0xa4,0xb4,0xb7,0x49,0xdc,0x63,0x8f,0x40,0xf9, + 0x37,0xf5,0x8c,0xc1,0x7b,0xb0,0xe8,0xb6,0xae,0xc5,0xf7,0x92,0xc7,0x6a,0xd5,0xaf, + 0xf7,0x1d,0xc6,0x8b,0xd0,0x6d,0xc6,0xc3,0x27,0x50,0xc1,0x1a,0xe7,0xda,0xb6,0xb2, + 0xf1,0x16,0x65,0xe4,0x7b,0x21,0xd3,0xd6,0xf8,0x2c,0x10,0xc4,0x64,0x35,0xfb,0x14, + 0xd7,0x24,0x79,0xcd,0x6,0xc4,0x76,0x80,0x21,0xfd,0x17,0x4f,0xe0,0xbe,0x74,0xc, + 0xac,0xe3,0x2f,0x6,0xdf,0x52,0x3d,0xe,0x74,0x40,0xd8,0xa2,0xad,0x7a,0xcf,0xda, + 0x7f,0xc1,0x95,0x38,0xc3,0xfc,0xb2,0x46,0x50,0xc5,0x3a,0x74,0xa3,0xf5,0xc3,0x7f, + 0x5d,0x40,0x83,0x78,0xbf,0x4,0x80,0x74,0xb9,0x76,0x52,0x2f,0xd5,0x4c,0x4,0xf5, + 0x1,0x31,0x8c,0x96,0xea,0x96,0x4b,0x3b,0xf3,0x7f,0x3d,0x8b,0x7,0xec,0xa5,0x65, + 0x77,0xe1,0x57,0x7,0x3f,0xbf,0x58,0xcb,0x85,0x16,0x29,0x8,0x81,0xea,0xa1,0xfe, + 0xcf,0xea,0x1e,0x3c,0xd7,0x3c,0x2b,0x27,0xb1,0xa7,0x51,0xd4,0x56,0xec,0x8a,0xf5, + 0x59,0x94,0x4d,0x17,0xd0,0x43,0x0,0xe8,0x1a,0x84,0x9f,0x3e,0x3d,0xd3,0x2,0x8d, + 0x76,0x2,0xb1,0xcc,0x78,0x58,0x5e,0xa4,0x3c,0x84,0x9f,0x62,0x2c,0xb5,0x4f,0xdd, + 0x52,0x7b,0xf9,0xf0,0x76,0x2c,0xda,0xad,0x6b,0xf1,0xbe,0xf4,0xd1,0x7a,0xf5,0x7b, + 0x7d,0x3f,0xc4,0x8b,0xb0,0x3a,0xde,0x17,0xe1,0x30,0x46,0xd1,0x87,0x25,0x8,0x5f, + 0x8b,0xa2,0x68,0xb2,0x29,0x8d,0xb5,0x6e,0x0,0xc2,0xb1,0x1c,0x36,0x58,0x18,0xd2, + 0x2,0x8d,0xdf,0xbc,0x28,0x4e,0x47,0x2d,0x22,0x1a,0xa6,0x8f,0x9b,0xc6,0x83,0x78, + 0x2c,0x2d,0xc2,0x8d,0xab,0xb7,0xef,0xfc,0x93,0xa3,0x53,0x40,0x7,0x84,0xb,0x15, + 0xf,0x7,0xd7,0x7f,0xbe,0x7e,0x81,0xba,0x30,0x99,0xb2,0xef,0x41,0x84,0xb5,0x8d, + 0x71,0x89,0xae,0x68,0xd8,0xea,0x55,0x28,0x6c,0x60,0x4a,0x0,0x48,0xad,0x33,0xa1, + 0x8,0x3a,0x9a,0x8e,0x84,0x9a,0x1,0x22,0xa,0x5,0x62,0xf1,0x84,0x95,0xdb,0xf6, + 0xe2,0x1e,0x2b,0x6,0xe2,0x27,0xea,0xaa,0x9d,0xdf,0xc5,0x22,0xdf,0xba,0x16,0xfb, + 0x1b,0x18,0x99,0x18,0xfb,0xf2,0xda,0x21,0xbc,0x14,0xbd,0xe6,0x57,0x3c,0x8a,0x83, + 0x38,0xd,0xcb,0xc4,0x20,0xcc,0x46,0x36,0x91,0xc3,0x78,0x97,0x3,0x90,0x5e,0x26, + 0x94,0xa2,0xa3,0x76,0x24,0xd4,0x5,0x67,0x88,0xc5,0xc5,0x43,0x1d,0x4,0xcc,0x9, + 0xdc,0x8b,0xc1,0x74,0x1e,0x58,0xc3,0x5f,0xf6,0x5d,0xfb,0xd0,0x11,0x2c,0xfa,0xed, + 0x24,0x69,0xc4,0xde,0x74,0x61,0xe5,0xb,0x78,0x46,0xfa,0xad,0xd,0xe0,0x42,0x74, + 0x39,0x28,0x69,0x6b,0x16,0x3e,0xb,0x5d,0xfc,0x85,0x5f,0x71,0x49,0xb1,0x10,0x4c, + 0xc3,0x90,0xfa,0xa9,0x9,0x83,0x5f,0x3b,0x6e,0x53,0x7b,0xf8,0xbd,0xe1,0xfb,0xe9, + 0x57,0x80,0x94,0xd,0xa3,0xa1,0xb1,0x3,0xdb,0x61,0xad,0xda,0xb2,0x23,0xba,0x76, + 0xf8,0xc7,0x27,0xc7,0xd9,0xdb,0x75,0x72,0xbc,0x8d,0xb1,0x23,0xd5,0xcf,0xac,0x19, + 0x57,0x57,0xa2,0x27,0x41,0x56,0xf1,0x4,0x56,0x62,0xa5,0x7,0x84,0x65,0xe6,0x7b, + 0x12,0x19,0x86,0xbb,0x25,0x59,0xee,0xc5,0xa6,0xa3,0x94,0x75,0xaf,0x5,0x19,0x22, + 0x15,0x11,0x43,0x89,0x69,0x28,0x2d,0x95,0x90,0xd2,0x2a,0xee,0xc6,0xde,0xf4,0x91, + 0x35,0xfc,0xe5,0xcc,0x6b,0x77,0xf,0xe3,0x24,0xd9,0x4e,0xaa,0x91,0x24,0xe7,0x6e, + 0xee,0xfa,0x7b,0xbc,0x34,0xbd,0x77,0x3d,0x2e,0xc1,0x6a,0x84,0xb6,0xf5,0x96,0x15, + 0x3,0x25,0xb,0x82,0xba,0x62,0xa0,0x8c,0x8e,0x26,0xb,0xdb,0x60,0x45,0x9e,0xfc, + 0x11,0xb1,0x8c,0x78,0x98,0x8e,0x84,0x13,0x78,0xc,0xbb,0x6d,0xa8,0xfe,0x1c,0xbf, + 0xb3,0x18,0x2d,0xf9,0x93,0x3e,0x12,0xce,0x6d,0x47,0xc7,0xaa,0x37,0xae,0x79,0x58, + 0xfd,0x12,0x96,0x27,0xf3,0x89,0x61,0x4c,0x61,0xad,0xe5,0x20,0x86,0x9b,0xb,0xf2, + 0x7c,0xaf,0x88,0x2c,0x30,0x4,0x82,0x1c,0xc,0x35,0x11,0x29,0x8b,0x89,0x88,0xba, + 0xc4,0xbc,0x51,0x3,0x88,0x30,0x88,0x7b,0xec,0x89,0xb3,0x93,0xf8,0xdf,0x7d,0xd7, + 0x3e,0xbc,0x7,0xe8,0x80,0xb0,0x9d,0x89,0xe9,0xc3,0x6b,0x3f,0xa7,0xce,0xc4,0x65, + 0xa9,0xbd,0xd8,0x85,0x2e,0xf4,0xe5,0x5c,0xa1,0x30,0xf,0x9,0x95,0x1,0x50,0x91, + 0x82,0xc,0x58,0x8,0x2a,0xb,0x5c,0xb4,0x55,0x41,0x3b,0x87,0x28,0x5,0x88,0x59, + 0x74,0xd4,0xf4,0xb6,0x1f,0x3f,0xc6,0x5e,0xbb,0x1f,0xf7,0x3f,0xf4,0xcb,0x87,0x6e, + 0xdd,0x1f,0x9d,0x6c,0xe7,0xec,0x49,0x3a,0x21,0x6f,0xe0,0x65,0xf8,0x24,0x36,0xa6, + 0xf7,0xae,0xc2,0xa5,0x38,0xc3,0x3,0xc2,0x22,0x0,0x98,0x8d,0x82,0x4a,0x4,0x19, + 0x7e,0xd5,0x9,0x4d,0xc2,0xd0,0x2f,0xd0,0xc0,0x41,0x1a,0xcb,0x20,0xa6,0xae,0xa3, + 0xe7,0xee,0x3b,0x8a,0x9f,0x83,0x90,0x3c,0xc7,0xd4,0x7b,0x76,0x5e,0x7f,0x72,0x8e, + 0xd0,0xe9,0x3a,0x39,0x41,0x58,0x7d,0xfc,0xf4,0x4f,0x47,0xcb,0x71,0x79,0xf2,0xfd, + 0xcd,0x60,0xf,0x8e,0x62,0x2d,0x7a,0x2,0x6b,0x66,0xe4,0x24,0x34,0x2c,0x2,0x2a, + 0x20,0x48,0x90,0x51,0x9e,0xab,0x67,0x9a,0x90,0x4a,0x4,0x1a,0x97,0x81,0x5f,0x6, + 0x31,0xd5,0x4e,0x1c,0x4d,0x61,0x1b,0xee,0x4f,0x57,0x85,0x2,0x5a,0xdd,0xa8,0x7e, + 0x75,0xe7,0x7f,0xe0,0x24,0xdd,0x4e,0xea,0x59,0xb1,0x3,0xe7,0xe3,0x23,0x78,0xb9, + 0xfd,0x96,0x37,0xe2,0xa2,0x86,0x66,0x5a,0xd4,0xb2,0xd6,0xe1,0x11,0x90,0x16,0x87, + 0x5c,0x31,0x90,0x6,0xa3,0x7d,0xe2,0xfb,0xad,0xa,0x78,0xe5,0x99,0xe2,0x22,0xa2, + 0x74,0x2f,0x30,0x8d,0xc7,0xf1,0x38,0xd5,0x94,0xf6,0x53,0xf5,0xce,0x9d,0x77,0x9d, + 0xcc,0xe7,0xe9,0x49,0x3f,0xb0,0x79,0xe0,0xc5,0xf8,0x1b,0x5c,0x9c,0xde,0x5b,0xc1, + 0xb9,0xb8,0x18,0xcb,0x4b,0x24,0xa1,0x10,0xfb,0x82,0xf0,0x92,0x51,0x64,0xa6,0xa3, + 0xf0,0xc0,0x90,0x7,0x62,0x71,0x9a,0xa9,0x84,0xae,0xce,0x62,0x7,0x1e,0x25,0x46, + 0x3b,0xab,0x7d,0x78,0xff,0xce,0x1b,0x10,0x9d,0xdc,0xe7,0x68,0xd7,0xc9,0xe,0xc2, + 0xea,0xe0,0xc0,0xf5,0xd3,0x7b,0xf1,0x9c,0xa4,0x62,0xaa,0x31,0x86,0x1d,0x98,0x68, + 0x50,0xd3,0x32,0x48,0xa8,0xcc,0x17,0xe4,0x49,0x28,0x25,0xc8,0xb8,0xb4,0x51,0xb7, + 0x4d,0x91,0x2e,0x65,0xf3,0x3b,0x87,0xc5,0x49,0x35,0x3e,0xa1,0xa6,0x86,0xed,0xf8, + 0x11,0xf6,0xdb,0x48,0x9b,0xc4,0x5f,0xf7,0xbc,0xe6,0xf1,0x1f,0x9d,0xfc,0xa3,0x54, + 0x4f,0x91,0xa5,0xb,0xce,0x5e,0xdb,0xf3,0x3e,0xf5,0x7,0xf6,0x25,0xa7,0x1b,0x9b, + 0x71,0x31,0x96,0x95,0x48,0x42,0x11,0xec,0xa,0xba,0x4,0x19,0xe5,0xf9,0xd2,0x64, + 0x30,0x2c,0x3b,0x22,0xca,0x89,0xe9,0x2c,0x6,0xf1,0x30,0x3d,0xbe,0xf2,0xb6,0xfa, + 0xdb,0x77,0xd,0x9d,0x1a,0x67,0xe7,0x29,0xb4,0x7e,0xc8,0xe6,0xcb,0xd4,0x5f,0xe3, + 0x85,0xf6,0xfe,0x1e,0x5c,0x80,0xb,0xb0,0x74,0x81,0x1,0x98,0xee,0xee,0x80,0xd7, + 0x21,0xe4,0xe9,0x28,0x1c,0x25,0x60,0x32,0xa5,0x14,0xde,0xf2,0xb2,0xfc,0x40,0x9c, + 0xc5,0xe3,0x78,0x84,0x6,0xe0,0xbd,0xfa,0x5d,0x43,0xff,0x79,0xea,0x9c,0x99,0xa7, + 0xd8,0x22,0x3e,0x3,0x57,0xaa,0xbf,0xd0,0xcf,0xb7,0xf7,0x57,0xb0,0x9,0x17,0x63, + 0x4d,0x8e,0xca,0x97,0x70,0x23,0x42,0x12,0x3,0x39,0x8,0xfa,0xe8,0xa8,0xcc,0xaa, + 0x8,0xa9,0xa4,0x81,0xa0,0xee,0x53,0x9e,0x21,0x4e,0xe2,0x31,0x6c,0x4f,0xae,0x1e, + 0x38,0xbf,0x3d,0xac,0x3e,0xbc,0xf3,0xc6,0x93,0x3d,0xb,0x3c,0xa5,0x41,0xd8,0x90, + 0x6a,0xfe,0x37,0x9e,0x49,0x7d,0x14,0x4f,0xc2,0x85,0xd8,0x50,0x38,0x0,0xc3,0x48, + 0x28,0xa5,0x89,0xca,0x20,0xc8,0xc3,0xd0,0x6,0xa3,0xd4,0x39,0x2c,0x3,0x88,0x55, + 0x3c,0x8a,0x41,0xbb,0x20,0x1b,0x0,0x86,0xd4,0x87,0x76,0x7e,0x9a,0xbe,0xab,0x3, + 0xc2,0x93,0x11,0x88,0x1f,0xc6,0xd3,0xa9,0x7b,0xd6,0xe2,0x22,0x6c,0x41,0xa5,0x45, + 0x0,0x94,0xc4,0xc0,0xb4,0x35,0x21,0xa5,0xa3,0x3c,0x4,0xfd,0x4a,0x69,0x59,0x40, + 0x3c,0x88,0x7,0xb0,0x97,0xfe,0x4a,0x76,0xa9,0xff,0x7d,0xce,0x67,0xee,0xac,0x9d, + 0x8a,0x67,0xe3,0xa9,0xbb,0xa6,0x64,0x65,0xf3,0xab,0xd5,0xfb,0x70,0x11,0x75,0xd7, + 0x2a,0x5c,0x8c,0xf3,0x1a,0x96,0x7e,0xeb,0x0,0xe8,0x13,0x64,0xf2,0xd0,0x51,0xa9, + 0x40,0x23,0x93,0x67,0x90,0x21,0x43,0xac,0x63,0x27,0x1e,0x4a,0xe,0x8d,0x8d,0xb7, + 0xdd,0xea,0x83,0x6b,0x3e,0x7b,0xef,0x29,0xbb,0xf8,0xe4,0xa9,0xbd,0xb0,0x6b,0x65, + 0xf3,0xeb,0xd5,0x7b,0x71,0x1,0x75,0x57,0x2f,0x6,0x70,0x21,0xd6,0x15,0xea,0x4, + 0xca,0x48,0xa8,0x5f,0x17,0xf5,0xd1,0x51,0x19,0x4,0xf3,0x39,0x87,0x21,0x40,0x1c, + 0xc3,0x63,0xd8,0x81,0x49,0xfa,0x25,0xef,0xd5,0x1f,0xee,0xba,0x7e,0xc7,0xf4,0xa9, + 0x7c,0x1a,0x76,0x56,0x57,0x56,0x3,0x2f,0xc2,0x3b,0xec,0xba,0x9a,0xb9,0x6d,0xd, + 0xce,0xc7,0x85,0x58,0x56,0x30,0x0,0x8b,0x82,0xa0,0xb2,0xc0,0x17,0x16,0x9,0x25, + 0x2,0x8d,0x1c,0x7a,0x14,0x10,0x6b,0x18,0xc6,0xa3,0xd8,0xc7,0x59,0x7d,0xdb,0xd4, + 0xc7,0xeb,0x9f,0x1f,0x9e,0x3a,0xe5,0x4f,0x41,0x74,0x36,0x0,0x5b,0x9f,0xa6,0xdf, + 0xa5,0x5f,0x67,0x4e,0x32,0x8d,0xb7,0x2e,0x9c,0x8b,0x27,0xe3,0x6c,0x36,0x4f,0x2c, + 0x7,0x80,0x34,0x4,0x95,0xf3,0x6b,0xd3,0x1e,0x18,0xf2,0x2,0x4d,0x19,0x19,0xe2, + 0x28,0x1e,0xc3,0x63,0x60,0x11,0x76,0x97,0xfe,0xf0,0xd0,0x6d,0xa7,0xf8,0x9a,0xa6, + 0x1d,0x10,0xa6,0xb7,0x73,0x37,0x57,0xde,0xa9,0xde,0x8c,0x95,0xf4,0xbd,0x7d,0xb8, + 0x8,0xe7,0x63,0x39,0x90,0xc1,0x17,0x94,0xb9,0x82,0x7e,0x5d,0x54,0x79,0xbf,0xb4, + 0x34,0x1d,0x75,0x43,0x30,0x44,0xa0,0x9,0x1,0xe2,0x34,0x1e,0xc7,0xa3,0x38,0xc8, + 0xbd,0xc8,0x19,0xfd,0x25,0xf5,0x91,0xc1,0x7,0x3a,0x67,0x5c,0x7,0x84,0x74,0x44, + 0x5c,0x1d,0xbd,0x9,0xff,0x15,0x67,0x33,0x29,0x24,0x4e,0xc7,0x79,0x38,0xbf,0x51, + 0x73,0x9a,0x17,0x80,0x7e,0x7b,0x9e,0x82,0x20,0xdd,0x49,0xc1,0xd3,0x51,0x9,0xc, + 0xf3,0x57,0xd2,0xa0,0x69,0xc0,0xef,0xc6,0x4e,0xc,0x82,0xd5,0x58,0xc6,0xf5,0x3f, + 0x56,0xfe,0x6a,0xe7,0x9e,0xce,0x99,0xd6,0x1,0xa1,0x1b,0x88,0x4b,0xa2,0x57,0xeb, + 0xeb,0xd4,0xf3,0xb9,0xcf,0xa6,0x82,0x73,0x70,0x3e,0xb6,0x60,0x49,0x1,0x24,0x54, + 0x96,0xd,0xfa,0xec,0x9,0x29,0x1d,0xd,0xcb,0xc,0xc3,0x80,0x38,0x8b,0x61,0x6c, + 0xc7,0xb0,0x63,0x69,0x1e,0xfc,0x54,0xdd,0xd0,0xfd,0xc5,0xc7,0x8e,0x75,0xce,0xb0, + 0xe,0x8,0x85,0xdb,0xc0,0x79,0xf8,0x2d,0xbc,0x19,0xe7,0x70,0xf7,0x77,0x61,0x23, + 0xce,0xc7,0xd6,0xc6,0x98,0xe1,0x3c,0xae,0xa0,0x8b,0x86,0x86,0x40,0xb0,0x78,0x18, + 0xca,0x80,0x58,0xc3,0x30,0x1e,0xc7,0xe,0x38,0x1c,0x86,0x71,0xfd,0xe5,0xae,0x4f, + 0xed,0xb8,0xaf,0x73,0x56,0x75,0x40,0x18,0xbc,0x5d,0xde,0x53,0x7d,0x5,0xae,0xc3, + 0x2f,0xf3,0x6b,0x57,0x75,0x63,0x23,0x36,0x63,0xb3,0x55,0xf0,0x86,0xc2,0x4,0x19, + 0xb7,0x3d,0xa1,0x2c,0x32,0x1a,0xee,0x16,0x66,0x1,0xe2,0xdc,0x6f,0xc7,0x31,0x84, + 0x21,0xc,0xc3,0xb9,0x18,0xe0,0xf,0xd4,0xd,0x93,0xb7,0xec,0x9b,0xe8,0x9c,0x4d, + 0x1d,0x10,0xe6,0xd8,0xce,0xd9,0xd0,0x73,0x2d,0xde,0x8a,0xcd,0xae,0x63,0x4e,0xc3, + 0xb9,0xd8,0x84,0x2d,0xe8,0xd,0x2,0xa0,0x5f,0x90,0x91,0xd8,0x13,0x76,0x5e,0xa8, + 0x3,0x35,0x52,0x5f,0x29,0x5b,0x3a,0xa,0xd6,0x71,0x8,0x3b,0xb0,0x13,0x87,0xdc, + 0xe2,0xe6,0x98,0xbe,0x19,0x1f,0x1f,0xda,0xd6,0x39,0x83,0x3a,0x20,0x2c,0x66,0xeb, + 0xda,0xfc,0xc2,0xca,0x35,0xfa,0x95,0x58,0xeb,0x3a,0xa8,0x7,0xe7,0x60,0x0,0x5b, + 0xb0,0x96,0x4,0x9c,0x3c,0x6,0xfa,0x20,0x18,0x42,0x47,0x7d,0x91,0x90,0x6,0x20, + 0x17,0xf,0x8f,0x61,0x27,0x6,0x31,0xc,0x8f,0xb7,0x7e,0x1c,0xdf,0x50,0x37,0x2f, + 0xfd,0xd6,0x8f,0x3,0x61,0xf7,0x0,0x0,0x2,0xcf,0x49,0x44,0x41,0x54,0xe2,0x5a, + 0x2f,0xb7,0x3,0xc2,0x45,0x42,0x4f,0xc7,0x5e,0xac,0xaf,0xc1,0xaf,0x63,0x8d,0xfb, + 0xb8,0x35,0x38,0x7,0x67,0x63,0x23,0xd6,0x35,0xd6,0xc3,0x8,0x13,0x64,0x38,0x6b, + 0x82,0xae,0x96,0x51,0x44,0xb3,0xad,0x1b,0x86,0x59,0x4,0x9a,0x51,0xec,0xc1,0x1e, + 0xec,0x85,0x77,0xe6,0xfc,0x84,0xfa,0x66,0x74,0xf3,0xec,0x37,0xf7,0x4e,0x76,0xce, + 0x96,0xe,0x8,0x4b,0x8d,0x8a,0x3,0xbf,0xa4,0x7e,0x5b,0xff,0x9a,0xb9,0x1a,0x14, + 0xbd,0xf5,0xe2,0x49,0x38,0x7,0x1b,0xb1,0xb1,0x59,0x87,0x2a,0x17,0x64,0x7c,0x10, + 0xc,0xa5,0xa3,0x1c,0x4,0x5d,0x84,0x34,0xc2,0x11,0xec,0xc6,0x1e,0xec,0xc2,0x51, + 0xff,0xa7,0x32,0x8d,0xef,0xaa,0x5b,0xba,0xbf,0xd6,0x51,0x3f,0x3b,0x20,0x6c,0xd9, + 0xb6,0x69,0x69,0xd7,0xd5,0xfa,0x37,0xf5,0x4b,0x55,0xbf,0xff,0xd8,0xa,0x36,0xe0, + 0x1c,0x6c,0xc0,0x99,0x58,0x8f,0xae,0x40,0x41,0xa6,0xc,0x3a,0xea,0x16,0x68,0x22, + 0x8c,0xe0,0x0,0xe,0x60,0x37,0x9e,0x80,0xa8,0xa6,0xfa,0x38,0xbe,0xa7,0x6f,0xed, + 0xfa,0xfa,0x8e,0xf1,0xce,0x59,0xd1,0x1,0xe1,0x42,0x6c,0x95,0x2d,0x4f,0xd3,0x2f, + 0xc6,0x2b,0xf0,0x1c,0x5e,0x41,0x4d,0xc2,0xb1,0x1f,0x67,0xe0,0x74,0x6c,0xc0,0x99, + 0xe8,0xf3,0xf4,0xd0,0x87,0x56,0xcb,0xf0,0x40,0xd4,0x2,0x81,0x66,0x12,0x7,0x70, + 0x18,0x7,0xb0,0xf,0x7,0x20,0x4d,0xe5,0xf4,0x20,0xbe,0x87,0xdb,0xba,0xbe,0x73, + 0x6a,0x97,0x5f,0x77,0x40,0xd8,0x26,0xdb,0xd6,0xf5,0xd1,0x4b,0x71,0x35,0x5e,0x8a, + 0xf5,0xf2,0xbf,0x59,0x86,0xb3,0x70,0x6,0xfa,0xb1,0x16,0x7d,0xe8,0x6f,0x58,0xff, + 0x72,0x8,0xfa,0xe9,0x28,0x5d,0x35,0x13,0xff,0x9b,0xc1,0x28,0x46,0x31,0x8a,0x2a, + 0xe,0xe0,0x0,0x82,0x58,0xe4,0x38,0xbe,0xa7,0xef,0xe8,0xba,0x7d,0xc7,0xde,0xce, + 0x37,0xdf,0x1,0x61,0xdb,0xc5,0xc5,0xcd,0xcf,0x50,0x57,0xe1,0x45,0x78,0x26,0x96, + 0x85,0xfe,0xe9,0x72,0xac,0xc5,0xda,0x6,0x20,0xfb,0xb0,0x2,0x2b,0x1a,0x53,0xa9, + 0x94,0x28,0x1f,0x74,0xe5,0x85,0x73,0xbf,0x45,0x98,0xc0,0x71,0x54,0x51,0xc5,0x28, + 0x46,0x30,0x86,0x51,0x64,0x48,0xde,0x66,0xd5,0xbd,0xfa,0xce,0xe8,0x8e,0xfe,0x1f, + 0x9e,0xba,0xbd,0x7f,0x1d,0x10,0x2e,0x92,0xed,0xf2,0x9e,0x91,0xcb,0x2b,0xcf,0xc5, + 0x95,0x78,0x2e,0xce,0xc8,0xfe,0x28,0x4b,0xb1,0x12,0x2b,0xb1,0x1c,0xcb,0xb1,0x2, + 0x2b,0xb0,0x12,0xcb,0xd1,0x8d,0x5e,0x0,0x4b,0xd0,0x85,0xa,0x96,0x2,0xe8,0x6e, + 0xac,0x4,0x57,0xc7,0xc,0x80,0x29,0x44,0xd0,0x98,0x4,0x30,0x83,0x1a,0xa6,0x70, + 0x1c,0x27,0x1a,0xff,0x4d,0xe0,0x4,0x4e,0xe4,0x79,0x43,0x55,0xfc,0x50,0xff,0x10, + 0x3f,0x98,0xbd,0xa7,0xa3,0x7a,0x76,0x40,0xb8,0xe8,0xb6,0x73,0x36,0x74,0x5f,0x81, + 0x2b,0xd5,0x15,0x78,0x9a,0x2c,0x67,0x6c,0xb3,0x6d,0xbf,0xfa,0x81,0xbe,0x4b,0xfd, + 0x60,0xe7,0xcf,0x4e,0xad,0xc1,0x4b,0x1d,0x10,0x9e,0x94,0xdb,0xd9,0x6b,0x7b,0x9f, + 0x86,0x4b,0x70,0x9,0x2e,0xc5,0xc5,0xe1,0x54,0xb5,0xa5,0xdb,0xc,0x1e,0xc1,0x3, + 0xea,0x1,0x6c,0xab,0xdf,0x3f,0x7c,0xa0,0xf3,0xcd,0x75,0x40,0x78,0x32,0x6e,0x5d, + 0x3,0x5b,0xf4,0xa5,0xb8,0x54,0x5d,0xa2,0x2f,0x55,0x9b,0xdb,0xe6,0xf3,0xdf,0x83, + 0x7,0xb0,0xd,0xdb,0xf0,0x60,0xdf,0xa3,0x9d,0x7c,0xaf,0x3,0xc2,0x53,0x68,0xbb, + 0x78,0xe5,0xc4,0x0,0x36,0xa9,0xcd,0xd8,0xac,0x36,0xeb,0x4d,0xd8,0xe4,0xb7,0xff, + 0xb,0xdb,0x26,0xe7,0x6a,0xaf,0xf5,0x90,0x1a,0xae,0xc,0xd5,0x6,0x87,0xc7,0x3a, + 0xdf,0x46,0x7,0x84,0x9d,0xd,0xc0,0x85,0xfd,0xb3,0x9b,0xa2,0xcd,0xd8,0xa4,0xce, + 0xd2,0xfd,0xaa,0x7f,0xfe,0x5f,0xee,0x87,0x3d,0x8a,0xc3,0x18,0xc1,0x88,0x1a,0xd1, + 0x23,0x38,0xa4,0x86,0xea,0xc3,0x6a,0x68,0xe8,0x60,0xe7,0xd3,0xee,0x80,0xb0,0xb3, + 0x49,0xb7,0xca,0xd6,0xfe,0x5a,0x7f,0x57,0x7f,0xd4,0x8f,0xd5,0x95,0xe5,0x40,0xb4, + 0x5a,0x75,0xe9,0x6e,0xb5,0xa,0x50,0x2b,0xa2,0x5e,0xa0,0xd2,0xa7,0xc7,0x75,0x5d, + 0xd5,0x70,0xc,0x50,0x27,0xf4,0x8c,0xd2,0x18,0x3,0x30,0x8d,0xa3,0xd1,0x48,0xd7, + 0x48,0x7d,0xe4,0xdc,0x91,0x53,0x73,0x96,0x67,0x67,0xeb,0x6c,0x9d,0xad,0xb3,0x75, + 0xb6,0xce,0xd6,0xd9,0x16,0xcb,0xf6,0xff,0x3,0x42,0xd8,0x74,0x5e,0xb2,0x0,0xcd, + 0xb3,0x0,0x0,0x0,0x25,0x74,0x45,0x58,0x74,0x64,0x61,0x74,0x65,0x3a,0x63,0x72, + 0x65,0x61,0x74,0x65,0x0,0x32,0x30,0x32,0x32,0x2d,0x30,0x37,0x2d,0x30,0x37,0x54, + 0x31,0x35,0x3a,0x33,0x32,0x3a,0x32,0x31,0x2b,0x30,0x30,0x3a,0x30,0x30,0x6c,0x6e, + 0x34,0xdc,0x0,0x0,0x0,0x25,0x74,0x45,0x58,0x74,0x64,0x61,0x74,0x65,0x3a,0x6d, + 0x6f,0x64,0x69,0x66,0x79,0x0,0x32,0x30,0x32,0x32,0x2d,0x30,0x37,0x2d,0x30,0x37, + 0x54,0x31,0x35,0x3a,0x33,0x32,0x3a,0x32,0x31,0x2b,0x30,0x30,0x3a,0x30,0x30,0x1d, + 0x33,0x8c,0x60,0x0,0x0,0x0,0x0,0x49,0x45,0x4e,0x44,0xae,0x42,0x60,0x82, + // /home/pi/share/projects.nxt/libPiGPIO/images/Green.png + 0x0,0x0,0x6a,0x84, + 0x89, + 0x50,0x4e,0x47,0xd,0xa,0x1a,0xa,0x0,0x0,0x0,0xd,0x49,0x48,0x44,0x52,0x0, + 0x0,0x1,0x5c,0x0,0x0,0x1,0x5c,0x8,0x6,0x0,0x0,0x0,0x84,0x16,0x6,0x2c, + 0x0,0x0,0x0,0x6,0x62,0x4b,0x47,0x44,0x0,0xff,0x0,0xff,0x0,0xff,0xa0,0xbd, + 0xa7,0x93,0x0,0x0,0x20,0x0,0x49,0x44,0x41,0x54,0x78,0x9c,0xec,0xbd,0x79,0x9c, + 0x1c,0x47,0x79,0x3e,0xfe,0x54,0x77,0xcf,0xcc,0x1e,0xda,0xd5,0x5e,0xba,0x6f,0xc9, + 0x87,0x6c,0x49,0xbe,0x2f,0xd9,0xd2,0x6a,0xd6,0x32,0xb6,0xe5,0x60,0x63,0x48,0xc, + 0x84,0xe3,0x4b,0x8,0x31,0x4,0x48,0x38,0x43,0x8,0xdf,0x2f,0x87,0x21,0x40,0x7e, + 0x21,0x5c,0x86,0x40,0xc0,0x18,0x30,0x97,0x6d,0xec,0x90,0x10,0xc0,0xc6,0xd8,0x80, + 0x85,0x8f,0xf8,0xd2,0x5a,0xd6,0xb1,0x96,0x75,0x58,0x5a,0x49,0xab,0x63,0xaf,0xd9, + 0x7b,0xe7,0xea,0xee,0xfa,0xfd,0x31,0x3b,0xb3,0xdd,0xd3,0xdd,0xd3,0x57,0x75,0xf7, + 0xec,0xaa,0x9e,0xfd,0xd8,0xaa,0xe9,0xa9,0xae,0xf7,0xed,0x9e,0xae,0xa7,0xde,0x7e, + 0xeb,0xad,0xb7,0x8,0x38,0x38,0xc2,0x3,0xd9,0xb8,0x71,0xe3,0x62,0x49,0x92,0x5a, + 0x55,0x55,0x6d,0x15,0x4,0xa1,0x15,0xc0,0x3c,0x4a,0x69,0xb,0xa5,0xb4,0x95,0x10, + 0xd2,0xa,0xa0,0xf8,0x5f,0xc,0x0,0x28,0xa5,0x73,0x8a,0x65,0x0,0xd,0x0,0x24, + 0x93,0x76,0xc7,0x0,0xc8,0x94,0xd2,0x52,0x79,0xea,0xdc,0x31,0x42,0xc8,0x0,0xa5, + 0x74,0x80,0x10,0x32,0x48,0x8,0x19,0x54,0x55,0x75,0xb0,0x58,0x96,0x65,0x79,0x30, + 0x9d,0x4e,0x9f,0xdc,0xbd,0x7b,0xf7,0x44,0xb0,0x97,0xcd,0xc1,0x51,0x0,0x89,0x5a, + 0x1,0x8e,0x59,0x5,0x61,0xd3,0xa6,0x4d,0x2b,0x1,0xac,0x6,0xb0,0x5a,0x10,0x84, + 0xd5,0x0,0x56,0x53,0x4a,0x8b,0xff,0x36,0x3b,0x6d,0x68,0x8a,0x3c,0x1d,0xc3,0x4d, + 0x7d,0x93,0xba,0x19,0x0,0x27,0x1,0x1c,0x6,0x70,0x98,0x10,0x72,0x98,0x52,0x7a, + 0x58,0x55,0xd5,0xc3,0x92,0x24,0x1d,0x78,0xfa,0xe9,0xa7,0xc7,0x5c,0x29,0xc3,0xc1, + 0x61,0x1,0x4e,0xb8,0x1c,0x9e,0x70,0xfd,0xf5,0xd7,0xd7,0xa7,0xd3,0xe9,0x75,0x0, + 0x2e,0x4,0xb0,0x61,0xea,0xbf,0xb,0x0,0xb4,0x98,0xd5,0xf7,0x49,0x88,0x4c,0xea, + 0x7a,0x6c,0x5b,0x6,0x70,0x10,0xc0,0xee,0xa9,0xff,0xf6,0x0,0xd8,0xf3,0xec,0xb3, + 0xcf,0x76,0xbb,0x12,0xcc,0xc1,0x1,0x4e,0xb8,0x1c,0xe,0xb0,0x69,0xd3,0xa6,0x66, + 0x41,0x10,0x36,0x2,0xb8,0x2,0xc0,0x7a,0x4a,0xe9,0x85,0x28,0x58,0xb1,0x82,0x93, + 0xf3,0xab,0x81,0x6c,0x3,0x20,0xe6,0x11,0x4c,0x91,0x2f,0x80,0x9d,0xb2,0x2c,0x3f, + 0xb3,0x63,0xc7,0x8e,0x97,0x1,0xa8,0xae,0x4,0x71,0x9c,0x51,0xe0,0x84,0xcb,0x51, + 0xe,0x61,0xd3,0xa6,0x4d,0x17,0xb,0x82,0xb0,0x9,0xc0,0x35,0x0,0x36,0x1,0x58, + 0x54,0xfc,0xb2,0xca,0xac,0xcf,0x48,0xeb,0x9a,0xd4,0x9f,0x4,0xb0,0x13,0x40,0x27, + 0xa5,0xf4,0x29,0x0,0x7f,0x7c,0xfe,0xf9,0xe7,0x7,0x5d,0x35,0xc8,0x31,0xab,0xc1, + 0x9,0x97,0x3,0xed,0xed,0xed,0xe7,0x51,0x4a,0x6f,0x14,0x4,0xa1,0x9d,0x52,0x7a, + 0x35,0x80,0xf9,0x66,0xf5,0xaa,0x94,0xe4,0xaa,0x59,0xf,0x19,0xc0,0x4b,0x0,0x9e, + 0xa6,0x94,0xfe,0x3e,0x93,0xc9,0x3c,0xce,0x27,0xe8,0xce,0x6c,0x70,0xc2,0x3d,0x3, + 0xb1,0x79,0xf3,0xe6,0x45,0x82,0x20,0xdc,0x4c,0x29,0xbd,0xe,0x40,0x12,0xc0,0x3c, + 0xbb,0x73,0xaa,0x81,0xe4,0x66,0x1,0x31,0x2b,0x28,0x10,0xf0,0xef,0x9,0x21,0xbf, + 0x79,0xee,0xb9,0xe7,0xfe,0x17,0xdc,0x5,0x71,0x46,0x81,0x13,0xee,0x19,0x82,0x8e, + 0x8e,0x8e,0xb,0x29,0xa5,0xdb,0x54,0x55,0xbd,0x11,0xc0,0xd5,0x98,0xe,0xb5,0xaa, + 0x88,0x59,0x40,0x72,0xd5,0x5c,0xf7,0x38,0x21,0xe4,0x11,0x0,0xbf,0x93,0x24,0xe9, + 0x51,0x1e,0xd,0x31,0xfb,0xc1,0x9,0x77,0xf6,0x82,0x24,0x93,0xc9,0x6b,0x28,0xa5, + 0xb7,0x1,0x78,0x3,0x80,0xa5,0x40,0x75,0x10,0x11,0xd7,0xc3,0xb4,0xae,0x2,0xe0, + 0x59,0x0,0xf,0xca,0xb2,0x7c,0xef,0xce,0x9d,0x3b,0xfb,0x1d,0x37,0xc0,0x31,0x63, + 0xc0,0x9,0x77,0x76,0x41,0x4b,0xb2,0xb7,0x2,0x58,0xae,0xfd,0xb2,0x1a,0xc8,0xa5, + 0x5a,0xf4,0xa8,0x72,0x9d,0x15,0x0,0x8f,0x13,0x42,0x7e,0xa2,0x28,0xca,0xff,0x74, + 0x76,0x76,0x8e,0x38,0x6e,0x90,0xa3,0xaa,0xc1,0x9,0x77,0x16,0xa0,0xbd,0xbd,0x7d, + 0x19,0x21,0xe4,0xaf,0x0,0xbc,0x11,0xc0,0xfa,0xf2,0xef,0xab,0x9c,0x5c,0xaa,0x5a, + 0x8f,0xa8,0x75,0x26,0x84,0x8c,0x3,0xf8,0xb5,0xa2,0x28,0x3f,0x5b,0xbd,0x7a,0xf5, + 0x23,0xf,0x3e,0xf8,0xa0,0xe2,0x4a,0x21,0x8e,0xaa,0x2,0x27,0xdc,0x19,0x8a,0x8d, + 0x1b,0x37,0xd6,0xc6,0xe3,0xf1,0xb7,0x3,0x78,0x37,0x80,0x4b,0xad,0xea,0x45,0x4d, + 0x18,0x41,0xd7,0xad,0x16,0x3d,0xc2,0xd0,0x99,0x10,0x32,0x44,0x29,0x7d,0x10,0xc0, + 0x37,0x77,0xec,0xd8,0xb1,0xd7,0x95,0x40,0x8e,0xaa,0x0,0x27,0xdc,0x19,0x86,0xcd, + 0x9b,0x37,0x5f,0x20,0x8,0xc2,0xfb,0x51,0xb0,0x66,0x9b,0x2a,0xd5,0xad,0x36,0xc2, + 0x88,0xb2,0xee,0x6c,0xd3,0x83,0x10,0xd2,0x9,0xe0,0x2e,0x55,0x55,0x7f,0xda,0xd9, + 0xd9,0x39,0xe9,0x4a,0x1,0x8e,0xc8,0xc0,0x9,0x77,0x6,0xe0,0xb6,0xdb,0x6e,0x13, + 0xfb,0xfb,0xfb,0x5f,0x4f,0x29,0x7d,0x37,0x80,0xad,0x70,0xb0,0xc2,0x6b,0x36,0x91, + 0x4b,0x98,0x75,0x67,0xa0,0x1e,0xa7,0x28,0xa5,0xf7,0xa8,0xaa,0xfa,0xdd,0x9d,0x3b, + 0x77,0x1e,0x75,0x25,0x80,0x23,0x74,0x70,0xc2,0xad,0x62,0x6c,0xdd,0xba,0xb5,0x55, + 0x51,0x94,0xbf,0xa7,0x94,0xfe,0x2d,0x80,0x5,0x4e,0xcf,0xab,0x6,0xc2,0x98,0xe5, + 0x24,0x57,0x35,0x75,0x35,0xf5,0x55,0x0,0xf,0xb,0x82,0x70,0xe7,0xb,0x2f,0xbc, + 0xf0,0x7b,0x57,0xd,0x70,0x84,0x6,0x4e,0xb8,0x55,0x88,0x64,0x32,0xb9,0x96,0x52, + 0xfa,0x61,0x42,0xc8,0x5b,0x29,0xa5,0xf5,0x4e,0xcf,0x3b,0x83,0xc8,0x85,0xeb,0x51, + 0xb9,0xee,0x4e,0x42,0xc8,0xd7,0x29,0xa5,0xf7,0x75,0x76,0x76,0xe6,0x1d,0x37,0xc8, + 0x11,0x38,0x38,0xe1,0x56,0x11,0x92,0xc9,0xe4,0x75,0x0,0x3e,0x48,0x29,0xbd,0x89, + 0x10,0x22,0x54,0x43,0xa7,0xe,0xb2,0xed,0x99,0xa8,0xc7,0xc,0xd3,0xf9,0x14,0x21, + 0xe4,0xae,0x6c,0x36,0x7b,0xe7,0x9e,0x3d,0x7b,0x86,0x1c,0x37,0xce,0x11,0x18,0x38, + 0xe1,0x56,0x1,0x92,0xc9,0xe4,0x55,0x0,0x3e,0x7,0xe0,0x35,0xc5,0x63,0xd5,0x40, + 0x18,0x33,0x8c,0x5c,0xaa,0x4a,0x8f,0x2a,0xd3,0x79,0x80,0x52,0xfa,0x65,0x45,0x51, + 0xfe,0x9d,0xe7,0x72,0x88,0x16,0x9c,0x70,0x23,0x44,0x47,0x47,0xc7,0x16,0x4a,0xe9, + 0x17,0x50,0xc8,0xca,0x5,0xa0,0xea,0x3a,0x6a,0xe4,0x6d,0x73,0x9d,0xd9,0xb5,0x4d, + 0x29,0x4d,0x11,0x42,0xbe,0x19,0x8b,0xc5,0xbe,0xfa,0xdc,0x73,0xcf,0x8d,0xba,0x12, + 0xcc,0xc1,0x4,0x9c,0x70,0x23,0x40,0x32,0x99,0xbc,0xc,0xc0,0xbf,0x0,0xb8,0x4e, + 0x7b,0xbc,0x5a,0x3b,0xea,0x6c,0xd3,0x83,0xeb,0x5c,0xb0,0x78,0x6b,0x6a,0x6a,0xbe, + 0xf1,0xcc,0x33,0xcf,0xa4,0x5d,0x35,0xcc,0xe1,0xb,0x9c,0x70,0x43,0x44,0x7b,0x7b, + 0xfb,0xc5,0x82,0x20,0x7c,0x9,0x65,0x44,0xb,0x70,0xc2,0xa8,0x46,0x3d,0x66,0xa2, + 0xce,0x2e,0xeb,0xf7,0x51,0x4a,0xbf,0x3a,0x77,0xee,0xdc,0x3b,0xb7,0x6f,0xdf,0x9e, + 0x71,0x25,0x84,0xc3,0x13,0x38,0xe1,0x86,0x80,0x1b,0x6e,0xb8,0xa1,0x25,0x97,0xcb, + 0xdd,0x41,0x29,0x7d,0x2f,0x4c,0x36,0x41,0x9c,0x81,0x1d,0x95,0x49,0x5d,0x4a,0x29, + 0x14,0x45,0x81,0xa2,0x28,0x90,0x65,0x19,0xaa,0xaa,0x96,0xfe,0x55,0x14,0xa5,0x74, + 0x9e,0xa2,0x28,0x20,0x84,0x80,0x52,0xa,0x55,0x35,0x66,0x33,0x14,0x45,0x11,0x0, + 0x40,0x8,0x1,0x21,0xa4,0x74,0x4c,0x14,0x45,0x8,0x82,0x50,0xfa,0x57,0x5b,0xe, + 0xe3,0xfa,0xc2,0x6e,0xdb,0x87,0x1e,0x2f,0xab,0xaa,0xfa,0xe1,0x5d,0xbb,0x76,0x3d, + 0xea,0xaa,0x1,0xe,0xd7,0xe0,0x84,0x1b,0x20,0xb6,0x6d,0xdb,0x96,0x48,0xa7,0xd3, + 0x9f,0x0,0xf0,0xf,0x0,0x4c,0xc3,0xbb,0xaa,0xa1,0xf3,0x5,0x45,0x18,0xb2,0x2c, + 0x23,0x97,0xcb,0x41,0x96,0x65,0xe4,0xf3,0xf9,0xd2,0x7f,0xc5,0xcf,0x4e,0xdb,0x29, + 0x92,0x28,0xab,0x7a,0x0,0x10,0x8b,0xc5,0x20,0x49,0x12,0x44,0x51,0x84,0x24,0x49, + 0xba,0xff,0x44,0x51,0x74,0xdc,0xd6,0x4c,0x24,0x5b,0xab,0xba,0x84,0x90,0xc7,0x1, + 0x7c,0xe8,0xc5,0x17,0x5f,0xdc,0xed,0xb8,0x31,0xe,0x57,0xe0,0x84,0x1b,0x10,0xb6, + 0x6c,0xd9,0x72,0x1b,0x21,0xe4,0x8b,0x0,0xce,0x32,0xfb,0x7e,0x36,0x75,0xd4,0x5c, + 0x2e,0x87,0x6c,0x36,0x8b,0x6c,0x36,0x5b,0x2a,0xe7,0x72,0xb9,0x8a,0x6d,0xb3,0x26, + 0x51,0xd6,0xf5,0x4,0x41,0x40,0x2c,0x16,0x43,0x22,0x91,0x40,0x2c,0x16,0x43,0x2c, + 0x16,0x43,0x3c,0x1e,0xd7,0x9d,0x5f,0xd,0x83,0x5a,0x0,0x75,0x55,0x0,0x3f,0x53, + 0x14,0xe5,0x1f,0x76,0xef,0xde,0xdd,0xe7,0xb8,0x61,0xe,0x47,0xe0,0x84,0xcb,0x18, + 0x5b,0xb7,0x6e,0xbd,0x40,0x96,0xe5,0xaf,0x11,0x42,0xae,0xb5,0xaa,0x33,0x93,0x3b, + 0x2a,0xa5,0x14,0xe9,0x74,0x1a,0x93,0x93,0x93,0x48,0xa7,0xd3,0xc8,0x64,0x32,0x90, + 0x65,0x39,0x10,0x2b,0xb4,0xda,0x48,0x99,0x10,0x52,0x22,0xdf,0x44,0x22,0x81,0x44, + 0x22,0x1,0x49,0x32,0x78,0x88,0xc,0x98,0xa1,0xbf,0xf7,0x10,0xa5,0xf4,0x5f,0x65, + 0x59,0xfe,0x5a,0x57,0x57,0x57,0xce,0x95,0x52,0x1c,0x96,0xe0,0x84,0xcb,0x8,0xc9, + 0x64,0xb2,0x6,0xc0,0x27,0x29,0xa5,0x1f,0x23,0x84,0xc4,0xad,0xea,0x55,0x83,0xa5, + 0xea,0xa6,0x7e,0x36,0x9b,0xc5,0xc4,0xc4,0x4,0xd2,0xe9,0x34,0xd2,0xe9,0x34,0x72, + 0x39,0x63,0xdf,0xb,0x82,0xf0,0xe2,0xf5,0x31,0xd4,0xb7,0xd6,0x1,0x0,0xea,0xe7, + 0xd5,0x43,0x8c,0x89,0x88,0xd7,0x4a,0xa8,0x6f,0x2e,0xf3,0xcc,0xa8,0x0,0xd2,0x4, + 0x23,0x63,0x23,0xa0,0x69,0x80,0xc8,0x4,0xb2,0xac,0x60,0xf4,0xe4,0x18,0x46,0x47, + 0x47,0x75,0x6d,0xb2,0xd6,0x11,0xd0,0x5b,0xc2,0x89,0x44,0x22,0x34,0x2b,0x38,0x44, + 0x62,0xde,0x29,0x8,0xc2,0xed,0x2f,0xbe,0xf8,0x62,0xa7,0x2b,0x81,0x1c,0xa6,0xe0, + 0x84,0xcb,0x0,0x1d,0x1d,0x1d,0x37,0x50,0x4a,0xbf,0x3,0x60,0x65,0xa5,0x7a,0xd5, + 0xd0,0xf9,0xec,0xea,0x52,0x4a,0x31,0x39,0x39,0x89,0x89,0x89,0x9,0x8c,0x8f,0x8f, + 0x23,0x93,0xa9,0x3c,0x79,0xed,0x86,0xa0,0x6a,0xdb,0x6a,0xb0,0xe2,0xd2,0xa5,0x58, + 0xb1,0x61,0x39,0x96,0x9f,0xb3,0x14,0xb,0x16,0x2d,0x44,0xf3,0xdc,0x66,0xb4,0x34, + 0xb4,0xa0,0xa9,0xae,0x19,0xcd,0x35,0x2d,0x68,0x8a,0x35,0xa3,0x49,0x6a,0x41,0x3d, + 0x99,0x63,0xad,0x23,0xa8,0xee,0x5f,0xab,0x32,0xa5,0x2a,0x86,0x95,0x21,0x8c,0xe5, + 0x46,0x31,0x9c,0x1d,0xc6,0x68,0x7a,0x18,0x23,0x13,0x23,0x18,0x1c,0x1e,0xc4,0xe9, + 0x13,0xa7,0x71,0xe2,0xd0,0x49,0x9c,0xdc,0x77,0x1a,0xa7,0xf7,0xf5,0xe1,0xe4,0x89, + 0x93,0xa6,0x83,0x89,0xdb,0x6b,0x16,0x4,0x1,0x89,0x44,0x2,0x35,0x35,0x35,0x48, + 0x24,0x12,0xa5,0x9,0x3d,0x3b,0x54,0xc3,0xb3,0x51,0xa1,0x3e,0x5,0xf0,0xbd,0x44, + 0x22,0xf1,0x31,0x1e,0xbf,0xeb,0xf,0x9c,0x70,0x7d,0x20,0x99,0x4c,0xb6,0x11,0x42, + 0xbe,0x4d,0xb,0x3b,0x2c,0x58,0xa2,0x8a,0x5e,0x13,0x4d,0x8f,0xa7,0xd3,0xe9,0x12, + 0xc1,0xa6,0xd3,0x69,0x47,0x6d,0x5a,0x91,0x8e,0x90,0x10,0xb0,0xa6,0x7d,0x5,0xd6, + 0x27,0xcf,0xc7,0xfa,0x8b,0xd6,0x61,0xd5,0xe2,0xd5,0x58,0xd6,0xbc,0x2,0xcb,0x6a, + 0x57,0xa0,0x4d,0x34,0xdd,0xc,0xb8,0xb2,0xce,0x36,0xa4,0x5a,0xa9,0xc,0x33,0x12, + 0xd6,0x1e,0xa3,0xfa,0xf2,0x60,0x76,0x0,0x27,0x47,0x7b,0x70,0xe8,0xf8,0x21,0x1c, + 0xde,0x77,0x4,0xaf,0xbe,0x70,0x4,0x87,0x77,0x1d,0x41,0x77,0x77,0x77,0x89,0x8c, + 0xdd,0x5a,0xc0,0x92,0x24,0xe9,0xac,0x5f,0xb3,0x8,0x89,0x2a,0x27,0x5b,0x2d,0x4e, + 0x51,0x4a,0xff,0x6e,0xd7,0xae,0x5d,0xff,0xe5,0xaa,0x61,0x8e,0x12,0x38,0xe1,0x7a, + 0x44,0x47,0x47,0xc7,0xff,0x51,0x55,0xf5,0xdf,0x8,0x21,0x15,0x59,0xa4,0x4a,0x5f, + 0x13,0x91,0xcd,0x66,0x31,0x3a,0x3a,0x8a,0xd1,0xd1,0xd1,0x92,0x15,0xeb,0x96,0x4c, + 0xe2,0x2d,0x71,0x5c,0x74,0xeb,0x3a,0xac,0xdf,0xb8,0xe,0xeb,0xcf,0x5f,0x8f,0xf5, + 0x4b,0x2e,0xc0,0xda,0xfa,0x75,0xa8,0x23,0x8e,0xf3,0xed,0x18,0xf5,0x74,0x68,0xbd, + 0x96,0x97,0xcd,0xc8,0xd5,0x50,0xa6,0x1e,0xc8,0x9b,0x2,0x8a,0x22,0xa3,0x67,0xb8, + 0x7,0x7,0x8f,0x1c,0xc0,0xde,0x1d,0x7b,0xb1,0xf7,0xc9,0x7d,0xe8,0xda,0xdb,0x85, + 0xc1,0xc1,0x41,0xd3,0x6b,0xb0,0x1c,0x8c,0xa6,0xac,0xdf,0xda,0xda,0x5a,0x24,0x12, + 0x9,0xd3,0x3a,0x95,0x50,0x45,0xc4,0xfc,0x1b,0x0,0x7f,0xbb,0x6b,0xd7,0xae,0x13, + 0xae,0x4e,0xe4,0xe0,0x84,0xeb,0x16,0x5b,0xb7,0x6e,0x5d,0xa0,0x28,0xca,0xbf,0x3, + 0xf8,0xb,0xbb,0xba,0xd5,0x46,0xb6,0xe9,0x74,0x1a,0x23,0x23,0x23,0x18,0x1b,0x1b, + 0xd3,0xbd,0x3e,0x3b,0x22,0x5a,0x2,0x2c,0xb8,0xb2,0xd,0x57,0xdc,0x7a,0x29,0xae, + 0xbc,0xfa,0xa,0x5c,0xbe,0xea,0x4a,0x5c,0x50,0x77,0x9,0xe2,0x70,0x4f,0x1c,0x25, + 0xbd,0x18,0x5b,0xaf,0xda,0xb2,0x27,0x72,0x75,0x2a,0x93,0x2,0x54,0xa5,0x38,0x39, + 0x7c,0x12,0x5d,0xfb,0xf6,0xa2,0xeb,0xe9,0x7d,0xd8,0xf1,0x74,0x27,0xf6,0xec,0xd9, + 0x83,0x7c,0xde,0x59,0x72,0x2e,0x41,0x10,0x10,0x8f,0xc7,0x51,0x53,0x53,0x83,0x9a, + 0x9a,0x1a,0xdb,0xdf,0xa0,0x1a,0xc8,0xb6,0xac,0x6e,0x2f,0x80,0xf,0xec,0xda,0xb5, + 0xeb,0x1,0xc7,0xd,0x70,0x70,0xc2,0x75,0x83,0x8e,0x8e,0x8e,0xb7,0x50,0x4a,0xbf, + 0xd,0x60,0xae,0x5d,0xdd,0x6a,0xe8,0x20,0x0,0x90,0xcf,0xe7,0x31,0x32,0x32,0x82, + 0x91,0x91,0x11,0xa4,0xd3,0xc6,0x55,0x9c,0x95,0x3a,0xfa,0xfc,0xf3,0xdb,0x70,0xed, + 0xbb,0xda,0xd1,0xd1,0xde,0x81,0x2b,0x96,0x6d,0xc4,0xf2,0xd8,0x2a,0x57,0xb2,0xcb, + 0x61,0x4a,0x8c,0x51,0x5a,0xaf,0x15,0x74,0x71,0x24,0x53,0x4b,0xc0,0xa,0x45,0x36, + 0x93,0xc5,0x4b,0x7b,0x5f,0xc2,0xb,0x7f,0xe8,0xc4,0xb,0xcf,0xbd,0x60,0x49,0xc0, + 0xe5,0xf7,0x9c,0x10,0x82,0x9a,0x9a,0x1a,0xd4,0xd6,0xd6,0x22,0x1e,0xd7,0xcf,0xb7, + 0x56,0xbb,0x3b,0xa,0xc0,0x7f,0x27,0x12,0x89,0xdb,0x9f,0x7f,0xfe,0x79,0x73,0x73, + 0x9f,0x43,0x7,0x4e,0xb8,0xe,0x90,0x4c,0x26,0xe7,0x4c,0xf9,0x6a,0xdf,0xee,0xa4, + 0x7e,0xd4,0x64,0x4b,0x29,0xc5,0xe8,0xe8,0x28,0x52,0xa9,0x14,0x26,0x26,0xac,0x93, + 0x43,0x95,0x77,0xfc,0xd8,0x5c,0x9,0x57,0xbe,0xeb,0x12,0x5c,0x7b,0x53,0x7,0xae, + 0x5d,0x7b,0x1d,0xd6,0xd7,0x5e,0xc,0xe2,0xf1,0x11,0x99,0xb1,0xd6,0xab,0xcb,0x73, + 0x2d,0x9,0x58,0x6,0x32,0x93,0x19,0x74,0x76,0x76,0x62,0xfb,0xaf,0xff,0x84,0x27, + 0x9e,0x78,0x2,0x7d,0x7d,0xf6,0x61,0xad,0x82,0x20,0xa0,0xb6,0xb6,0x16,0xf5,0xf5, + 0xf5,0xae,0x42,0xe8,0x22,0x26,0xe6,0xd3,0x94,0xd2,0x77,0xee,0xde,0xbd,0xfb,0x11, + 0x57,0x4a,0x9c,0x81,0xe0,0x84,0x6b,0x83,0x8e,0x8e,0x8e,0x6b,0x28,0xa5,0x3f,0x85, + 0x4d,0x4,0x2,0x10,0xf9,0x43,0x8f,0x5c,0x2e,0x87,0x54,0x2a,0x85,0xe1,0xe1,0x61, + 0xc8,0xb2,0x5c,0xb1,0x6e,0xb1,0x33,0x37,0x2c,0x9a,0x83,0x1b,0x3f,0xb8,0x15,0x37, + 0xdf,0x74,0xb,0xda,0x17,0x5f,0x8b,0x6,0xd2,0xe8,0x58,0x27,0x9d,0x7e,0x5e,0x88, + 0x69,0xea,0x93,0x6d,0x1b,0xcc,0x9,0x96,0x3d,0x61,0x57,0x2c,0xcb,0x0,0xb2,0xc0, + 0x2b,0xaf,0xbc,0x82,0x27,0x7e,0xfb,0x14,0xfe,0xf4,0xa7,0x3f,0x61,0xff,0xfe,0xfd, + 0xa6,0xbf,0xa9,0x96,0x64,0xb5,0x2e,0x87,0x4a,0xa8,0x12,0xd7,0x15,0xa5,0x94,0x7e, + 0x53,0x51,0x94,0x8f,0xf1,0xb8,0x5d,0x6b,0x70,0xc2,0xb5,0xc0,0xd4,0x3e,0x62,0x9f, + 0x2,0xf0,0xff,0x60,0x92,0xff,0xa0,0x1c,0x51,0x3e,0xf4,0x93,0x93,0x93,0x18,0x18, + 0x18,0xc0,0xd8,0xd8,0x98,0x6d,0x5d,0x42,0x8,0x9a,0x56,0x37,0xe2,0xa6,0x8f,0xbe, + 0x6,0xb7,0x5c,0xf7,0x3a,0x6c,0x69,0xbb,0xce,0xb5,0x1f,0x36,0x70,0x4b,0xb2,0xb8, + 0xc8,0x22,0x62,0xeb,0x55,0x5b,0x76,0x2d,0xd3,0x6a,0x90,0x50,0x29,0x90,0x21,0x38, + 0x75,0xe2,0x34,0x7e,0xfb,0x9f,0x8f,0xe0,0xe1,0x87,0x1f,0xc6,0xd1,0xa3,0x85,0xad, + 0xc8,0xac,0x2c,0x5a,0x51,0x14,0x51,0x5b,0x5b,0x8b,0xda,0xda,0x5a,0x43,0x9d,0xa8, + 0xdf,0xa6,0x4c,0xea,0xef,0xa5,0x94,0xbe,0x65,0xcf,0x9e,0x3d,0x7b,0x5c,0x35,0x70, + 0x86,0x80,0x13,0xae,0x9,0x92,0xc9,0xe4,0x42,0x0,0x3f,0x86,0x26,0x21,0x78,0x25, + 0x44,0xf1,0xd0,0x53,0x4a,0x31,0x34,0x34,0x84,0xc1,0xc1,0x41,0x64,0xb3,0x59,0xdb, + 0xb6,0x6a,0x9b,0x6a,0xf0,0x86,0x7f,0xba,0x5,0xaf,0xbf,0xe5,0xd,0xd8,0xbc,0xb0, + 0x3,0x31,0xc4,0x9c,0xeb,0xc1,0xad,0x57,0xdb,0xb2,0x19,0xc1,0xda,0x9e,0x27,0x3, + 0x34,0x4d,0xb0,0x6f,0xef,0x3e,0x3c,0xf2,0x5f,0xbf,0xc3,0x63,0x8f,0x3d,0x86,0xa1, + 0xa1,0xca,0x1b,0x33,0xd4,0xd4,0xd4,0xa0,0xbe,0xbe,0x1e,0xa2,0x28,0x56,0x23,0xd9, + 0x16,0x3f,0x8f,0x2,0x78,0xdf,0x9e,0x3d,0x7b,0x7e,0xe6,0xaa,0xa1,0x33,0x0,0x9c, + 0x70,0xcb,0xb0,0x65,0xcb,0x96,0xd7,0x10,0x42,0xee,0x5,0xd0,0xe6,0xa4,0x7e,0xd8, + 0xf,0xbd,0xa2,0x28,0x18,0x18,0x18,0x40,0x2a,0x95,0x82,0xa2,0x28,0xb6,0xed,0x5c, + 0xf6,0xce,0xb,0xf0,0xb6,0x77,0xbf,0x15,0xaf,0x3f,0xe7,0x4d,0x8e,0xdc,0x5,0x67, + 0xa2,0xf5,0xaa,0x2d,0xfb,0xb2,0x5e,0xfd,0x94,0xf3,0x80,0x3a,0xa6,0xe2,0x99,0xc7, + 0x9f,0xc3,0x2f,0xff,0xf3,0x97,0x78,0xee,0xb9,0xe7,0xc,0xbf,0x6f,0xb9,0xbb,0xa1, + 0xb6,0xb6,0x16,0xb1,0x98,0xfd,0xc0,0x19,0xe1,0x22,0x9a,0x9f,0xc6,0xe3,0xf1,0xf7, + 0xf0,0x6d,0xdc,0xa7,0xc1,0x9,0x77,0xa,0x77,0xdc,0x71,0x87,0xb0,0x7d,0xfb,0xf6, + 0x4f,0x3,0xf8,0x24,0x0,0xdb,0xe5,0x41,0x61,0xfb,0x6b,0x55,0x55,0xc5,0xc0,0xc0, + 0x0,0x6,0x6,0x6,0x4a,0xe9,0xa,0xad,0xb0,0xec,0xfc,0x25,0x78,0xdb,0x67,0xdf, + 0x8c,0x3f,0xbf,0xe6,0x8d,0x58,0x5d,0x73,0x76,0x65,0x59,0x1e,0xc9,0x28,0x1a,0xeb, + 0x75,0x5a,0x6e,0xd4,0xd6,0xab,0xb6,0xcc,0x54,0x26,0x5,0x48,0x9a,0x60,0xf0,0xd4, + 0x10,0x7e,0xfb,0xc0,0x23,0xf8,0xd5,0xaf,0x7e,0x85,0x53,0xa7,0x4e,0xc1,0xa,0xb1, + 0x58,0xc,0xf5,0xf5,0xf5,0x96,0x39,0x1d,0xaa,0xc0,0xa,0x7e,0x89,0x52,0xfa,0xe7, + 0x7b,0xf6,0xec,0x39,0xec,0xb8,0xf1,0x59,0xc,0x4e,0xb8,0x0,0x92,0xc9,0x64,0x13, + 0xa,0x2e,0x84,0x9b,0x9d,0xd4,0xf,0xf3,0xf5,0x4c,0x51,0x14,0xf4,0xf7,0xf7,0x63, + 0x70,0x70,0xb0,0x94,0xb,0xd6,0x8a,0x6c,0xd7,0x5f,0xbf,0x16,0x7f,0xfb,0xe9,0xf7, + 0xe0,0x2f,0xce,0x7b,0x33,0xe2,0xc4,0xe8,0x97,0xd,0xcb,0x7a,0xd5,0x1e,0xe7,0xd6, + 0xab,0x8f,0xc1,0x2b,0xb,0xa8,0x23,0x14,0xff,0xfb,0xfb,0x67,0x71,0xff,0xbd,0xf7, + 0x63,0xef,0xde,0xbd,0xb0,0x42,0x39,0xf1,0x46,0x3d,0x81,0x5b,0x56,0x77,0x14,0xc0, + 0x3b,0xf6,0xec,0xd9,0xf3,0x4b,0x57,0x4a,0xcd,0x42,0x9c,0xf1,0x84,0xdb,0xde,0xde, + 0xbe,0x41,0x10,0x84,0x5f,0x0,0xa8,0x6c,0xa,0x4e,0x21,0x2c,0x8b,0x41,0x55,0xd5, + 0x12,0xd1,0x6a,0x5f,0x2d,0xcb,0xc9,0x56,0x8a,0x49,0x78,0xe3,0xa7,0x5e,0x8f,0x77, + 0xbf,0xe3,0x3d,0xb8,0xa0,0xe1,0x12,0x7d,0x9b,0xac,0x9,0xc0,0x86,0x5c,0xfd,0x96, + 0x67,0xbd,0xf5,0xaa,0xf9,0xe4,0xea,0x5c,0x85,0x2,0x63,0x2,0xe,0xbe,0x74,0x8, + 0xf7,0xfe,0xf0,0x3e,0x3c,0xf1,0xc4,0x13,0xba,0xfb,0xaf,0x7d,0x26,0x62,0xb1,0x18, + 0x6a,0x6b,0x6b,0x1d,0x65,0x31,0x3,0x42,0x25,0x66,0xa,0xe0,0x4b,0x7b,0xf6,0xec, + 0xf9,0xbf,0x28,0xa4,0x1c,0x3a,0x23,0x71,0x46,0x13,0x6e,0x47,0x47,0xc7,0xeb,0x28, + 0xa5,0x3f,0x82,0x83,0x85,0xc,0x40,0x38,0x64,0x4b,0x29,0x45,0x2a,0x95,0x42,0x7f, + 0x7f,0xbf,0x2e,0x68,0xbe,0x9c,0x68,0x6b,0x9b,0x6b,0xf0,0xd6,0x2f,0xbd,0x11,0xef, + 0x79,0xed,0x7b,0xb1,0x26,0x71,0x6e,0xf0,0x4,0xc0,0x98,0x98,0x58,0x5b,0xaf,0x4e, + 0x74,0x9,0xcb,0x7a,0xd5,0x97,0x19,0xb6,0x47,0x1,0x8c,0xb,0xd8,0xd7,0xb9,0xf, + 0xf7,0x7e,0xf7,0x7e,0x3c,0xfb,0xec,0xb3,0xb0,0x42,0x31,0x81,0x4e,0xa5,0xe4,0x39, + 0x11,0x45,0xd6,0xfc,0x77,0x2e,0x97,0x7b,0xc7,0xfe,0xfd,0xfb,0xc7,0x5c,0x35,0x38, + 0x4b,0x70,0xa6,0x12,0x2e,0x49,0x26,0x93,0x9f,0x1,0xf0,0x69,0x38,0xb8,0x7,0x61, + 0x59,0x1,0x23,0x23,0x23,0xe8,0xed,0xed,0x35,0x44,0x1d,0x68,0xc9,0xb6,0xb6,0xa9, + 0x6,0x7f,0xfd,0xf5,0xb7,0xe3,0xef,0x6f,0xfa,0x30,0xe6,0x49,0xb,0xa,0x6d,0xb0, + 0x26,0x80,0x90,0x16,0x16,0x44,0x6d,0xbd,0x6,0xa1,0xb,0xb,0x82,0x75,0xf2,0x5b, + 0x60,0x9c,0xe0,0xe0,0xce,0x57,0xf1,0xc3,0x6f,0xdc,0x83,0xce,0x4e,0xeb,0xcc,0x89, + 0x89,0x44,0x2,0x75,0x75,0x75,0xd5,0x16,0x4e,0x76,0x48,0x14,0xc5,0x9b,0x5e,0x7a, + 0xe9,0xa5,0x83,0x8e,0x1b,0x9e,0x25,0x38,0xe3,0x8,0xf7,0xb6,0xdb,0x6e,0x8b,0xf7, + 0xf7,0xf7,0x7f,0x17,0xc0,0x5f,0x39,0xa9,0x1f,0x6,0xd9,0x66,0x32,0x19,0x9c,0x3a, + 0x75,0xa,0xe3,0xe3,0xe3,0x86,0x3a,0xc5,0x8e,0x32,0x77,0x5e,0x23,0xde,0xf7,0xed, + 0xdb,0xf1,0xae,0xe4,0x7b,0xd0,0x24,0xb6,0x14,0xce,0x67,0x45,0x0,0xdc,0x7a,0xf5, + 0x58,0xe,0xa0,0x6d,0x7,0xd7,0xa1,0x93,0x3b,0x9,0xbc,0xf2,0xfc,0x41,0xdc,0x73, + 0xe7,0x8f,0xb0,0x6b,0xd7,0x2e,0x94,0xa3,0xb8,0xcf,0x9b,0x76,0x1,0x45,0x15,0x4c, + 0xa4,0x81,0x52,0x3a,0x48,0x29,0xbd,0xb5,0xab,0xab,0xeb,0x29,0xc7,0x27,0xcd,0x2, + 0x9c,0x51,0x84,0x9b,0x4c,0x26,0x9b,0x28,0xa5,0xbf,0xa8,0xb4,0x1b,0x83,0x16,0x41, + 0xbf,0x72,0xe5,0xf3,0x79,0x9c,0x3e,0x7d,0x1a,0xc3,0xc3,0xc3,0xa6,0x75,0x8,0x21, + 0xa8,0x6b,0xaa,0xc5,0x5f,0x7f,0xed,0xed,0x78,0xff,0x9f,0x7d,0x10,0x6d,0xd2,0x74, + 0x62,0x32,0xbb,0xce,0x18,0xb5,0xf5,0xaa,0x2d,0x47,0x6d,0xbd,0xb2,0xd2,0x85,0x35, + 0xc1,0xba,0x26,0xd7,0xa,0x65,0x3a,0x4a,0xf0,0xec,0x63,0xcf,0xe3,0x9e,0x3b,0x7f, + 0x84,0x9e,0x9e,0x1e,0xd3,0x89,0x55,0x51,0x14,0x4b,0x69,0x22,0x9d,0x20,0x4,0x62, + 0xce,0x50,0x4a,0xdf,0xd9,0xd5,0xd5,0x75,0xbf,0xe3,0x93,0x67,0x38,0xce,0x18,0xc2, + 0x4d,0x26,0x93,0x2b,0x29,0xa5,0xf,0x11,0x42,0xce,0x77,0x52,0x3f,0xe8,0x87,0x6d, + 0x68,0x68,0x8,0xa7,0x4f,0x9f,0x36,0x5d,0x82,0x4b,0x8,0x81,0x24,0x49,0xf8,0x9b, + 0x2f,0xfd,0x15,0x3e,0xf2,0xb6,0x7f,0x40,0x93,0xd4,0x32,0x7d,0xbe,0xdb,0xce,0xc8, + 0xf8,0xb5,0x3a,0x48,0xeb,0xd5,0x4a,0x97,0x68,0xac,0xd7,0xc2,0x27,0xa6,0x6d,0x33, + 0x20,0xd8,0x8a,0x72,0x28,0x40,0x53,0x4,0xdb,0x7f,0xf9,0x4,0xee,0xfe,0xe6,0xf7, + 0x31,0x36,0x66,0xee,0x26,0x2d,0x4e,0xac,0x59,0xed,0x5e,0x1c,0x72,0x84,0x3,0x5, + 0xf0,0xb9,0xbd,0x7b,0xf7,0xde,0xe1,0x4a,0xe8,0xc,0xc5,0x19,0x41,0xb8,0x5b,0xb6, + 0x6c,0xb9,0x9c,0x10,0xf2,0x2b,0x0,0xb,0x9d,0xd4,0xf,0x92,0x6c,0xb3,0xd9,0x2c, + 0x7a,0x7a,0x7a,0x30,0x39,0x69,0x1e,0xb,0x4e,0x8,0xc1,0xd,0xef,0xdf,0x8a,0x3b, + 0x3e,0xf1,0x59,0xac,0xa9,0x3b,0xc7,0x1d,0x1,0x70,0xeb,0xd5,0xbb,0x4c,0xd6,0x3, + 0x6,0x43,0xeb,0xd5,0x75,0x59,0x5,0xc6,0x4e,0x4d,0xe0,0xe7,0x77,0xfe,0x27,0x1e, + 0xfe,0xef,0x87,0x4d,0xb7,0x96,0x2f,0xe6,0xe6,0xf5,0xb3,0x25,0x90,0xdb,0xfa,0x36, + 0x75,0xef,0x6e,0x6b,0x6b,0x7b,0xef,0xf6,0xed,0xdb,0x2b,0x27,0x1,0x99,0xe1,0x98, + 0xf5,0x84,0xdb,0xd1,0xd1,0xb1,0x45,0x55,0xd5,0x5f,0x11,0x62,0xbf,0xcc,0x2a,0xc8, + 0x87,0x4d,0x55,0x55,0xf4,0xf6,0xf6,0x62,0x60,0x60,0xc0,0xf2,0xbc,0x35,0xd7,0xac, + 0xc4,0x1d,0xdf,0xfd,0x14,0x6e,0x58,0x72,0x33,0x58,0x5b,0xaf,0xda,0x72,0xd4,0xd6, + 0xab,0xae,0x1c,0xb1,0xf5,0xaa,0x3d,0x1e,0xb5,0xf5,0xca,0x4c,0x97,0x62,0x39,0x4f, + 0xb0,0xbb,0x73,0x37,0xee,0xfa,0xf8,0xf,0x70,0xb2,0xe7,0x64,0xe9,0x7b,0x2d,0xc1, + 0x16,0xf3,0x34,0x4,0xb9,0x54,0xd8,0x45,0xfd,0x9f,0x27,0x12,0x89,0xb7,0x77,0x76, + 0x76,0x3a,0x4b,0x2a,0x3c,0x3,0x31,0xab,0x9,0x77,0xcb,0x96,0x2d,0xaf,0x7,0x70, + 0x7f,0xa5,0x4d,0x1d,0x8b,0x8,0xf2,0x61,0x9b,0x98,0x98,0xc0,0x89,0x13,0x27,0x2c, + 0xf7,0x7,0xab,0x9b,0x5f,0x8b,0x8f,0xdd,0xf3,0x21,0xdc,0x7e,0xd5,0xfb,0x10,0x27, + 0x71,0xf3,0x4e,0x17,0x81,0xf5,0xaa,0x2d,0x47,0x6d,0xbd,0xfa,0xd1,0x25,0x90,0x81, + 0xc4,0x66,0x89,0x72,0x14,0x83,0x97,0x95,0xfc,0xec,0x78,0xe,0xf7,0xde,0x7d,0x1f, + 0x1e,0xfe,0xd6,0xa3,0x96,0xcf,0x6e,0x31,0x33,0x99,0x13,0x4,0x4c,0xcc,0x8f,0x3, + 0xb8,0xa5,0xab,0xab,0xcb,0x38,0x83,0x3c,0xb,0x30,0x6b,0x9,0x77,0xcb,0x96,0x2d, + 0x6f,0x27,0x84,0xfc,0x10,0x8c,0x97,0xe9,0xba,0xb5,0x6a,0xfb,0xfa,0xfa,0xd0,0xdf, + 0xdf,0x6f,0x79,0xde,0x9b,0xee,0xf8,0x73,0x7c,0xf2,0x7d,0x9f,0xc2,0xfc,0xd8,0x42, + 0x26,0x4,0x5b,0x4d,0x4,0xc0,0xad,0xd7,0x60,0x7,0x2f,0x57,0xf2,0x29,0x70,0xf0, + 0xd5,0x83,0xf8,0xd6,0x7,0xee,0xc2,0xc9,0x3,0xe6,0x4b,0x85,0x5,0x41,0x40,0x5d, + 0x5d,0x9d,0xa5,0x6f,0x17,0x8,0xae,0xaf,0x94,0xd5,0x7d,0x32,0x9b,0xcd,0xbe,0xf6, + 0xd0,0xa1,0x43,0xb3,0x6e,0xc3,0xca,0x59,0x49,0xb8,0x1d,0x1d,0x1d,0x7f,0x4d,0x29, + 0xbd,0xb,0x11,0x92,0x6d,0x3a,0x9d,0xc6,0xf1,0xe3,0xc7,0x2d,0xad,0xda,0x45,0x17, + 0x2e,0xc0,0x17,0x7f,0xfa,0x39,0x6c,0x5b,0x7a,0x4b,0xe4,0xd6,0xab,0xb6,0x1c,0xb5, + 0xf5,0xea,0x56,0x97,0x20,0xad,0x57,0x2b,0x5d,0x22,0x19,0xbc,0x74,0x65,0xef,0x83, + 0x44,0x5a,0x4e,0xe3,0xa7,0xf7,0xfd,0x4,0x7f,0xfc,0xe7,0xa7,0xd,0xcf,0x73,0xd1, + 0xd5,0x90,0x48,0x24,0x10,0x8b,0xc5,0xa2,0x8e,0xdd,0xed,0x54,0x14,0xe5,0x86,0x57, + 0x5e,0x79,0x65,0x56,0xed,0x24,0x31,0xeb,0x8,0xb7,0xa3,0xa3,0xe3,0x3,0x94,0xd2, + 0xaf,0xc3,0xe6,0xda,0x82,0xf4,0xd7,0xf6,0xf7,0xf7,0xe3,0xf4,0xe9,0xd3,0xa6,0xe7, + 0x8,0x92,0x80,0xbf,0xf9,0xce,0xdb,0xf1,0xf,0xb7,0x7e,0x2,0xd,0x42,0x23,0x13, + 0x32,0x8a,0x8a,0x0,0x60,0xf3,0x5a,0x1d,0x85,0x25,0x17,0xb5,0xf5,0xea,0x4b,0x17, + 0x3f,0xf2,0x5d,0xc6,0x52,0x3f,0x7f,0xe4,0x19,0xdc,0xf5,0xb7,0xf7,0x20,0x7d,0xd8, + 0x7c,0x37,0x62,0x49,0x92,0x4a,0x7b,0xad,0x45,0x38,0x91,0xf6,0xb2,0xaa,0xaa,0xd7, + 0xed,0xdb,0xb7,0xcf,0x3a,0x7b,0xcf,0xc,0xc3,0xac,0x22,0xdc,0x64,0x32,0xf9,0x51, + 0x0,0xff,0x86,0x88,0xc8,0x56,0x96,0x65,0x1c,0x3f,0x7e,0xdc,0x32,0x1c,0xe7,0xac, + 0x8e,0x55,0xf8,0xe6,0xf,0xee,0xc4,0x85,0x73,0x2f,0xd,0xbe,0x3,0x32,0x26,0x0, + 0x6e,0xbd,0x56,0xbf,0xf5,0xea,0xb6,0x3c,0x28,0xf7,0xe1,0xce,0x1f,0x7e,0x1d,0x47, + 0xbe,0xda,0xb,0x98,0x64,0xfa,0x24,0x84,0x20,0x91,0x48,0x44,0x9d,0x97,0xe1,0x15, + 0x51,0x14,0x5f,0xb3,0x7b,0xf7,0xee,0x1e,0x57,0x8d,0x57,0x29,0x66,0xd,0xe1,0x6e, + 0xd9,0xb2,0xe5,0xbd,0x84,0x90,0x6f,0x81,0x21,0xd9,0xba,0xa9,0x3b,0x31,0x31,0x81, + 0x63,0xc7,0x8e,0x99,0x6e,0x1a,0x28,0x8,0x2,0xde,0xff,0xdd,0x77,0xe3,0xc3,0x6f, + 0xf8,0x7,0x24,0x48,0xd,0xfb,0xe,0x18,0x40,0xd9,0x8c,0x60,0xa3,0xb6,0x5e,0x5d, + 0xeb,0x12,0x52,0x68,0x56,0xd4,0xd6,0xab,0x5b,0x5d,0xb4,0x32,0x65,0xc8,0x78,0xa0, + 0xeb,0x67,0xf8,0xdd,0x7b,0x9e,0x0,0xed,0x33,0xf7,0xdd,0xc6,0x62,0x31,0xdb,0x6d, + 0xdd,0x3,0xb6,0x82,0xbb,0x64,0x59,0x4e,0x1e,0x38,0x70,0x60,0xc0,0x95,0x90,0x2a, + 0xc4,0xac,0x20,0xdc,0x64,0x32,0xf9,0xb7,0x0,0xbe,0x8d,0x88,0xc8,0xf6,0xd4,0xa9, + 0x53,0xe8,0xef,0xef,0x37,0xfd,0x6e,0xd1,0xfa,0x5,0xf8,0xf2,0x83,0xff,0x1f,0xb6, + 0x2c,0xb8,0x8e,0x39,0xe9,0x58,0x95,0xa3,0xb6,0x5e,0x9d,0xe8,0x12,0x96,0xf5,0xaa, + 0x2f,0x47,0x6d,0xbd,0x4e,0xeb,0x10,0xb4,0xf5,0xea,0xe6,0x5e,0x53,0x50,0x3c,0x3e, + 0xf9,0x3b,0xfc,0xe4,0x53,0xf7,0x81,0xfe,0x5a,0x1f,0xa9,0x50,0x74,0x35,0x8,0x82, + 0x60,0xb9,0x9d,0x7b,0x18,0xe1,0x64,0x84,0x90,0x3d,0x8a,0xa2,0x74,0xcc,0x74,0x9f, + 0xae,0xed,0xa4,0x52,0xb5,0x23,0x99,0x4c,0xbe,0x95,0x52,0x7a,0x37,0x21,0xc4,0x7a, + 0x6a,0x15,0xc1,0x3c,0x14,0x8a,0xa2,0xe0,0xe8,0xd1,0xa3,0x96,0xdb,0xa2,0xbc,0xee, + 0xff,0x6d,0xc3,0x8f,0xbe,0xf3,0x63,0x9c,0xd3,0x70,0x7e,0x5,0x2,0xd0,0x76,0xc0, + 0xe9,0x32,0xf5,0x51,0x36,0xca,0x71,0x66,0xbd,0x6,0x51,0xd6,0x8,0xb5,0xd5,0xcb, + 0x55,0xdb,0xd4,0xbe,0x8e,0xf1,0xfe,0x3a,0x93,0xcf,0xea,0xbe,0x54,0xfa,0x7d,0x4b, + 0x72,0x5c,0x5a,0xaf,0x7e,0x64,0x56,0xfa,0x8d,0x56,0xc6,0xd6,0xe0,0xec,0xeb,0x56, + 0xa1,0x73,0xcd,0x13,0x50,0x9e,0x11,0x81,0x2c,0x31,0x2c,0x88,0xc8,0xe7,0xf3,0x10, + 0x45,0x51,0x17,0xc5,0x10,0xe2,0x44,0xda,0x2,0x42,0x48,0xb2,0xa5,0xa5,0xe5,0xe7, + 0x83,0x83,0x83,0x33,0x76,0x93,0xca,0x19,0x6d,0xe1,0x6e,0xd9,0xb2,0xe5,0x36,0x42, + 0xc8,0x7d,0xa8,0x30,0x70,0x4,0xf5,0xaa,0x93,0xc9,0x64,0x70,0xf4,0xe8,0x51,0xd3, + 0xfd,0xc4,0x6a,0x5b,0x6a,0xf0,0xaf,0xf,0xff,0x33,0x6e,0x3d,0xe7,0x8d,0x9e,0x49, + 0xc7,0xaa,0xec,0xda,0xba,0xe1,0xd6,0x6b,0x68,0x65,0x5b,0x72,0x9f,0x1,0x2b,0x1, + 0x7,0xd5,0x7e,0x7c,0xed,0xf8,0x17,0x70,0xea,0xe3,0xe3,0x10,0x76,0x9a,0xc7,0xe5, + 0xc6,0x62,0x31,0xc4,0xe3,0xf1,0x48,0x92,0xe0,0x50,0x4a,0xff,0x37,0x16,0x8b,0x5d, + 0xbf,0x7b,0xf7,0xee,0x9,0xc7,0xd,0x56,0x11,0x66,0xac,0x85,0xdb,0xd1,0xd1,0x71, + 0x13,0xa5,0xf4,0x1,0x42,0x88,0xe5,0xa6,0x4e,0x41,0x3d,0x10,0xc3,0xc3,0xc3,0xe8, + 0xee,0xee,0x36,0xcd,0x83,0xb0,0x72,0xe3,0x32,0xfc,0xe4,0xf7,0xf7,0x60,0xf3,0xe2, + 0x6b,0xe1,0xd6,0xd2,0x70,0x52,0x2e,0xe9,0xeb,0x91,0x60,0xfd,0xca,0x37,0xd3,0xc5, + 0x2b,0xd9,0x59,0xb6,0x1d,0x92,0xf5,0xea,0xe7,0xbe,0x54,0xb2,0x24,0x4b,0x6d,0xfb, + 0x88,0xa5,0x76,0x2b,0xd3,0xeb,0xf3,0x52,0x5e,0xae,0x25,0x75,0xb8,0x72,0xee,0x35, + 0x38,0xb0,0xad,0x13,0x3,0xe3,0xfd,0x10,0xf6,0x18,0x49,0x57,0x55,0x55,0xa8,0xaa, + 0xa,0x51,0x14,0x2b,0x6e,0xf5,0x64,0x76,0x1f,0xfc,0xd6,0x25,0x84,0x2c,0xa3,0x94, + 0x5e,0x3e,0x77,0xee,0xdc,0x7,0x52,0xa9,0x94,0xfd,0xa6,0x7e,0x55,0x86,0x19,0x49, + 0xb8,0x1d,0x1d,0x1d,0x5b,0x28,0xa5,0xbf,0x22,0x84,0x58,0x2e,0x8d,0x9,0x8a,0x6c, + 0x7b,0x7b,0x7b,0x71,0xf2,0xe4,0x49,0xd3,0x73,0xde,0xf2,0x2f,0xb7,0xe1,0xee,0xaf, + 0xfc,0x0,0xb,0x13,0x8b,0xe1,0x97,0xc,0x1c,0x75,0x7a,0x1a,0x7c,0x7,0x34,0xc8, + 0xf4,0xd0,0xe9,0x6d,0x75,0x71,0x31,0xb9,0xe5,0x57,0xa6,0xd7,0xfb,0x62,0x36,0xa8, + 0xb8,0x1d,0x24,0xdc,0xea,0xe2,0x66,0x20,0x63,0x75,0x2f,0x40,0x29,0x62,0x88,0xe1, + 0xaa,0x78,0x3b,0x4e,0x6c,0x3c,0x84,0x9e,0x73,0xf,0x42,0x7c,0xba,0xe,0xc8,0x19, + 0x89,0x55,0x51,0x94,0x8a,0xa4,0x1b,0xe0,0x44,0xda,0x1a,0x41,0x10,0xd6,0xaf,0x5f, + 0xbf,0xfe,0x17,0xdd,0xdd,0xdd,0x33,0x6a,0xf7,0x88,0x19,0x47,0xb8,0xc9,0x64,0x72, + 0x2d,0xa5,0xf4,0xd1,0x4a,0xb9,0x11,0x82,0x20,0x5b,0x4a,0x29,0x8e,0x1d,0x3b,0x86, + 0xc1,0x41,0xa3,0xcf,0x5e,0x4c,0x88,0xf8,0xf4,0xc3,0x1f,0xc7,0x47,0x6f,0xf9,0x38, + 0x44,0x52,0xb8,0xa5,0x41,0x10,0x40,0x98,0xd6,0xab,0x9e,0x60,0xad,0x65,0xba,0xd6, + 0xc5,0x93,0xf5,0x1a,0xfc,0xe0,0xe5,0x54,0xbe,0xf6,0x3a,0xbc,0xe8,0x62,0xa5,0x97, + 0xdf,0x81,0xcc,0xab,0x2e,0xfa,0x58,0xea,0xe9,0x32,0x1,0xc1,0x25,0xe2,0x95,0xe8, + 0x5f,0x7e,0x2,0xdd,0x1d,0x5d,0x10,0x76,0xd4,0x82,0xa4,0xc4,0x52,0x7e,0xdd,0x22, + 0x14,0x45,0x81,0x20,0x8,0xa1,0x2d,0x92,0xd0,0xd4,0x5f,0x3b,0x3e,0x3e,0xde,0x3c, + 0x30,0x30,0xf0,0x5b,0x57,0x27,0x47,0x8c,0x19,0x45,0xb8,0xc9,0x64,0x72,0x29,0x80, + 0x27,0x8,0x21,0xb,0xcc,0xbe,0xf,0x32,0xbe,0xf6,0xf0,0xe1,0xc3,0xa6,0x9,0xc2, + 0x5b,0xcf,0x6e,0xc6,0x8f,0x9e,0xbe,0x1b,0xdb,0xce,0x9a,0xde,0x7f,0x92,0x5,0x19, + 0x84,0x65,0xbd,0xea,0xcb,0xfe,0x3a,0xbd,0xa9,0x2e,0x1e,0x43,0xb3,0x58,0xe,0x1e, + 0x5e,0xe4,0xeb,0x74,0x61,0x68,0xbd,0xea,0xef,0x75,0x65,0xbd,0x58,0xc,0x1e,0x4e, + 0x9f,0x29,0xf3,0xfb,0x2,0x5c,0x2c,0x5e,0x81,0xfc,0xdc,0xc,0xf6,0xdf,0xb4,0x3, + 0xc2,0x89,0x18,0x84,0x57,0x8d,0x69,0x49,0x8a,0xa4,0x5b,0x9c,0x4c,0xb,0x2b,0x9, + 0xe,0x21,0xe4,0xca,0x79,0xf3,0xe6,0x65,0x6,0x6,0x6,0x9e,0x76,0xd5,0x48,0x84, + 0x98,0x31,0x84,0x9b,0x4c,0x26,0xe7,0x50,0x4a,0x7f,0x47,0x8,0x39,0xd7,0xec,0xfb, + 0xa0,0xc8,0x36,0x9b,0xcd,0xe2,0xf0,0xe1,0xc3,0xa6,0x93,0x63,0x4b,0x37,0x2f,0xc2, + 0x8f,0x7e,0xfd,0x7d,0xac,0x9b,0x7b,0x61,0xa1,0x4d,0x1f,0x64,0xe0,0x66,0x72,0x8b, + 0x6d,0xa7,0xf7,0x47,0xd8,0xba,0xb6,0x7d,0x5a,0xaf,0x6e,0x48,0xd2,0xeb,0x7d,0x71, + 0x24,0x9f,0xb2,0xd5,0x25,0x90,0x81,0xcc,0x41,0xd9,0xca,0x7a,0x75,0x2b,0xf3,0x3c, + 0xf1,0x2,0x64,0x63,0x19,0xec,0x4f,0x76,0x2,0x12,0x20,0xee,0xa8,0x45,0x39,0x14, + 0x45,0x31,0x58,0xbf,0x76,0x60,0x44,0xcc,0x5b,0xe7,0xcf,0x9f,0x7f,0xa8,0xbf,0xbf, + 0x7f,0x8f,0xe3,0xc6,0x22,0xc4,0x8c,0x20,0xdc,0x64,0x32,0x29,0xd1,0xc2,0x4e,0xd, + 0xed,0x66,0xdf,0x7,0x35,0xa2,0x4e,0x4e,0x4e,0xa2,0xbb,0xbb,0xdb,0x74,0x31,0xc3, + 0x35,0xef,0xbf,0xc,0x3f,0xfe,0x8f,0x9f,0x60,0x71,0x62,0x59,0xa1,0x5d,0x17,0x4, + 0xe0,0xc5,0x7a,0xf5,0x4b,0x0,0x2c,0x3b,0xbd,0x96,0x98,0xec,0xe4,0xdb,0x59,0x72, + 0xbe,0xe4,0x3b,0xb8,0x2f,0x76,0xf2,0xb5,0xd7,0xc1,0x4a,0x17,0x47,0x32,0x19,0xdf, + 0x17,0xb7,0xd6,0xab,0x5b,0x5d,0xce,0x13,0x2f,0x40,0x9e,0xe4,0x70,0xe0,0xc2,0x97, + 0xa0,0x6e,0xc8,0x42,0xdc,0x5e,0xf,0x92,0x37,0x77,0x23,0x54,0x4a,0x7e,0x53,0x5e, + 0xd7,0x9,0x6c,0xea,0x12,0x0,0x37,0xb5,0xb6,0xb6,0x6e,0x1f,0x1c,0x1c,0x3c,0xee, + 0xb8,0xd1,0x88,0x30,0x23,0x8,0x77,0xc5,0x8a,0x15,0xff,0x41,0x8,0x79,0xb3,0xd9, + 0x77,0x41,0x91,0xed,0xc8,0xc8,0x8,0x8e,0x1e,0x3d,0xaa,0xdb,0xa2,0xbc,0x88,0x9b, + 0xbf,0xfc,0x1a,0xdc,0xf9,0x91,0x6f,0xa3,0x4e,0x98,0xe3,0x88,0x0,0xbc,0x86,0x66, + 0xf9,0xef,0xf4,0xc,0x3b,0x1d,0x43,0xeb,0xd5,0x8e,0x24,0xbd,0xde,0x17,0x47,0xf2, + 0x2b,0x5c,0x87,0xb7,0x7b,0x14,0xc0,0x40,0xe6,0x40,0x7e,0x14,0xb1,0xd4,0x6b,0xc5, + 0x75,0x18,0xa6,0x29,0x1c,0x5d,0x72,0x10,0xca,0xa6,0x49,0x48,0x4f,0xd6,0x83,0x4c, + 0x8,0x3a,0xcb,0x96,0x52,0xa,0x4a,0xa9,0xa9,0x5f,0x77,0x5a,0x75,0xe6,0x7d,0x56, + 0x22,0x84,0xbc,0xae,0xad,0xad,0xed,0x97,0x3,0x3,0x3,0x55,0xbd,0x30,0xa2,0xea, + 0xe3,0x70,0x93,0xc9,0xe4,0x87,0x0,0x7c,0xcd,0xec,0xbb,0x20,0xc3,0xbe,0x8e,0x1f, + 0x3f,0x6e,0x3c,0x47,0x0,0xde,0xf9,0xf3,0x37,0xe3,0xe3,0x5b,0x3f,0xd,0x1,0x82, + 0xe9,0x43,0x19,0x64,0xdc,0x6b,0xa5,0x32,0x4b,0x72,0x2d,0x5c,0x86,0x73,0x99,0x56, + 0x75,0xc2,0xba,0x66,0x27,0xd7,0x11,0xaa,0x4c,0xc6,0xf7,0xa5,0x9a,0x62,0xa9,0x15, + 0x28,0xf8,0x61,0xf6,0x5b,0xe8,0x54,0x9e,0x1,0xe9,0x97,0x50,0xf3,0xc1,0x45,0x10, + 0xe,0x18,0x97,0xfd,0xa,0x82,0x80,0x58,0x4c,0x1f,0xb1,0x19,0x42,0x12,0x9c,0xc3, + 0xb2,0x2c,0x5f,0x75,0xe8,0xd0,0x21,0xf3,0x65,0x9f,0x55,0x80,0xaa,0xb6,0x70,0x3b, + 0x3a,0x3a,0x6e,0x0,0x70,0xf,0x0,0xdd,0x3b,0x4a,0x90,0x3f,0x5c,0x2a,0x95,0x42, + 0x4f,0x4f,0x8f,0xe1,0x1c,0xa1,0x8e,0xe0,0xd3,0xdb,0xff,0x11,0xef,0xbd,0xe2,0x43, + 0x85,0x36,0x8b,0xf,0x61,0x55,0x58,0xaf,0xfe,0x48,0x85,0x5b,0xaf,0x56,0x65,0xf7, + 0xd7,0xec,0xa4,0x6c,0x27,0xbf,0x9a,0x57,0x2,0x12,0x10,0x5c,0x20,0x5d,0x8a,0x1e, + 0xf5,0x28,0x7a,0x6b,0x4f,0x40,0xd9,0x36,0xe,0xe1,0x40,0x2,0xc2,0x71,0x23,0xb9, + 0x52,0x4a,0x21,0x8a,0x62,0xe9,0xb3,0x53,0xf8,0xe8,0xdf,0xcd,0x84,0x90,0x4b,0x36, + 0x6c,0xd8,0x70,0x6f,0xb5,0x86,0x8b,0x55,0x2d,0xe1,0xb6,0xb7,0xb7,0x9f,0x47,0x8, + 0x79,0x14,0x80,0xce,0x43,0x1f,0xe4,0xf,0x37,0x30,0x30,0x80,0x13,0x27,0x4e,0x18, + 0x8e,0xc7,0xe6,0x4a,0xf8,0xb7,0xff,0xfd,0x3c,0xde,0xb0,0xea,0x4d,0x60,0xd5,0x1, + 0x4b,0x3a,0x3a,0xe9,0x80,0x26,0xc7,0x7d,0x75,0x34,0x7,0x93,0x42,0x6e,0x2c,0xb9, + 0xc8,0x8,0x80,0x31,0x31,0x19,0x9,0xd6,0xd9,0xf5,0xfb,0xb9,0x2f,0x4e,0xfd,0xf9, + 0x2c,0x75,0xf1,0x3b,0x90,0x10,0x10,0xac,0x17,0x2f,0x46,0x97,0xba,0xb,0xa3,0xd2, + 0x30,0xe4,0x6b,0xc7,0x21,0x1e,0x49,0x40,0xe8,0xd6,0x47,0x30,0x68,0xdd,0xb,0x4e, + 0xe1,0xb7,0x7f,0x13,0x42,0x56,0x8f,0x8f,0x8f,0xb7,0x54,0x6b,0xb8,0x58,0x55,0x12, + 0xee,0xb6,0x6d,0xdb,0x1a,0x15,0x45,0xf9,0x3,0x80,0xc5,0xda,0xe3,0x41,0x2e,0x25, + 0xec,0xef,0xef,0xc7,0xa9,0x53,0xc6,0xb4,0x9b,0x35,0x8b,0xe2,0xb8,0xf3,0xe9,0x2f, + 0xe1,0x35,0xb,0x6f,0x9a,0xae,0xcf,0xb8,0xd3,0x79,0xe9,0xc,0xae,0x74,0xb1,0x99, + 0x14,0xf2,0xdb,0x1,0xfd,0xde,0x17,0x47,0xf2,0x1d,0x86,0x66,0xb9,0xd1,0x85,0xd5, + 0xe0,0xe9,0x46,0x97,0xd9,0x12,0x4b,0x2d,0x42,0xc4,0x5a,0x71,0x3,0x5e,0x54,0x9e, + 0x45,0x4e,0xcc,0x42,0xde,0x3a,0xe,0xa1,0x5f,0x82,0xb0,0x7f,0xda,0xbd,0xa0,0xf5, + 0xeb,0x3a,0x89,0x60,0x60,0xd8,0xbf,0xaf,0x68,0x6d,0x6d,0x3d,0x36,0x38,0x38,0xf8, + 0x92,0xe3,0x6,0x43,0x42,0x35,0x12,0x2e,0x59,0xba,0x74,0xe9,0xfd,0x0,0x36,0x69, + 0xf,0x6,0x49,0xb6,0xa9,0x54,0xca,0x9c,0x6c,0x97,0xc5,0xf0,0xad,0x27,0xee,0xc4, + 0xa6,0x96,0x8e,0x42,0x5d,0x46,0x9d,0xce,0xac,0xd3,0x6b,0x8f,0xfb,0xea,0x68,0xe, + 0x5e,0xab,0xdd,0x74,0xc0,0xc8,0x8,0x20,0x70,0xeb,0x95,0xdd,0x80,0x61,0x29,0x73, + 0x96,0xaf,0x4,0xac,0x21,0xb5,0x58,0x25,0x9c,0x8d,0x17,0x95,0x67,0xa1,0xa,0x2a, + 0x94,0xf6,0x9,0x90,0x71,0x1,0x52,0x57,0xad,0xe9,0x42,0x88,0x30,0xb7,0xee,0x21, + 0x84,0xdc,0xd0,0xda,0xda,0xfa,0xbb,0xc1,0xc1,0xc1,0x93,0xb6,0x95,0x43,0x44,0xd5, + 0x11,0x6e,0x32,0x99,0xfc,0x38,0x80,0xbf,0x2b,0x7e,0xe,0xda,0xd1,0x9e,0x4a,0xa5, + 0x4c,0xdd,0x8,0xf5,0xe7,0xd6,0xe0,0x7b,0x8f,0xff,0x7,0x2e,0x6f,0xdc,0x58,0xa8, + 0xcb,0xa2,0x3,0x3a,0xec,0xc,0x95,0xe4,0x18,0xca,0x36,0xc4,0xe4,0xb7,0x3,0xba, + 0xd2,0xc5,0xb4,0xec,0x40,0x7e,0x80,0xd6,0xab,0xd5,0x7d,0xf1,0x5b,0x36,0x95,0x19, + 0x59,0x2c,0xb5,0xf3,0xfb,0x62,0xab,0x8b,0x4b,0x7f,0xfe,0x5c,0xd2,0x8c,0x56,0x61, + 0x1e,0x76,0x2b,0x9d,0x0,0x1,0x94,0xab,0x27,0x1,0x10,0x88,0x2f,0x1a,0x63,0x75, + 0x8b,0xf9,0x17,0xb4,0x8,0xb0,0x7f,0x4b,0x0,0x6e,0x6c,0x6d,0x6d,0xfd,0xe9,0xe0, + 0xe0,0xe0,0xa4,0x2b,0x21,0x1,0xa2,0xaa,0x8,0x37,0x99,0x4c,0xde,0x48,0x29,0xfd, + 0x1,0x99,0x1a,0x1e,0x83,0x26,0xdb,0xe1,0xe1,0x61,0xf4,0xf4,0x18,0x13,0xc9,0xcf, + 0x39,0xbf,0x6,0xdf,0xf9,0xdd,0xbf,0xe3,0xe2,0x39,0x97,0xfb,0xeb,0x80,0xac,0x3b, + 0x9d,0xe3,0xce,0x60,0x2d,0x93,0x99,0x2e,0xe,0x3a,0xa3,0xa5,0x4c,0xc6,0xaf,0xd5, + 0x81,0xc,0x64,0x76,0x32,0xcf,0xf0,0x58,0x6a,0x6d,0x1b,0xb,0x85,0xc5,0x18,0xc6, + 0x10,0x4e,0xa8,0xc7,0x0,0x0,0xca,0xa5,0x69,0xd0,0x4,0x85,0xf4,0x7c,0x1d,0xca, + 0xa1,0xb5,0x74,0x43,0x88,0x5a,0x98,0x4b,0x8,0xb9,0x74,0x70,0x70,0xf0,0x67,0xba, + 0x8b,0x88,0x10,0x55,0x43,0xb8,0xc9,0x64,0x72,0x29,0xa5,0xf4,0xb7,0x84,0x90,0x39, + 0x80,0xa7,0x9b,0xeb,0xaa,0xfe,0xc8,0xc8,0x88,0x29,0xd9,0xd6,0xae,0x49,0xe0,0x1b, + 0x8f,0x7e,0x5,0x97,0x35,0x5c,0x15,0x48,0xa7,0x77,0xd5,0xe9,0x2,0xb6,0x5e,0x43, + 0x21,0x0,0xf,0xcb,0x62,0xed,0xe4,0xdb,0x11,0x0,0xcb,0xf2,0xb4,0xa0,0x2a,0x1d, + 0xbc,0xdc,0xe8,0x12,0xe0,0x4a,0xc0,0x73,0xc4,0xf3,0xf1,0x8a,0xba,0x17,0x63,0x74, + 0x4,0x0,0xa0,0x5e,0x94,0x81,0x99,0xa5,0x5b,0xdc,0x23,0x2d,0xa8,0x15,0x69,0x26, + 0xf5,0x57,0xcf,0x9b,0x37,0xf,0x3,0x3,0x3,0xdb,0x5d,0x35,0x12,0x10,0xaa,0x82, + 0x70,0x2f,0xbd,0xf4,0xd2,0x58,0x22,0x91,0x78,0x8c,0x10,0x72,0x36,0x10,0x1c,0xd9, + 0x16,0xeb,0x8e,0x8d,0x8d,0xe1,0xd8,0xb1,0x63,0x86,0x73,0x63,0xcb,0x5,0x7c,0xf9, + 0xf1,0x2f,0xe2,0xea,0xc6,0x2d,0xb6,0x4,0x60,0xd6,0xe9,0xad,0xca,0x8e,0x3a,0x5a, + 0x80,0xd6,0xab,0x6b,0x5d,0xfc,0x10,0x0,0x63,0x62,0xf2,0x4a,0x0,0x7e,0xee,0x4b, + 0x34,0xd6,0x6b,0xf1,0x5a,0xfd,0xf,0x9e,0xda,0x67,0xca,0xa9,0x4c,0x27,0xf7,0xa5, + 0x52,0x59,0x80,0x80,0x55,0xe2,0xd9,0xe8,0x94,0x9f,0x81,0x32,0xb5,0x41,0x9a,0x72, + 0x69,0x1a,0xc8,0x13,0x88,0x2f,0x15,0x48,0xb7,0x9c,0x64,0x43,0x4c,0xed,0xd8,0xde, + 0xd2,0xd2,0xb2,0x23,0x95,0x4a,0x1d,0x74,0xdc,0x58,0x40,0xa8,0xa,0xc2,0x3d,0xf7, + 0xdc,0x73,0x3f,0xd,0xe0,0x2d,0x40,0xf0,0x64,0x9b,0x4e,0xa7,0xd1,0xdd,0xdd,0x5d, + 0x9e,0x4,0x3,0xc2,0x2,0xe0,0x8b,0xdb,0x3f,0x83,0x6b,0x9b,0x6f,0x2c,0xd4,0xf7, + 0xd0,0xe9,0x5d,0x75,0x40,0xdb,0xce,0xe0,0x4f,0x26,0xb,0x32,0xb0,0x95,0xef,0x33, + 0xa9,0x4b,0x25,0x99,0x56,0x75,0xfc,0x5e,0xbf,0x35,0xc1,0x3a,0xbf,0x2f,0x4c,0x64, + 0x56,0xf8,0x7d,0x3d,0xe9,0x52,0x5,0xb1,0xd4,0x75,0xa4,0x1e,0xd,0xa4,0x11,0xfb, + 0xd4,0xdd,0xa5,0x63,0xca,0x15,0x69,0x90,0x49,0x11,0xd2,0x5e,0xa3,0x4f,0x17,0xa8, + 0x4c,0xba,0x2c,0x97,0xff,0x12,0x42,0xae,0x5b,0xb4,0x68,0xd1,0x4f,0xfa,0xfa,0xfa, + 0x22,0x4d,0x5c,0x1e,0x39,0xe1,0x6e,0xd9,0xb2,0x65,0x23,0x21,0xe4,0x87,0x94,0x52, + 0xe7,0xc1,0x7a,0xf0,0xf6,0x63,0x64,0xb3,0x59,0x1c,0x39,0x72,0x44,0xb7,0x5c,0x97, + 0x10,0x2,0xd2,0x44,0xf1,0xc1,0x3f,0xbc,0x7,0x6f,0x58,0xf8,0x97,0xc5,0x33,0xa6, + 0xcf,0x65,0xd1,0xe9,0x3c,0x75,0x6,0x67,0xf2,0x5d,0xeb,0xe2,0x87,0x0,0x22,0xb2, + 0x5e,0xbd,0x12,0x80,0x35,0xb9,0xb2,0x19,0xc8,0xdc,0xe8,0xc2,0x7c,0xf0,0x64,0x10, + 0x4b,0xed,0x4b,0xbe,0x45,0x79,0x91,0xb0,0x14,0xbd,0xf4,0x24,0xfa,0xe9,0xe9,0x92, + 0x3c,0xe5,0xca,0x49,0x8,0x7d,0x12,0xc4,0xfd,0xe6,0xe9,0xab,0x43,0xda,0x27,0xad, + 0x5e,0x55,0xd5,0xb3,0x7,0x7,0x7,0xef,0x77,0xdc,0x70,0x0,0x88,0x94,0x70,0xb7, + 0x6d,0xdb,0xd6,0x28,0xcb,0xf2,0x63,0x94,0xd2,0x56,0xa7,0xe7,0x78,0xf5,0xe7,0xc8, + 0xb2,0x8c,0x23,0x47,0x8e,0xe8,0x12,0xd1,0x10,0x42,0x80,0x7a,0x8a,0x77,0x3c,0xfa, + 0xe7,0x78,0xcf,0xaa,0xf,0x78,0xea,0xc,0x25,0x39,0xda,0xb2,0x8b,0x57,0x39,0x66, + 0x1d,0xd0,0x23,0x1,0x68,0x8f,0x57,0xea,0xd0,0x2c,0x74,0x61,0x3e,0x90,0x39,0x28, + 0xb3,0x58,0x16,0xeb,0x5a,0x66,0xd9,0x6f,0xea,0x77,0x20,0x2d,0x5c,0x46,0x75,0xc, + 0x5e,0x56,0xf7,0x45,0x2b,0x7f,0x95,0x70,0x36,0x5e,0x52,0x9e,0x47,0xe,0x53,0x5b, + 0x8f,0x11,0x40,0xbe,0x66,0x2,0xc2,0xd1,0x38,0xc4,0xc3,0xe6,0xcb,0x80,0xcb,0xaf, + 0xd3,0x29,0x5c,0x12,0xf3,0xda,0xd6,0xd6,0xd6,0x53,0x83,0x83,0x83,0x9d,0xae,0x84, + 0x30,0x44,0xa4,0x84,0xbb,0x74,0xe9,0xd2,0xef,0x50,0x4a,0x3b,0x9c,0xd6,0xf7,0x3a, + 0xea,0x51,0x4a,0xd1,0xdd,0xdd,0x8d,0x4c,0x26,0x53,0x3a,0x46,0x8,0x1,0x24,0xe0, + 0xba,0xff,0xbc,0xa,0x9f,0xb8,0xf0,0x73,0xfa,0x73,0xdd,0x74,0x3a,0x9f,0xaf,0x72, + 0x95,0x64,0xba,0xd6,0xc5,0x4f,0x67,0x64,0xfc,0x5a,0xed,0x85,0x0,0x7c,0x93,0x1, + 0x43,0xeb,0xd5,0x8d,0x2e,0xb6,0x83,0x97,0xdb,0xf2,0xc,0x8f,0xa5,0x8e,0x91,0x38, + 0x1a,0xd0,0x88,0x97,0x35,0xae,0x5,0x8,0x80,0xbc,0x69,0x2,0xd2,0x4b,0x75,0x10, + 0x4e,0x4f,0x2f,0x3,0x2e,0x4e,0xa2,0xb9,0x85,0x57,0x62,0x26,0x84,0x6c,0x6d,0x6b, + 0x6b,0xfb,0xc5,0xa0,0xd9,0x4e,0x2,0x21,0x20,0xb2,0xe4,0x35,0xc9,0x64,0xf2,0x4d, + 0x94,0x52,0xc7,0xe6,0xbd,0x9f,0x57,0x8c,0x63,0xc7,0x8e,0x61,0x64,0xa4,0x30,0x7b, + 0x5a,0x7a,0x7d,0x21,0xc0,0x45,0x3f,0x5e,0x83,0x6f,0xdd,0xf8,0x7d,0xc4,0x49,0x61, + 0xd4,0x75,0xd4,0xb9,0x5d,0x5b,0xaf,0x36,0xed,0x5,0x50,0xb6,0x22,0x0,0x37,0xd7, + 0xc0,0x42,0xa6,0x55,0x99,0x99,0x4c,0x46,0xd6,0xab,0x2b,0x99,0x41,0xfc,0x76,0x36, + 0x9,0x76,0x2,0x91,0xe9,0xe2,0xbe,0x38,0x92,0x6f,0xf2,0x5b,0xdc,0x9b,0xbf,0x1b, + 0xfb,0x95,0x2e,0x68,0x41,0x26,0x5,0xd4,0xdd,0xbe,0xc,0xe2,0x21,0xa3,0x7b,0xc1, + 0x69,0xe4,0x82,0x5f,0x2b,0x98,0x10,0xf2,0xa2,0x24,0x49,0x1b,0xbb,0xba,0xba,0x42, + 0xdf,0xfd,0x37,0x12,0xb,0x37,0x99,0x4c,0x2e,0xa4,0x94,0xfe,0x1a,0x40,0xbd,0x93, + 0xfa,0x7e,0xc8,0xb6,0xb7,0xb7,0x17,0xa9,0x54,0xa,0x80,0xfe,0x7,0x5d,0xf4,0xc9, + 0x6,0x7c,0xf3,0xad,0xdf,0xc5,0x1c,0xa1,0xb0,0x53,0x8f,0x5b,0x4b,0x43,0x3f,0xd2, + 0x9b,0x5b,0x55,0x25,0x9d,0x7c,0x3c,0xf4,0x7e,0xe4,0x6b,0xaf,0x83,0xa5,0x2e,0x8e, + 0x64,0x56,0x28,0x7b,0xd5,0x5,0xd4,0xbb,0x4c,0xaf,0xba,0xd8,0x91,0x8d,0x6b,0x99, + 0x8c,0xad,0x57,0x5f,0xba,0x58,0x94,0xbd,0x12,0x6c,0xb9,0x2e,0xcb,0x84,0x95,0xe8, + 0x54,0x9e,0x85,0xa,0x4d,0x8a,0xd3,0x18,0x85,0xbc,0x65,0x2,0xf1,0x3f,0x34,0x82, + 0x4c,0xe8,0xa7,0x6d,0x42,0x8c,0x5a,0x58,0xa4,0xaa,0xaa,0x32,0x38,0x38,0xf8,0x27, + 0xc7,0x8d,0x31,0x42,0x24,0x84,0xbb,0x62,0xc5,0x8a,0x9f,0x3,0xb8,0xc8,0xae,0x9e, + 0xdf,0x91,0x6c,0x78,0x78,0xb8,0xb4,0x64,0x57,0xfb,0x63,0xd6,0xbe,0x83,0xe2,0xab, + 0x9f,0xfc,0x3a,0x96,0x8b,0xab,0xd,0x9d,0xa1,0xd4,0x96,0x8b,0xe,0xc8,0xea,0x41, + 0x77,0x42,0x6,0xb6,0x4,0xe0,0xd3,0xf7,0xea,0xb9,0x3,0x32,0xbe,0x2f,0x95,0xdc, + 0x3,0x41,0xe9,0xe2,0x65,0x20,0xb1,0x95,0x7f,0x6,0xc7,0x52,0x27,0x48,0xd,0x54, + 0x28,0x38,0xaa,0xbe,0xa,0x1d,0xea,0x54,0x28,0x57,0x4d,0x22,0xfe,0xbb,0x46,0xc3, + 0xe6,0x94,0x21,0x45,0x2d,0x0,0xc0,0xe6,0x79,0xf3,0xe6,0x3d,0x34,0x30,0x30,0x60, + 0x5c,0xd3,0x1f,0x20,0x42,0x27,0xdc,0xf6,0xf6,0xf6,0x37,0x11,0x42,0x3e,0x61,0x57, + 0xcf,0x2f,0xd9,0x66,0x32,0x19,0x1c,0x3d,0x7a,0x14,0x80,0xfe,0x47,0x14,0xda,0xf3, + 0xf8,0xe4,0x7f,0xfc,0x13,0xae,0x94,0xda,0x99,0x75,0xc0,0x92,0xe,0x51,0x10,0x80, + 0x83,0xd9,0x6a,0x37,0xba,0x44,0x45,0x0,0x41,0x58,0xaf,0x76,0xba,0xd8,0xe,0x5e, + 0x6e,0xe5,0xf0,0x95,0x80,0x86,0xf2,0x52,0x61,0x39,0xf6,0x29,0xbb,0x91,0x86,0x7e, + 0x75,0x2d,0x6d,0x56,0xa0,0xac,0xcb,0x20,0xf6,0x68,0x23,0xa0,0xda,0x93,0x6e,0x0, + 0x51,0xb,0x2,0xa5,0xf4,0xaa,0x95,0x2b,0x57,0x7e,0xff,0xd4,0xa9,0x53,0xa1,0xa5, + 0x72,0xc,0x95,0x70,0x93,0xc9,0x64,0x1b,0x80,0x87,0x1,0x18,0xd7,0xfc,0x69,0xe0, + 0xf7,0xe6,0x2a,0x8a,0x82,0xee,0xee,0x6e,0xc3,0x6e,0xd,0xe4,0x6c,0x5,0x6f,0x78, + 0xe0,0x46,0xbc,0xad,0xfe,0xdd,0xd3,0xe7,0xdb,0x74,0x40,0x96,0x9d,0xde,0x37,0x1, + 0x70,0xeb,0xd5,0xb3,0x2e,0x5e,0x6,0x12,0x5b,0xf9,0x55,0x6f,0xbd,0x16,0x75,0xa8, + 0x20,0x3f,0xe0,0x95,0x80,0x4,0x4,0xb5,0xa4,0x1e,0xaf,0xa8,0x7b,0x51,0xe,0x75, + 0x71,0x1e,0x74,0xae,0x2,0xe9,0xe9,0x39,0xd3,0xf5,0x7d,0xec,0xfe,0xeb,0xb6,0x3e, + 0xa5,0x74,0x41,0x26,0x93,0x99,0x48,0xa5,0x52,0xa1,0x6d,0x42,0x19,0x2a,0xe1,0xae, + 0x58,0xb1,0xe2,0x5b,0x0,0xae,0xae,0x54,0x87,0xc5,0x48,0x76,0xec,0xd8,0x31,0xa4, + 0xd3,0x69,0xdd,0x31,0xd2,0x42,0x71,0xfe,0x2f,0x97,0xe0,0xb3,0xb,0xbf,0x2,0x1, + 0x22,0x9c,0x76,0x86,0x92,0x2c,0xc6,0x64,0xe0,0x48,0x3e,0x3,0xeb,0x55,0x5f,0x8e, + 0x86,0x0,0xcc,0x26,0xb7,0xfc,0x10,0xb6,0x13,0x5d,0xdc,0xc,0x24,0x8e,0xe4,0xcc, + 0xc8,0x95,0x80,0x26,0xf7,0x28,0x82,0x58,0xea,0x56,0x61,0x1e,0x5e,0x55,0xf,0x60, + 0x9c,0x8e,0xa2,0x1c,0xca,0xf9,0x19,0x90,0x51,0x11,0xd2,0xcb,0x75,0x51,0x6c,0xb5, + 0xe,0x42,0xc8,0x35,0xcd,0xcd,0xcd,0x3f,0x1f,0x1a,0x1a,0x4a,0xb9,0x6a,0xc0,0x23, + 0x42,0x23,0xdc,0xf6,0xf6,0xf6,0xeb,0x9,0x21,0x5f,0xa9,0x54,0x87,0xc5,0xd,0xee, + 0xef,0xef,0xc7,0xd0,0xd0,0x90,0xfe,0xa0,0x8,0x34,0x7d,0x1f,0xf8,0xf2,0xc5,0xdf, + 0x46,0x33,0x69,0x61,0xfe,0xa0,0x3b,0x21,0x3,0x47,0x9d,0xd1,0x26,0xd6,0xd2,0x7f, + 0x7,0xb4,0x91,0xcf,0xe0,0xbe,0x38,0xd,0xcd,0x62,0xa9,0x8b,0xdf,0x81,0xc4,0x54, + 0x26,0x5f,0x9,0x58,0x51,0xa6,0x55,0x1d,0xab,0xf6,0x1a,0x48,0x23,0x5e,0x56,0x76, + 0xc1,0xc,0xca,0x15,0x93,0x10,0x5f,0xd4,0x87,0x8b,0xb9,0x81,0x4f,0xde,0x88,0x11, + 0x42,0x2e,0x4c,0xa5,0x52,0x3f,0xf2,0x24,0xdc,0x25,0x42,0x21,0xdc,0x64,0x32,0x39, + 0x7,0x5,0x57,0x42,0x93,0xd9,0xf7,0xac,0x5e,0x1b,0x26,0x26,0x26,0x4c,0x53,0x2d, + 0x4a,0x1f,0x49,0xe3,0xc3,0x7f,0xf9,0x51,0x5c,0x2c,0x5e,0xc1,0xe4,0x41,0x67,0x42, + 0x0,0xe,0x66,0xab,0xdd,0x95,0xa3,0x21,0x80,0xa0,0xad,0x57,0x33,0x5d,0x1c,0xd, + 0x5e,0x6e,0xda,0xe6,0x2b,0x1,0x5d,0xcb,0x74,0xfb,0xbc,0x34,0x93,0x56,0x1c,0x53, + 0x8f,0x60,0x94,0xe,0xc3,0x0,0x1,0x50,0xae,0x9e,0x40,0xfc,0xd1,0x46,0x90,0xc9, + 0xe9,0xc8,0x85,0x10,0xa3,0x16,0x56,0xb6,0xb4,0xb4,0x1c,0x4f,0xa5,0x52,0x3b,0x1d, + 0x37,0xe6,0x11,0xa1,0x10,0xee,0x8a,0x15,0x2b,0xee,0x0,0x70,0xb3,0xd9,0x77,0xac, + 0x5e,0x1b,0x64,0x59,0x46,0x77,0x77,0x37,0x54,0x55,0xef,0xff,0x16,0x6e,0xcc,0xa1, + 0xe3,0xb,0x1b,0xf1,0xae,0xc4,0x7,0xa,0x6d,0xf8,0xec,0xf4,0x9e,0x9,0x80,0x31, + 0x31,0xb1,0x20,0x0,0xb7,0xba,0x4,0x69,0xbd,0x5a,0xe9,0xe2,0x77,0x20,0x31,0x95, + 0xc3,0x57,0x2,0x3a,0x96,0x69,0x55,0xf6,0x22,0x73,0xe,0x1a,0xf4,0x8b,0x21,0xb4, + 0x92,0x6b,0x55,0xc8,0x1b,0xd2,0x88,0x3f,0x32,0x57,0x33,0x8b,0xfe,0x83,0x0,0x0, + 0x20,0x0,0x49,0x44,0x41,0x54,0x37,0x89,0x56,0x69,0xa7,0x8,0x96,0x2e,0x7,0x42, + 0xc8,0xd5,0x2d,0x2d,0x2d,0xf7,0xa4,0x52,0xa9,0x40,0x73,0xe7,0x6,0x4e,0xb8,0xed, + 0xed,0xed,0x1b,0x8,0x21,0x3f,0x46,0xd9,0x46,0x90,0x0,0xdb,0x1b,0x76,0xec,0xd8, + 0x31,0xdd,0x4a,0x32,0xa0,0x30,0x49,0xb6,0xe4,0x9e,0x7a,0x7c,0xbe,0xf1,0x9b,0x88, + 0x93,0x44,0x78,0x4,0xe0,0xb0,0x33,0xb8,0xd1,0x25,0x8,0x2,0xb0,0xed,0x80,0xc, + 0x67,0xab,0x9d,0x96,0xdd,0x74,0x7a,0x47,0xba,0xf0,0x95,0x80,0xde,0x65,0x56,0x28, + 0x7b,0xd1,0xa5,0x89,0x34,0xe3,0xa0,0xba,0xf,0x93,0x30,0xcf,0x1f,0x43,0x17,0xc8, + 0xa0,0x73,0x54,0xc4,0x9e,0x29,0x4c,0xa2,0x15,0xc9,0x36,0xa4,0xa8,0x85,0x3a,0x42, + 0xc8,0xfc,0x54,0x2a,0xf5,0x4b,0xc7,0xd,0x7b,0x40,0xe0,0x84,0xbb,0x62,0xc5,0x8a, + 0x7b,0x9,0x21,0x67,0x95,0x1f,0x67,0x79,0xc3,0x52,0xa9,0x14,0xca,0x57,0xea,0x91, + 0x4,0x10,0xfb,0xe1,0x38,0xfe,0xdf,0x9a,0x2f,0x60,0x85,0xb0,0x26,0x58,0x2,0x8, + 0xdc,0x7a,0xd,0x9e,0x0,0xbc,0x2c,0x8b,0xf5,0xab,0x8b,0xdf,0x4e,0x6f,0xaa,0x4b, + 0x44,0xd6,0xab,0x9b,0xfb,0x62,0xf6,0x4c,0x95,0x93,0x2b,0x6b,0x5d,0xdc,0xc,0x64, + 0xac,0xee,0x85,0xf1,0x99,0x2,0xe2,0x24,0x81,0x43,0xea,0x2b,0xb0,0x82,0x72,0x7e, + 0x6,0xe2,0xab,0x9,0x48,0x47,0xcd,0x13,0xdd,0x4,0x1c,0xb5,0x70,0x61,0x6b,0x6b, + 0xeb,0x23,0xa9,0x54,0xca,0xe8,0x97,0x64,0x4,0x29,0xa8,0x86,0x1,0xa0,0xbd,0xbd, + 0xfd,0x16,0x42,0xc8,0x56,0xed,0x31,0xd6,0x37,0x2c,0x9b,0xcd,0x9a,0xee,0x47,0x26, + 0xfe,0xd3,0x24,0xae,0xbf,0xe0,0x46,0x5c,0x22,0xea,0x13,0x89,0x97,0xda,0x35,0x2d, + 0x7b,0x23,0x57,0xbf,0x65,0xab,0xe,0xc8,0x5a,0x8e,0x4e,0xa6,0x4b,0x7f,0x1f,0x13, + 0x99,0xc,0xda,0xf1,0x4a,0xae,0x2c,0xaf,0xc3,0x2f,0xb9,0x7a,0xb9,0xe,0x37,0xba, + 0x4,0x79,0xcd,0x95,0xca,0xfa,0x58,0x6a,0xf3,0xba,0x67,0xb,0xe7,0xe1,0x29,0xf2, + 0x7,0x8c,0x99,0x44,0x2c,0x0,0x0,0x8,0x90,0xfe,0xe4,0x29,0x48,0xfb,0x6b,0xd, + 0x39,0x17,0xa,0x22,0x9c,0xf1,0x87,0x47,0x9e,0x21,0x94,0xd2,0xaf,0xa3,0x10,0x49, + 0xe5,0xae,0x1,0x87,0x8,0xcc,0xc2,0xdd,0xb6,0x6d,0x5b,0x42,0x96,0xe5,0x5f,0x1, + 0x68,0x29,0x1e,0x63,0x4d,0xb6,0x94,0x52,0x1c,0x3d,0x7a,0x54,0x97,0x1,0xc,0x0, + 0x84,0x6b,0xf3,0x68,0xfb,0x4c,0xd,0x3e,0x55,0xfb,0x25,0x24,0x48,0xd,0x2c,0x47, + 0x60,0x18,0x47,0x60,0x43,0x99,0xf1,0x6b,0xb5,0x51,0x66,0x65,0xcb,0xc4,0x6d,0xa7, + 0x73,0x66,0x69,0xb8,0xd3,0xdd,0x8b,0x2e,0x4e,0xaf,0xd3,0x55,0x99,0xaf,0x4,0x34, + 0xff,0x7d,0x3d,0xfe,0x46,0xbe,0x64,0x7a,0x8c,0xa5,0x26,0x20,0xc8,0x23,0x8f,0x1e, + 0xf5,0x28,0x2c,0x11,0xa7,0x50,0xce,0xcb,0x20,0xfe,0xdb,0x26,0x1d,0xed,0x5,0x91, + 0x6b,0xc1,0xa4,0xee,0xd2,0x96,0x96,0x96,0x43,0xa9,0x54,0xca,0xdc,0xd9,0xec,0x13, + 0x81,0x11,0xee,0x92,0x25,0x4b,0x3e,0x2,0xe0,0x4d,0xc5,0xcf,0x41,0xc4,0xd4,0xf5, + 0xf7,0xf7,0x97,0x92,0xd2,0x94,0xd0,0xa6,0x22,0x7e,0xcf,0x38,0x3e,0xde,0xf2,0xcf, + 0x58,0x2d,0x9e,0x53,0xf6,0x50,0xda,0x10,0x40,0xc0,0x41,0xe0,0x61,0x11,0x80,0x5b, + 0xeb,0x95,0x5d,0xa7,0x67,0x38,0x60,0xf8,0xf4,0xbd,0xba,0xf9,0x8d,0xbc,0xde,0x17, + 0x2f,0xcf,0x94,0x5f,0x5d,0x58,0xe,0x64,0x6e,0x74,0x61,0xb9,0x12,0xb0,0x89,0xb4, + 0x60,0x97,0xf2,0x82,0xbe,0xfd,0x32,0xa8,0xb,0xf3,0x20,0x19,0x1,0xd2,0xee,0x8a, + 0x6b,0xa4,0xc,0x60,0xc4,0x33,0x57,0x2e,0x5a,0xb4,0xe8,0xae,0xfe,0xfe,0x7e,0xe6, + 0xc9,0x6d,0x2,0x21,0xdc,0xcd,0x9b,0x37,0x2f,0x22,0x84,0x3c,0x8,0x20,0x1,0x4, + 0x43,0xb6,0xe9,0x74,0xda,0x34,0x4,0x2c,0xf6,0xf5,0x9,0x5c,0x79,0xd1,0x55,0x78, + 0x4b,0xe2,0x5d,0xb0,0x25,0x80,0x88,0xc2,0x68,0x9c,0xca,0x74,0xa2,0x4b,0x34,0xd6, + 0x6b,0xf1,0x5a,0xd9,0x74,0xc0,0xc2,0x65,0x78,0x1b,0xbc,0xac,0xee,0x8b,0xdf,0xb2, + 0x17,0xf9,0xda,0xeb,0x60,0xa5,0x8b,0x23,0x99,0x8c,0xef,0xb,0xeb,0x95,0x80,0xe5, + 0xba,0x48,0x24,0x86,0x3e,0x7a,0xa,0xc3,0xb4,0x2c,0x5e,0xbe,0xc,0xca,0xc5,0x93, + 0x90,0x9e,0xad,0x87,0x30,0x50,0x70,0x2d,0x68,0x27,0xd0,0xcc,0x78,0x82,0x21,0xcf, + 0x34,0xca,0xb2,0xac,0xe,0xd,0xd,0x3d,0xee,0xb8,0x41,0x87,0x8,0x84,0x70,0x57, + 0xaf,0x5e,0xfd,0x75,0x0,0x57,0x1,0xc1,0x90,0x6d,0xd1,0x95,0x20,0xcb,0xb2,0xee, + 0xb8,0xf4,0x97,0x39,0xd4,0xbe,0x5b,0xc5,0xa7,0x6b,0xbf,0x8c,0x7a,0x32,0xc7,0xd0, + 0xa1,0xc3,0xee,0x80,0x2c,0x9,0x40,0xdf,0x19,0xac,0x65,0x6,0xa1,0x4b,0xa5,0x81, + 0xc4,0x93,0x2e,0xc,0xad,0x57,0xbb,0xdf,0xc8,0xeb,0x7d,0x71,0x24,0x9f,0xc7,0x52, + 0x7b,0xd6,0x45,0x22,0xb1,0x8a,0x93,0x67,0x0,0xa,0xf1,0xb9,0x17,0xa6,0x11,0xff, + 0xcd,0x5c,0x8,0xaa,0x31,0x3e,0xb7,0x34,0xb8,0x5,0x30,0x91,0x46,0x8,0xb9,0x62, + 0xde,0xbc,0x79,0xf7,0xe,0xe,0xe,0x9a,0x4,0xe,0x7b,0x7,0x73,0xc2,0x6d,0x6f, + 0x6f,0x3f,0xf,0xc0,0x5d,0x34,0xc0,0x2d,0x73,0xcc,0x5c,0x9,0xc2,0x62,0x8a,0xd8, + 0x5d,0xe3,0xb8,0xb5,0xfe,0xcd,0xb8,0x26,0xd6,0x51,0xd5,0x41,0xe0,0x4e,0x75,0xf1, + 0x6b,0xbd,0x7a,0xd5,0x85,0x79,0xa7,0x77,0xf0,0x5a,0x1d,0xc5,0xe0,0xe5,0x46,0x7e, + 0xf1,0x3a,0x58,0xca,0x37,0x3e,0x53,0x36,0xf2,0x19,0xdc,0x97,0x6a,0x59,0x9,0xd8, + 0x48,0x9a,0xf0,0xb2,0xba,0xb,0x32,0xf4,0xf3,0x2f,0xe5,0xa0,0x4d,0xa,0x48,0xc, + 0x88,0xbd,0x30,0x47,0x77,0x9c,0x10,0x2,0x55,0x55,0x83,0x5c,0xfe,0x2b,0xa9,0xaa, + 0xda,0x34,0x34,0x34,0xc4,0x34,0x4c,0x8c,0x39,0xe1,0xae,0x5c,0xb9,0xf2,0xbb,0x94, + 0xd2,0x75,0x4e,0xeb,0xbb,0x1d,0x9d,0x32,0x99,0xc,0x4e,0x9c,0x38,0xa1,0x3b,0x8f, + 0x8,0x4,0xf1,0xef,0x8c,0x63,0xfe,0x59,0x6d,0xf8,0x58,0xcd,0x67,0x21,0x4e,0x5d, + 0x96,0x1f,0x32,0x8a,0x82,0x0,0x66,0x83,0xf5,0x5a,0xb8,0x8c,0xea,0x18,0xbc,0xac, + 0xee,0x91,0x23,0xf9,0xcc,0xad,0xd7,0xa2,0x5c,0x86,0x3,0x99,0x13,0x99,0x21,0xc6, + 0x52,0x97,0x5f,0x67,0xe5,0x7b,0x1,0x8c,0xd1,0x51,0xdd,0xde,0x67,0x56,0x90,0xd7, + 0xa7,0x11,0xdb,0x51,0xf,0xa1,0xd7,0xb8,0xf4,0x37,0xe0,0xa8,0x85,0xb,0x9a,0x9a, + 0x9a,0x7e,0x39,0x3c,0x3c,0xdc,0xeb,0xea,0xe4,0xa,0x60,0x4a,0xb8,0x5b,0xb6,0x6c, + 0xb9,0x9c,0x52,0xfa,0x15,0x38,0xdc,0x49,0xc2,0xcb,0xe8,0xd4,0xd3,0xd3,0x83,0x5c, + 0x6e,0xda,0x97,0x4d,0x8,0x81,0xf0,0xfa,0x2c,0xc4,0x77,0x65,0x70,0x7b,0xe2,0x43, + 0x58,0x23,0x9c,0x5b,0xa8,0xef,0xe2,0xe1,0x8a,0x82,0x0,0xa2,0xb6,0x5e,0x9d,0xdc, + 0x17,0x47,0x65,0x7,0xc4,0xe4,0xa4,0x3,0x6,0x41,0x0,0xfa,0xdf,0xd7,0x46,0x3e, + 0x8f,0xa5,0xf6,0xa4,0x8b,0x97,0xbe,0x53,0x2c,0xb,0x10,0x70,0x50,0xdd,0x7,0x5b, + 0x10,0x40,0xd9,0x90,0x46,0xe2,0xd7,0xcd,0x80,0xa2,0x5f,0x85,0xe6,0x84,0x43,0x7c, + 0x58,0xc1,0x84,0x10,0xd2,0x36,0x34,0x34,0xf4,0xa0,0xe3,0x6,0x6c,0xc0,0x94,0x70, + 0x57,0xac,0x58,0xf1,0x1d,0x0,0xe7,0x3a,0xa9,0xeb,0xe5,0x26,0xc,0xf,0xf,0x97, + 0x16,0x38,0x94,0x1c,0xe8,0x6d,0x2a,0x62,0x77,0x8f,0x63,0x75,0xdd,0xd9,0xba,0xe5, + 0xbb,0xc5,0x7f,0xab,0x85,0x0,0xcc,0x82,0xc0,0xdd,0x96,0x59,0x76,0x7a,0xcf,0x9d, + 0x2e,0x0,0xeb,0x35,0x74,0x2,0xe0,0x2b,0x1,0x3d,0x97,0xdd,0xf4,0x1d,0x3b,0x5d, + 0xea,0x30,0x7,0x5d,0xca,0x4b,0xfa,0x1d,0x21,0x2c,0x40,0x9b,0x14,0x40,0x21,0x88, + 0xed,0x9c,0xde,0x24,0x86,0x10,0x2,0x41,0x10,0xc,0xcb,0xf9,0x75,0xe7,0xf9,0x77, + 0x39,0x9c,0xdf,0xd6,0xd6,0xf6,0x3f,0xa9,0x54,0xca,0xde,0x14,0x77,0x0,0x66,0xb, + 0x1f,0x36,0x6d,0xda,0x74,0x25,0x2c,0xf2,0x25,0x94,0xc3,0xcb,0x4d,0x90,0x65,0x19, + 0xa7,0x4f,0x17,0xae,0x59,0x1b,0x8f,0x27,0x7d,0x7a,0x12,0xa4,0x89,0xe2,0x2d,0xf1, + 0x77,0x15,0xea,0xeb,0x1e,0x8e,0xc2,0x91,0xe9,0x52,0x78,0x65,0x27,0x41,0xe0,0xcc, + 0x65,0x3a,0x78,0xe8,0x5d,0xb5,0x1d,0xe0,0xc2,0x82,0xb0,0xae,0xd9,0xc9,0x75,0x4, + 0x22,0x93,0xf1,0x7d,0xf1,0xea,0x6e,0xf2,0x57,0xe,0xa0,0x6d,0xad,0x2b,0x10,0x4, + 0xcb,0x85,0x55,0x78,0x55,0xdd,0xf,0x27,0xc8,0xfc,0x9f,0x1,0xc4,0xff,0xd8,0x8, + 0xf1,0x48,0xa2,0xc4,0x1,0x84,0x10,0x88,0xa2,0x68,0xc8,0x7d,0x5d,0x2e,0xcb,0xe, + 0x15,0xea,0x12,0x55,0x55,0xef,0x0,0x70,0xab,0xe3,0xc6,0x2a,0x80,0x99,0x85,0xbb, + 0x72,0xe5,0xca,0xef,0x3,0x30,0x2c,0xe1,0x2d,0x87,0xd7,0x9b,0xd0,0xdb,0xdb,0x8b, + 0xc9,0xc9,0x49,0xfd,0xee,0xd,0xaf,0xc9,0x41,0xfa,0x68,0x1a,0x6b,0x84,0x73,0xf1, + 0xd6,0xf8,0xed,0xc5,0xb3,0xa6,0xcf,0x77,0xf9,0xa0,0x7b,0x1e,0xf5,0x19,0x87,0xd1, + 0x38,0xb7,0x34,0xcc,0x65,0x5a,0x9d,0x6b,0x2b,0xdf,0xe6,0xb5,0xda,0x8b,0x4c,0xcf, + 0xba,0x58,0x12,0x80,0x8d,0x7c,0x1e,0x4b,0xed,0xb9,0x6c,0xbc,0xbf,0xce,0xe4,0x5b, + 0xea,0xe2,0xe0,0xb7,0x90,0x21,0xe3,0xa8,0x7a,0x18,0x8e,0x20,0x2,0xca,0xda,0xc, + 0x12,0xf,0x37,0x83,0x50,0x6b,0xd7,0x42,0x0,0x51,0xb,0x6b,0x9b,0x9a,0x9a,0x7e, + 0x3b,0x3c,0x3c,0xec,0x7b,0xc9,0x2f,0x13,0xb,0xb7,0xbd,0xbd,0xbd,0x1d,0xc0,0xd, + 0x95,0xea,0xf8,0xb9,0x9,0x99,0x4c,0x6,0xc3,0xc3,0xc3,0xfa,0x95,0x26,0x9,0xa, + 0xe9,0x53,0x85,0xc4,0x3e,0x6f,0x8e,0xbf,0xd3,0xd0,0x1,0x4b,0xed,0x4,0x50,0xe6, + 0xd6,0x2b,0x63,0x5d,0xfc,0xc8,0xe7,0xd6,0xab,0xc7,0x72,0x0,0x6d,0x7b,0x78,0xa6, + 0x16,0x9,0x4b,0xe0,0x6,0xf2,0xba,0x34,0x72,0xdb,0x86,0x91,0x78,0xa8,0xb9,0x74, + 0xac,0xe8,0x5a,0x50,0x14,0x25,0xb0,0xa8,0x5,0x41,0x10,0x3e,0x3,0xe0,0xcf,0xdc, + 0xe8,0x6a,0x6,0x56,0x2e,0x85,0xff,0x5b,0xe9,0x4b,0xbf,0x37,0xa1,0xb7,0xb7,0xd7, + 0x70,0x5c,0x7a,0x6f,0x6,0x64,0xa9,0x8a,0xf3,0xc4,0xd,0xd8,0x20,0x5e,0x52,0xf1, + 0xa1,0x66,0x41,0xae,0x7e,0xdb,0x71,0xa3,0x4b,0x58,0x9d,0x21,0x2c,0xa2,0x71,0x56, + 0x66,0xd3,0xa1,0x59,0x10,0x6c,0x58,0x3,0xb6,0xdb,0x73,0x3,0x1f,0xbc,0xdc,0xe8, + 0xc2,0x68,0xc0,0x4e,0xa0,0x6,0x8d,0xa4,0xc9,0x3c,0x4f,0xae,0x5,0x26,0xff,0xae, + 0x17,0xf1,0x27,0x1b,0x41,0x46,0xa7,0x5f,0xd0,0x45,0x51,0x74,0x15,0x26,0xe6,0x81, + 0x93,0xb6,0xad,0x5e,0xbd,0xfa,0xb2,0xc3,0x87,0xf,0xef,0x70,0x7c,0xa2,0x9,0x7c, + 0x13,0xee,0xe6,0xcd,0x9b,0xaf,0x40,0x5,0xeb,0xd6,0x2f,0xd9,0x8e,0x8f,0x8f,0x63, + 0x62,0x42,0x9f,0xce,0x8d,0x2c,0x55,0x21,0xbe,0xa7,0x90,0x8a,0xf1,0xb5,0xb1,0xdb, + 0x40,0xa7,0xfe,0x4a,0xed,0x30,0xee,0xc,0x81,0x77,0x40,0xd6,0x9d,0x2e,0xa4,0xa4, + 0x2e,0x81,0x5f,0x33,0xe3,0x4,0x3b,0x61,0xd,0x2a,0x41,0xe,0xd8,0x4e,0xcb,0x30, + 0xd1,0x85,0xf5,0x80,0x6d,0x25,0xd3,0xaa,0x8e,0xd5,0x79,0xf3,0xc9,0x42,0x57,0x84, + 0x4b,0x1b,0x15,0xa4,0xff,0xaa,0x1f,0x75,0xdf,0x58,0xa8,0x3b,0x2e,0x49,0x92,0x2e, + 0x82,0xc9,0xf2,0x7c,0x6f,0x9c,0x44,0x50,0x30,0x2c,0xdf,0xe0,0xf8,0x64,0x13,0xb0, + 0xb0,0x70,0x3f,0x64,0xf5,0x85,0x5f,0xb2,0x55,0x55,0xb5,0x34,0x51,0xa6,0x85,0xf8, + 0x8f,0x93,0x40,0x82,0x62,0xa1,0xb0,0x4,0x17,0x89,0x97,0x43,0x45,0x61,0x96,0x32, + 0x2c,0x4b,0xc3,0x49,0x39,0xd4,0x4e,0x6f,0x7b,0x1d,0xd1,0x74,0x7a,0x57,0x4,0x10, + 0x92,0xf5,0xaa,0x2d,0x7,0x72,0x9d,0xdc,0x7a,0x75,0x5d,0x5e,0x20,0x2c,0xb2,0x5f, + 0x75,0x56,0x86,0xec,0x5f,0xa4,0x90,0xf8,0x75,0x33,0xc4,0x23,0x9,0x0,0xd3,0x51, + 0x4b,0x56,0x13,0x68,0x25,0x79,0xfe,0x38,0xe9,0x75,0x2b,0x57,0xae,0x5c,0xdb,0xdd, + 0xdd,0xed,0x4e,0x59,0xd,0x7c,0x11,0xee,0xb5,0xd7,0x5e,0xbb,0x42,0x96,0xe5,0xdb, + 0xca,0x8f,0xb3,0x72,0x5a,0x8f,0x8c,0x8c,0x18,0x46,0x2c,0xe1,0xa,0x19,0xe2,0x6b, + 0xb,0xc7,0x6e,0x94,0x5e,0xe7,0xea,0x81,0xe5,0xd6,0x6b,0x15,0x11,0x0,0xb7,0x5e, + 0x3d,0x97,0x6d,0x7,0x2f,0xb7,0x65,0xc6,0xcf,0x94,0x5b,0xf9,0xcd,0xa4,0x15,0x6e, + 0x41,0x45,0x8a,0x89,0xf,0x9e,0x42,0xe3,0x87,0x56,0xea,0xa3,0x96,0x24,0xc9,0x92, + 0x70,0x19,0xf8,0x77,0x5,0x41,0x10,0x3e,0x0,0xe0,0x7d,0xee,0xb4,0x9d,0x86,0x2f, + 0xc2,0xcd,0xe7,0xf3,0x1f,0x20,0x84,0xe8,0xda,0x60,0xe5,0xb4,0x56,0x55,0x15,0xfd, + 0xfd,0xfd,0xfa,0x83,0x2,0x20,0x7e,0xaa,0xe0,0x5e,0x98,0x43,0x1a,0xb0,0x59,0xba, + 0xae,0x64,0xdd,0x2,0xd1,0x74,0x86,0xc0,0x3b,0xbd,0x8b,0xce,0x10,0x66,0xa7,0xb7, + 0xbb,0x6e,0xaf,0xe4,0xea,0x47,0xa6,0x55,0x99,0x99,0x4c,0x6,0xd7,0x11,0xe4,0x75, + 0x3a,0x2e,0xdb,0x4c,0xfa,0x86,0x35,0x78,0x15,0xcb,0xf5,0xa4,0x1,0x12,0x24,0xc8, + 0xd0,0xe7,0x46,0xb1,0x83,0x7c,0xf9,0x4,0xf2,0x57,0x8f,0x23,0xfe,0x4c,0x43,0xe9, + 0x98,0x99,0x95,0xcb,0x38,0x6a,0xe1,0x1d,0xe7,0x9c,0x73,0xce,0xa7,0xf,0x1c,0x38, + 0x30,0xe0,0xaa,0xd1,0x29,0x78,0x26,0xdc,0x64,0x32,0xd9,0xa4,0xaa,0xea,0xed,0xda, + 0x63,0x2c,0x67,0x8,0x53,0xa9,0x94,0x21,0x39,0x8d,0x78,0x4b,0xe,0xc2,0xba,0xc2, + 0x8d,0xdc,0x24,0x6d,0x85,0x44,0x62,0xd3,0x3f,0x1e,0xe3,0xd9,0xea,0x20,0x3b,0x43, + 0x58,0x96,0x86,0x2f,0x5d,0xfc,0xc8,0x67,0xfc,0x5a,0x1d,0x36,0x1,0x4c,0x5d,0x44, + 0xf8,0x32,0xa7,0x3e,0x95,0x1f,0xf,0x6b,0xc0,0x76,0xd2,0x66,0x50,0xd7,0xdc,0x48, + 0x9a,0x90,0xa2,0xee,0x39,0x2c,0xfd,0xbe,0x5e,0xc4,0x9f,0x6b,0x80,0xc6,0xee,0xd2, + 0x59,0xb9,0x1,0x44,0x2d,0xd4,0xc9,0xb2,0xfc,0x3e,0x0,0x9f,0x73,0xa5,0x68,0x51, + 0x37,0x2f,0x27,0x1,0x80,0xaa,0xaa,0x7f,0x3,0xa0,0x34,0xb4,0xb0,0xbc,0x30,0x55, + 0x55,0x8d,0x5b,0xe6,0xc4,0x1,0xf1,0xa3,0x85,0x30,0x30,0x2,0x82,0xa4,0x74,0x3, + 0xa0,0x89,0xf3,0x3,0xd8,0x3f,0xc,0x61,0x59,0x1a,0x95,0xea,0xc0,0x44,0x97,0xaa, + 0x22,0x0,0x6e,0xbd,0x7a,0xd6,0x2b,0xac,0x67,0x2a,0xf2,0xc1,0x4b,0x57,0x36,0xff, + 0xde,0x2b,0xe1,0xca,0xab,0x32,0xc8,0x5e,0x3f,0x8c,0xc4,0x23,0xd3,0x1b,0x82,0x17, + 0xad,0xdc,0x72,0x83,0xad,0x12,0x5c,0xf2,0xd7,0xfb,0x97,0x2e,0x5d,0xfa,0x6f,0x3d, + 0x3d,0x3d,0x69,0x57,0xca,0xc2,0x23,0xe1,0x5e,0x7a,0xe9,0xa5,0x31,0x4c,0x4d,0x96, + 0x5,0x91,0x1a,0x6d,0x70,0x70,0xd0,0xe0,0x87,0x11,0xde,0x90,0x5,0x59,0x52,0x18, + 0xc6,0xd6,0x8,0xe7,0x62,0x21,0x59,0x6c,0xea,0x4e,0x88,0xa2,0xd3,0x5b,0x95,0x83, + 0xb4,0x34,0x7c,0xe9,0xe2,0x47,0x3e,0xe3,0xd7,0xea,0xa8,0x8,0x80,0xc7,0x52,0x87, + 0x34,0x90,0x39,0xbc,0x8e,0x46,0x32,0x17,0x5e,0x91,0x7e,0x67,0x1f,0xe2,0x8f,0xcd, + 0x5,0xd1,0xe4,0x59,0x88,0xc7,0xe3,0x8e,0x9,0xd7,0x83,0xb1,0x38,0x3f,0x16,0x8b, + 0xbd,0xd,0xc0,0xf7,0xdc,0x69,0xea,0x91,0x70,0xe7,0xcc,0x99,0x73,0x2b,0xa5,0x74, + 0x49,0x10,0x64,0xab,0x28,0xa,0x52,0xa9,0x94,0xee,0x18,0x49,0x0,0xe2,0xdf,0x4d, + 0xf,0x26,0x57,0x4b,0x49,0xcf,0x91,0x9,0x6e,0x46,0x5d,0xd6,0x96,0x46,0x79,0xd9, + 0x4c,0x6e,0x55,0x11,0x40,0xc4,0xd6,0xab,0x4e,0x17,0x3f,0x32,0xb9,0xf5,0x1a,0x52, + 0xd9,0x7b,0xbf,0xa8,0x25,0xee,0x76,0x76,0xd0,0x42,0x59,0x92,0x43,0xee,0xc6,0xc2, + 0x62,0x8,0xed,0x4,0x5a,0x2c,0x16,0x33,0x6c,0xbf,0x55,0xe,0x1f,0x6f,0xe6,0x7f, + 0x8f,0xb0,0x8,0x57,0x55,0x55,0x57,0xb3,0x74,0x6e,0x2e,0x2a,0x95,0x4a,0xe9,0xac, + 0x5b,0x42,0x8,0x84,0xdb,0x32,0x20,0x8b,0xb,0x4,0x1b,0x43,0xc,0x97,0x49,0x57, + 0x5b,0x4e,0x96,0x85,0xd5,0x19,0xc2,0xb2,0x34,0x5c,0xeb,0xe2,0x47,0x3e,0xb7,0x5e, + 0xbd,0xcb,0x64,0xf0,0x1b,0x85,0xf5,0x4c,0x85,0x3a,0x78,0x3a,0x9c,0x5b,0xa9,0x85, + 0x77,0xc2,0x5,0x80,0xc9,0x77,0xf6,0xa1,0xe6,0xb1,0x66,0x68,0xd3,0xeb,0x56,0x22, + 0x5c,0x6,0xc6,0xe2,0x86,0x55,0xab,0x56,0x6d,0x3e,0x72,0xe4,0xc8,0x93,0x6e,0xda, + 0x71,0x4d,0xb8,0x9b,0x36,0x6d,0x3a,0x7,0xc0,0x16,0xa7,0xf5,0xdd,0x5c,0x98,0xa2, + 0x28,0x3a,0xdf,0x2d,0x21,0x4,0x48,0x50,0x9d,0x75,0xbb,0x4e,0xbc,0x8,0xb5,0xa8, + 0xf3,0x44,0x36,0x41,0x5a,0x1a,0x56,0x32,0xad,0xea,0x44,0x4d,0x0,0xda,0xeb,0x8, + 0x55,0x26,0xe3,0xfb,0xc2,0x63,0xa9,0xc3,0x1f,0x54,0x82,0x18,0xb0,0x13,0xc4,0x7c, + 0x5b,0x74,0xa7,0x50,0x17,0xe6,0x91,0xd9,0x36,0x84,0x9a,0x5f,0xb5,0xe8,0x8e,0x4b, + 0x92,0x64,0x70,0x2d,0x30,0x7c,0x33,0xbf,0x1d,0x40,0xb0,0x84,0x4b,0x8,0xf9,0x1b, + 0x4,0x94,0xef,0x76,0x78,0x78,0x18,0xaa,0xaa,0xea,0x13,0xd4,0xfc,0x79,0x16,0x64, + 0xfe,0xb4,0x35,0x7b,0x99,0x74,0x35,0xe8,0xd4,0x5f,0xe9,0xdc,0x0,0x3b,0x43,0xd4, + 0xd6,0xab,0x4e,0x17,0x3f,0xf2,0x99,0x13,0x53,0x44,0x9d,0x9e,0xc7,0x52,0xb3,0xd5, + 0x25,0xa4,0x67,0xca,0xee,0xfb,0x4,0x12,0x10,0x20,0xe8,0xde,0x5c,0xdd,0x22,0xfd, + 0xb6,0xfe,0x42,0x62,0x1b,0x59,0xef,0x56,0xd0,0x12,0x2e,0xe3,0xa8,0x85,0xbf,0x58, + 0xba,0x74,0xe9,0x87,0x7a,0x7a,0x7a,0x52,0x76,0x15,0x8b,0x70,0x45,0xb8,0xdb,0xb6, + 0x6d,0x4b,0x8c,0x8f,0x8f,0xbf,0xd3,0x49,0x5d,0xb7,0x17,0x46,0x29,0x45,0x2a,0x95, + 0xd2,0x27,0xa8,0x89,0x1,0xe2,0xfb,0xd3,0x9a,0x8f,0x31,0x5c,0x28,0x5e,0x56,0xf6, + 0xa3,0x30,0xee,0x74,0xdc,0x7a,0xf5,0x2e,0x93,0xf1,0x7d,0xe1,0xd6,0x6b,0x88,0x3, + 0x99,0xdd,0x6f,0x14,0x82,0x3f,0x5f,0x42,0xc,0x39,0x64,0xe1,0x15,0xca,0xa2,0x1c, + 0x72,0xd7,0xf,0x23,0xf1,0xb0,0x3e,0xb1,0x4d,0xd1,0xca,0xd,0x20,0x44,0xac,0x36, + 0x16,0x8b,0xbd,0x15,0xc0,0x37,0x9d,0xb6,0xeb,0x8a,0x70,0x27,0x26,0x26,0x5e,0x7, + 0xa0,0xad,0x52,0x1d,0xaf,0xe6,0xfa,0xd8,0xd8,0x98,0xc1,0xf4,0x17,0xb6,0x65,0x41, + 0x16,0x4e,0x93,0xeb,0x6a,0xf1,0x1c,0xc4,0x10,0x43,0xe1,0xe7,0x61,0xd0,0xe9,0xb8, + 0xf5,0x5a,0x55,0x4,0xc0,0x63,0xa9,0x43,0x1a,0xc8,0x2,0x7c,0xa6,0xfc,0xc8,0x94, + 0x88,0x84,0x1c,0xf5,0x4e,0xb8,0x0,0x30,0xf9,0x96,0x7e,0x24,0x1e,0x69,0x2e,0xc5, + 0xe5,0x12,0x42,0x1c,0x4d,0x9e,0x69,0xe1,0x92,0x98,0x6f,0x47,0x50,0x84,0x3b,0xd5, + 0x78,0xa5,0xef,0xdd,0xb4,0xa5,0xfb,0x5c,0x1e,0x99,0x0,0x2,0x8,0xef,0xd1,0x87, + 0xb9,0xad,0x13,0x2e,0xf2,0x35,0x59,0x36,0x53,0x82,0xc0,0xbd,0x5c,0x47,0x14,0xa4, + 0x63,0x55,0x66,0x41,0xae,0x41,0xe8,0x12,0xc8,0x40,0xc2,0x63,0xa9,0x1d,0xcb,0xb4, + 0x2a,0x17,0xff,0x95,0x18,0xa4,0x76,0x51,0x56,0x64,0x91,0xbb,0x72,0xc,0xf1,0x67, + 0x1a,0x4a,0x6f,0xcb,0x82,0x20,0x98,0xfa,0x72,0xcd,0xe0,0x81,0xc3,0x36,0xac,0x5c, + 0xb9,0xf2,0xaa,0xee,0xee,0xee,0x67,0x9d,0x9c,0xe3,0xf8,0xa,0x93,0xc9,0xe4,0x59, + 0x8a,0xa2,0x6c,0xb5,0x11,0xee,0x8,0xe5,0x75,0xd3,0xe9,0x34,0x32,0x99,0x8c,0xee, + 0x98,0xb0,0x31,0xf,0x61,0xad,0x3e,0x16,0xf7,0x7c,0xf1,0x2,0x77,0x4,0x53,0x65, + 0x4b,0x18,0x3d,0xc9,0xf,0xb0,0x33,0x84,0xda,0xe9,0xb9,0xf5,0xca,0x56,0x17,0x3f, + 0xf2,0xab,0x74,0x25,0xa0,0xc8,0x28,0x5b,0x6c,0xfa,0x2f,0xfb,0x91,0x78,0xb6,0x51, + 0x77,0xac,0xdc,0x97,0x5b,0xe,0x9f,0x13,0x69,0xb7,0x3,0x60,0x4b,0xb8,0xb2,0x2c, + 0xbf,0x95,0xe8,0x1c,0xac,0x96,0xc2,0x2b,0xc2,0xac,0xae,0xc1,0xba,0x5,0x20,0xfc, + 0x8d,0xde,0xba,0x9d,0x4b,0x9a,0xb1,0x40,0x30,0x5f,0xec,0x50,0xde,0x2e,0xcb,0x51, + 0x97,0x65,0xd9,0x6b,0x67,0x88,0x82,0x74,0xac,0xca,0x2c,0xc8,0x35,0x98,0x72,0x0, + 0x6d,0xf3,0x58,0x6a,0x4f,0x32,0x2d,0x75,0xb1,0xf9,0x9e,0x38,0x9b,0x8b,0xb7,0x45, + 0xfe,0xe2,0x9,0xe4,0xcf,0x9f,0x44,0xec,0xe5,0xe9,0x50,0x33,0x51,0x14,0x2d,0xf7, + 0x3f,0x63,0xe0,0xdb,0xbd,0x6d,0xe9,0xd2,0xa5,0x7f,0xe7,0x64,0xe5,0x99,0x63,0xc2, + 0x25,0x84,0xbc,0xc5,0x85,0x2,0xa6,0x30,0xab,0x2b,0xcb,0x32,0xc6,0xc7,0xc7,0xf5, + 0xb2,0xd6,0xca,0x10,0xb6,0xe8,0x7d,0x2e,0xe7,0x8,0xe7,0xbb,0x22,0xa6,0x40,0x3a, + 0x20,0x6b,0x2,0x8,0xa9,0x33,0x4,0xde,0xe9,0x19,0x67,0xfe,0xa,0x6b,0x20,0x9, + 0x72,0xc0,0xf6,0xa5,0x8b,0x1f,0xf9,0x33,0x38,0x96,0xda,0x4f,0x84,0x42,0x39,0xd2, + 0x6f,0x1c,0x40,0xec,0x8e,0xe5,0xba,0x63,0xb1,0x58,0xc,0xd9,0xac,0xde,0x47,0xcc, + 0x68,0x22,0xad,0x21,0x16,0x8b,0xdd,0xc,0xe0,0x1,0xbb,0x36,0x1c,0x11,0xee,0xd5, + 0x57,0x5f,0x7d,0x11,0x80,0x73,0x1c,0xa,0x37,0x85,0x55,0xfd,0xe1,0xe1,0x61,0xc3, + 0x77,0xe2,0xdb,0x8d,0x8e,0xf3,0x15,0xc2,0xea,0x42,0x34,0x3,0xe3,0xce,0x10,0x2a, + 0x1,0x30,0x7e,0xad,0x8e,0x82,0x0,0xb8,0xf5,0x1a,0xde,0xf5,0xdb,0x5d,0xf7,0x4c, + 0xb2,0x5e,0x2b,0xca,0x34,0x71,0xfd,0xf9,0x45,0xae,0x7d,0x4,0x6a,0x5b,0x1e,0xc2, + 0x40,0xac,0x74,0xac,0x98,0xa0,0xbc,0xe4,0x6a,0x64,0x9b,0xff,0xe5,0x36,0xb0,0x22, + 0x5c,0x51,0x14,0x75,0x39,0x6f,0x59,0x29,0x4a,0x29,0xc5,0xc8,0xc8,0x88,0xee,0x18, + 0x69,0xa4,0x10,0x5e,0x6f,0x24,0xdc,0xe5,0xc2,0x2a,0xcd,0x8,0x18,0x45,0xa7,0x77, + 0x49,0x0,0x67,0xa0,0xf5,0xca,0x4a,0x2f,0xd6,0xbf,0x6f,0xd4,0xd6,0xab,0x4e,0x17, + 0x3f,0xf2,0x67,0x71,0x34,0xa,0x5,0x5,0x65,0x68,0xe1,0x52,0x89,0x22,0x73,0x73, + 0xa,0x75,0x3f,0x5c,0x50,0x3a,0x56,0x9c,0x3c,0x73,0xb2,0x2b,0x84,0xae,0x2d,0x7, + 0x7c,0x47,0x8,0xb9,0x69,0xdd,0xba,0x75,0x73,0xba,0xba,0xba,0xc6,0x2b,0xd5,0x73, + 0xea,0x52,0x78,0xb3,0x1b,0xe1,0x4e,0xeb,0x4e,0x4e,0x4e,0x1a,0xc2,0x35,0x84,0x5b, + 0x72,0x40,0x42,0x7f,0x9e,0x4,0x9,0x8b,0x84,0xa5,0x28,0xfe,0x2c,0xa5,0xf6,0xab, + 0x89,0x0,0x18,0xbf,0x56,0x47,0x41,0x0,0xd1,0x58,0xaf,0x85,0x4f,0x4c,0xdb,0xe6, + 0xb1,0xd4,0xde,0x65,0x32,0xbe,0x2f,0x5e,0xdd,0x4d,0x2c,0x90,0x7e,0x6d,0xa,0xb5, + 0x3f,0x9a,0xf,0xa2,0x92,0x52,0xc4,0x42,0x2c,0x16,0x73,0x45,0xb8,0x2e,0xf8,0xae, + 0x6e,0x62,0x62,0xe2,0xb5,0x0,0xee,0xaf,0x54,0xc9,0x96,0x70,0x37,0x6f,0xde,0x7c, + 0x9,0x80,0xd5,0x2e,0x85,0x3b,0xaa,0x3b,0x3c,0xac,0xdf,0xc7,0x88,0x10,0x2,0xe1, + 0x2d,0x19,0x43,0xbd,0x25,0xc2,0x72,0xdd,0x2a,0x94,0xc8,0x9,0x20,0x82,0x57,0xb9, + 0xb0,0x2c,0xd,0x27,0xe5,0xa8,0x3b,0xbd,0x4e,0x17,0x6e,0xbd,0x5a,0x94,0x23,0x1a, + 0x3c,0x7d,0x4c,0xfa,0xe6,0xa8,0x3b,0xcb,0xd3,0xe,0xea,0xbc,0x3c,0xf2,0x57,0x8e, + 0xeb,0x22,0x16,0x2a,0x4d,0x9e,0x69,0xe1,0xd1,0x65,0xfa,0x46,0xf8,0x25,0x5c,0x42, + 0xc8,0x1b,0xed,0x94,0xb3,0x10,0x5e,0x11,0xe5,0x93,0x65,0x84,0x10,0x90,0xf5,0x32, + 0xc8,0xb9,0xc6,0xd0,0x8d,0xc5,0xc2,0xb2,0x8a,0x3f,0x5e,0x58,0x96,0x86,0x93,0x36, + 0xa3,0x20,0x1d,0x27,0xba,0x70,0xeb,0x35,0xd8,0xc1,0xcb,0xeb,0x33,0x15,0xaa,0x4c, + 0xc6,0xf7,0x85,0xf5,0x33,0x95,0x7,0x5b,0xc2,0x5,0x80,0xcc,0xcd,0x29,0x43,0x88, + 0x58,0x3c,0x1e,0x37,0x84,0xa1,0x6a,0xe1,0xc3,0xb0,0xdc,0x76,0xd6,0x59,0x67,0x35, + 0x1e,0x3a,0x74,0x68,0xd4,0xaa,0xbe,0x1d,0xe1,0x12,0x55,0x55,0xdf,0xe8,0x51,0x78, + 0x45,0x8c,0x8e,0x8e,0x82,0x52,0xaa,0xcf,0x9b,0xf0,0x26,0xf3,0x9b,0xd0,0x46,0xe6, + 0xfb,0x5b,0xf0,0x60,0xf3,0x60,0x6,0x6b,0x69,0x98,0xcb,0xb4,0x2a,0x7,0x69,0x69, + 0xb8,0x2d,0x47,0xd1,0xe9,0xd,0x65,0x1e,0x4b,0x6d,0x5a,0x66,0x3e,0x90,0x31,0x78, + 0xa6,0xfc,0xb4,0x2d,0x23,0xcf,0x34,0x4a,0xa1,0x88,0xdc,0xc6,0x51,0xa8,0xad,0x79, + 0x8,0x83,0xd3,0x93,0x67,0xb1,0x58,0xcc,0x92,0x70,0x7d,0xbe,0xc5,0xd7,0xe4,0xf3, + 0xf9,0x9b,0x1,0xfc,0xcc,0xea,0x9c,0x8a,0x84,0x7b,0xf5,0xd5,0x57,0x5f,0x8,0x60, + 0x95,0x47,0xe1,0x15,0x31,0x32,0x32,0xa2,0xcf,0x9b,0x50,0x4f,0x21,0xbc,0xce,0x7c, + 0x59,0x5f,0x33,0x69,0x5,0x9d,0xfa,0x2b,0xc9,0x63,0x45,0x0,0x55,0x1a,0x4,0xee, + 0xaa,0x1c,0xb1,0xf5,0xaa,0x3d,0xce,0x82,0x5c,0xdd,0xca,0xb4,0x2a,0x87,0x75,0xcd, + 0x4e,0xae,0x23,0xac,0x1,0xdb,0x49,0x39,0xac,0x1,0xdb,0x8d,0x2e,0xac,0xdd,0x9, + 0x25,0x39,0x22,0x45,0x66,0xdb,0x10,0xea,0x7e,0x3a,0xbf,0x74,0x4c,0x9b,0x5f,0x41, + 0x57,0x97,0x8d,0xcb,0xf4,0x56,0x78,0x25,0x5c,0x41,0x10,0x5e,0xeb,0x53,0xb8,0x69, + 0xdd,0x5c,0x2e,0x67,0xdc,0x8d,0xf7,0xba,0x1c,0x50,0x67,0xde,0x4e,0xb,0x69,0x73, + 0x64,0xe1,0xda,0x12,0x0,0xb7,0x5e,0x3d,0xeb,0x12,0xc8,0x40,0xc2,0xad,0x57,0xd3, + 0x32,0x4c,0x74,0x9,0x7c,0xf0,0x8c,0x78,0x25,0xe0,0x24,0x26,0x10,0x14,0x32,0xaf, + 0xd1,0x13,0x2e,0xa0,0x5f,0x79,0xc6,0x30,0x5d,0x23,0x0,0xdc,0xb0,0x6e,0xdd,0xba, + 0x78,0x57,0x57,0x97,0xe9,0x8,0x62,0xe7,0x52,0xd8,0xe6,0x53,0xb8,0x69,0xdd,0xf2, + 0x85,0xe,0x0,0x20,0xfc,0x99,0xb9,0x75,0x4b,0x40,0x4c,0x2d,0xdc,0x20,0x3b,0x43, + 0x35,0x11,0xc0,0xd4,0x85,0x84,0x2f,0xd3,0xe3,0x3d,0xf2,0xf3,0x5b,0x78,0xbd,0xbf, + 0xa1,0xe,0x9e,0x3c,0x96,0xda,0x63,0xb9,0xf2,0xf7,0x69,0x3a,0x89,0xa0,0x20,0xaf, + 0xcc,0x40,0x5e,0x93,0x86,0xf4,0x6a,0xad,0x2e,0x5a,0x21,0x93,0xc9,0xd8,0x4e,0x9e, + 0x69,0xe1,0x90,0xeb,0x1a,0xc6,0xc7,0xc7,0xaf,0x1,0xf0,0xb8,0xd9,0x97,0x96,0x84, + 0xbb,0x71,0xe3,0xc6,0x16,0x0,0x57,0x32,0x50,0xc0,0x50,0x77,0x74,0x54,0xef,0x53, + 0x26,0x4d,0x14,0x64,0xb3,0xf9,0x2b,0x45,0x1d,0xa9,0x9f,0xda,0x9d,0xb7,0xb2,0x85, + 0x1b,0xb5,0xf5,0xaa,0xd3,0xc5,0x8f,0x4c,0xc6,0xd7,0x11,0x59,0xa7,0xe7,0x2b,0x1, + 0x4d,0xcb,0x66,0x72,0xc3,0x1a,0xb0,0x9d,0xd4,0x8f,0xaa,0xef,0xa4,0x11,0x1c,0xe1, + 0x2,0x40,0xa6,0x63,0x18,0xd,0x87,0xa7,0x97,0xfa,0x16,0x37,0x9a,0x74,0x4a,0xb8, + 0x6e,0xb8,0x8e,0x10,0x72,0x23,0xdc,0x12,0xae,0x20,0x8,0xd7,0x1,0x10,0xfd,0xa, + 0x2f,0xaf,0x9f,0xcd,0x66,0x8d,0x71,0x70,0xd7,0x66,0x81,0x18,0x4c,0x51,0x87,0x7a, + 0x50,0xb3,0x70,0xb0,0x19,0xbc,0x84,0xd1,0xac,0x33,0x84,0x2a,0x93,0x75,0xa7,0xe3, + 0xd6,0xab,0x77,0x99,0x8c,0xef,0x4b,0x35,0x5a,0xaf,0x4e,0xca,0x41,0x5a,0xb8,0x0, + 0x90,0xdd,0x3a,0x8c,0x86,0xef,0x2f,0xd6,0x1d,0x73,0x9a,0xb6,0xd1,0x43,0x6e,0xef, + 0x6d,0x0,0x3e,0x6e,0xf6,0x7d,0x25,0x97,0x82,0xa9,0x3b,0xc1,0xaf,0x63,0xd9,0xcc, + 0x9d,0x20,0xfe,0x99,0xb5,0xc3,0xbc,0x86,0xd4,0x42,0xa5,0x6c,0x22,0x14,0x58,0x77, + 0x86,0x20,0x2d,0xd,0x56,0xba,0x4,0xd2,0xe9,0x6d,0xaf,0x23,0x9a,0xc1,0xcb,0xec, + 0xba,0xfd,0xc,0x12,0x91,0xf,0x64,0x1,0x3e,0x53,0x51,0xf7,0x1d,0x9d,0x2e,0x94, + 0x6,0x4e,0xb8,0xca,0xe2,0x1c,0xe4,0x73,0xd2,0x90,0xe,0xd4,0x96,0x8e,0xc5,0xe3, + 0x71,0xa4,0xd3,0x69,0xdb,0xd5,0xb0,0x4e,0xa1,0xa9,0xbb,0x61,0xf5,0xea,0xd5,0xcb, + 0xf,0x1f,0x3e,0x7c,0xac,0xbc,0x8e,0x15,0xe1,0x92,0x29,0xb3,0x98,0x85,0x70,0x1d, + 0xc6,0xc6,0xc6,0xf4,0x82,0x9a,0x29,0xc8,0xd5,0xd6,0x84,0x9b,0x40,0xd,0x83,0x87, + 0x24,0xa2,0x4e,0xcf,0x78,0xb6,0x9a,0x75,0x67,0x60,0x43,0xae,0xee,0x64,0xfa,0xd2, + 0xc5,0x8f,0x7c,0x1e,0x4b,0xed,0xb9,0x6c,0x3b,0x78,0xb9,0x2d,0x97,0x5d,0x47,0xe, + 0x59,0x5f,0x3b,0x3d,0x38,0x45,0x3a,0x39,0x84,0x6,0xd,0xe1,0x2,0x85,0xfc,0xa, + 0x2c,0x36,0x9a,0x2c,0xaf,0xab,0x28,0xca,0xf5,0x0,0xee,0x2e,0xaf,0x67,0x4a,0xb8, + 0x53,0xe1,0x60,0xb,0x59,0x9,0x2f,0x22,0x9f,0xcf,0x1b,0xa3,0x13,0x5e,0x93,0xb3, + 0x74,0x27,0x0,0x85,0xed,0x93,0xdd,0xc6,0xe0,0x46,0x41,0x0,0xdc,0x7a,0xad,0x22, + 0x2,0xe0,0xd6,0xab,0x77,0x99,0xac,0x9f,0x5d,0x7,0xd7,0x30,0x46,0x2d,0xd7,0x9, + 0x30,0x45,0xb6,0x63,0x18,0xd,0xdf,0x5b,0xac,0xbd,0x44,0x53,0xb7,0x2,0x8b,0xa8, + 0x5,0x4a,0xe9,0x8d,0x70,0x4a,0xb8,0xa2,0x28,0x5e,0xef,0x25,0xa3,0x8e,0x5d,0xfd, + 0x89,0x9,0x7d,0xe8,0x7,0x21,0x4,0x64,0x6b,0xe5,0xf8,0xbb,0x38,0xe2,0x36,0xf, + 0x52,0x44,0x9d,0x3e,0xe2,0x30,0x1a,0x26,0x1d,0x30,0x82,0x65,0xb1,0x81,0x5c,0xf3, + 0x6c,0x88,0x46,0x39,0x83,0x63,0xa9,0x27,0xa8,0xfe,0xad,0x37,0x28,0x28,0x8b,0x72, + 0x90,0x57,0x65,0x20,0x1d,0x2e,0xec,0x10,0x5c,0xdc,0x7e,0x47,0xb,0x86,0xe9,0xb, + 0xae,0x45,0x61,0xe,0x4c,0xb7,0x8b,0x82,0x29,0xe1,0x52,0x4a,0x93,0x6e,0x85,0x3b, + 0xa9,0xaf,0x25,0xdc,0xe2,0x16,0xe8,0x95,0xdc,0x9,0x45,0x98,0x6d,0x1a,0x59,0x28, + 0x85,0x43,0x0,0x61,0x7,0x81,0x17,0x8f,0x32,0x97,0xe3,0xa2,0x33,0x84,0xd9,0xe9, + 0x5d,0x11,0x0,0x8f,0xa5,0xf6,0xac,0x4b,0x90,0xcf,0x94,0x1f,0x99,0xe3,0x8,0x87, + 0x70,0x1,0x20,0x7b,0xd5,0x8,0xa4,0xc3,0x35,0xba,0xed,0x77,0x44,0x51,0x84,0xa2, + 0x28,0xac,0x73,0xc5,0x34,0x2f,0x5f,0xbe,0xfc,0xa2,0x63,0xc7,0x8e,0x75,0x6a,0xf, + 0x9a,0x11,0xae,0x0,0x60,0x23,0xeb,0x44,0x35,0x94,0x52,0x4c,0x4e,0x16,0x1c,0xe3, + 0xc5,0x8b,0x25,0x97,0xe5,0x81,0xda,0xca,0xe7,0xca,0x90,0x51,0xf8,0x79,0x42,0xec, + 0xf4,0xdc,0x7a,0x65,0xab,0x8b,0x1f,0xf9,0xdc,0x7a,0xf5,0x5c,0xb6,0x1d,0xbc,0xdc, + 0x96,0x3,0x58,0x9,0x98,0x43,0xe,0x93,0x34,0xb8,0x45,0xf,0xe5,0xc8,0x5d,0x35, + 0x86,0x39,0xf7,0xe9,0xbc,0xa5,0xb6,0xdb,0xef,0x94,0xc3,0x5,0x37,0x5e,0x3,0xa0, + 0x32,0xe1,0xb6,0xb7,0xb7,0xaf,0x53,0x14,0xa5,0x89,0xb5,0xf0,0x74,0xba,0xb0,0xfb, + 0x84,0x76,0x39,0x2f,0xd9,0xe2,0xcc,0xba,0xf5,0x9a,0x47,0x21,0x2c,0x4b,0xc3,0x7d, + 0x39,0x38,0x4b,0xa3,0x52,0x1d,0xe6,0x1d,0x90,0x1,0x1,0xe8,0x74,0xe1,0xb1,0xd4, + 0xde,0x9f,0xe3,0x90,0x9e,0x29,0xd6,0x32,0xc7,0xa8,0x3e,0x1f,0x76,0xd0,0xc8,0xaf, + 0x9b,0x0,0x9d,0xa3,0x80,0x8c,0x4f,0x47,0xbc,0x4a,0x92,0xf3,0xbd,0xd4,0x5c,0x1a, + 0xa2,0xd7,0x0,0xf8,0x86,0xf6,0x98,0x41,0x92,0xa2,0x28,0xd7,0x4,0x21,0xbc,0xdc, + 0x7f,0xb,0x38,0x23,0x5c,0x19,0x32,0xe8,0xd4,0x5f,0x49,0x6e,0x48,0x9d,0x21,0xea, + 0x4e,0x6f,0xa9,0x4b,0x4,0xd6,0xab,0xa5,0x2e,0x7e,0xe4,0xf3,0x58,0x6a,0xef,0x32, + 0x59,0x3f,0xbb,0x11,0xc5,0x52,0x8f,0x52,0x7d,0x8a,0xd6,0xa0,0x41,0x45,0x8a,0xec, + 0x25,0x63,0xa8,0x79,0x62,0xda,0xa6,0x94,0x24,0x9,0x84,0x10,0x5b,0x3e,0xf3,0xf0, + 0xd6,0xbf,0xa9,0xfc,0xb8,0x19,0xb5,0x3b,0x22,0x5c,0xb7,0xc2,0x8b,0xee,0x84,0x12, + 0x96,0x2b,0x20,0xab,0x15,0xf3,0x13,0x34,0x50,0xa1,0xd8,0x5a,0xb8,0x61,0x59,0x1a, + 0xce,0xca,0xe1,0x58,0x1a,0xe5,0x65,0x33,0xb9,0x55,0x45,0x0,0xdc,0x7a,0xf5,0xac, + 0x4b,0x58,0xcf,0x54,0xd8,0x83,0x97,0xa,0x15,0xe3,0x21,0x4d,0x98,0x69,0x91,0xbd, + 0x72,0x54,0x47,0xb8,0xc5,0xc9,0x33,0xab,0xc4,0xe4,0x3e,0xe6,0xb2,0x16,0xaf,0x5c, + 0xb9,0x72,0x65,0x77,0x77,0x77,0x77,0xf1,0x80,0x6b,0xc2,0xf5,0x22,0x5c,0x96,0x65, + 0xc3,0xc5,0x90,0x76,0x67,0xd9,0x81,0x26,0xe9,0x4,0xe8,0xd4,0x5f,0xa9,0x4d,0x6, + 0x9d,0x21,0xea,0x4e,0x6f,0xa9,0xb,0xb7,0x5e,0x23,0x23,0x0,0xb3,0x32,0x8f,0xa5, + 0xe,0xae,0x4f,0x8d,0xd2,0xe1,0x40,0x52,0x32,0xda,0x21,0x77,0xe5,0x28,0x40,0x50, + 0xba,0x64,0x42,0x8,0xe2,0xf1,0xb8,0x29,0xe1,0xfa,0x9d,0xcb,0x92,0x65,0x79,0x13, + 0x80,0xee,0xe2,0x67,0x1d,0xe1,0x5e,0x73,0xcd,0x35,0x8b,0x51,0x21,0x1d,0xa3,0x57, + 0xe1,0x66,0xb9,0x27,0x85,0x2b,0xed,0x97,0xd4,0x1,0xc0,0x38,0x1d,0x33,0xdd,0xe9, + 0x21,0xea,0x89,0x88,0x20,0x2d,0xd,0x2b,0x99,0x56,0x75,0xaa,0x82,0x0,0x18,0xbf, + 0x56,0x47,0x41,0x0,0x3c,0x96,0x3a,0xdc,0x7e,0x34,0x4c,0x53,0x88,0x2,0x4a,0x6b, + 0x1e,0xca,0xb2,0x2c,0xc4,0x63,0x89,0xd2,0x9c,0x92,0x28,0x1a,0xb3,0x18,0xb0,0x8, + 0x1c,0x20,0x84,0x5c,0x3,0xe0,0xa7,0xc5,0xcf,0x52,0xf9,0x97,0x56,0x27,0xfa,0x11, + 0x6e,0x46,0xb8,0xe4,0x32,0xe7,0x84,0x4b,0x41,0x3d,0x77,0x86,0xa8,0x3b,0xbd,0x4e, + 0x97,0x88,0xad,0x57,0x9d,0x2e,0x7e,0xe4,0x33,0x27,0xa6,0x88,0x3a,0x3d,0xb7,0x5e, + 0xd9,0xea,0xe2,0x42,0x7e,0x9e,0xe6,0x31,0x41,0x2b,0xee,0xb7,0x18,0x28,0x72,0x1b, + 0xc6,0x51,0x77,0xbc,0xa6,0xf4,0xb9,0xdc,0x8f,0xcb,0x30,0x4a,0x4b,0xe7,0x31,0xd0, + 0x11,0xae,0xaa,0xaa,0x97,0xea,0x92,0x82,0x3b,0x6b,0xd0,0xb6,0xae,0x81,0x70,0x97, + 0x2b,0x40,0x9b,0xb3,0x57,0x89,0x3c,0x72,0xc8,0xd2,0x8c,0x6e,0x1,0x4,0x10,0x6c, + 0x67,0x8,0xcf,0xd2,0x98,0x96,0x69,0x55,0xa7,0x2a,0x8,0x80,0x5b,0xaf,0x9e,0x74, + 0x9,0x64,0x20,0x99,0x21,0xd6,0xab,0xdd,0x35,0x8c,0xd0,0x21,0x44,0x89,0xfc,0x86, + 0x9,0xe0,0xe1,0x36,0xdd,0xb1,0x80,0x76,0xf4,0x3d,0x7f,0xf1,0xe2,0xc5,0x75,0x27, + 0x4f,0x9e,0x9c,0x4,0x8c,0x16,0xee,0x85,0x2e,0x1b,0xb3,0x15,0x4e,0x29,0x45,0x36, + 0xab,0x5f,0x27,0x2d,0x5c,0xea,0x3c,0xe6,0xd,0x0,0xc6,0xe9,0x28,0x9a,0x48,0xcb, + 0x74,0x9b,0x2c,0x3a,0x60,0x80,0x9d,0x21,0x54,0x99,0x2e,0xc8,0xc0,0xd,0xb9,0xb2, + 0xd4,0x85,0xf9,0x40,0xe6,0x44,0x26,0x8f,0xa5,0x66,0xab,0x8b,0x1f,0xf9,0x65,0xd7, + 0x41,0x11,0x3d,0xe1,0x66,0xd7,0x19,0xad,0x6b,0x37,0x84,0xeb,0x82,0x1b,0x45,0x41, + 0x10,0xd6,0x3,0x78,0x1e,0x30,0x4e,0x9a,0x5d,0xe0,0xa1,0xc1,0x8a,0xf5,0x33,0x99, + 0x4c,0xe9,0xbb,0xd2,0x82,0x87,0x4b,0x9c,0xb9,0x13,0x8a,0x18,0xa0,0x7d,0x98,0x4b, + 0x9a,0x99,0x77,0x86,0x60,0x2d,0xd,0x73,0x99,0x56,0xe5,0xc8,0x8,0x80,0xf1,0x6b, + 0x75,0x14,0x4,0xc0,0x57,0x2,0x86,0x38,0x90,0xd9,0xfd,0x46,0xe,0xae,0x61,0x94, + 0xe,0x23,0xf,0x77,0x1c,0xc0,0x1a,0xca,0x92,0x2c,0xd4,0x66,0x19,0xc2,0xd0,0x34, + 0x5,0x96,0x2f,0xf3,0xb5,0x82,0x5b,0x6e,0x4,0xb0,0x1,0xe5,0x84,0x9b,0x4c,0x26, + 0xdb,0xf2,0xf9,0xfc,0x62,0xb7,0xd,0xda,0xd5,0x2d,0xba,0x13,0x74,0xb,0x1e,0x2e, + 0x75,0x77,0xb3,0xfb,0xe8,0x69,0xac,0xc2,0xd9,0x5,0x79,0x11,0x74,0x7a,0x0,0xdc, + 0x7a,0xad,0x22,0x2,0xe0,0xd6,0x6b,0x70,0x83,0x57,0x18,0xcf,0xd4,0x70,0xc4,0xd6, + 0x2d,0x0,0x80,0x0,0xb9,0xf3,0xc7,0x51,0xf3,0xb4,0xbb,0x78,0x5c,0xaf,0xe9,0x1a, + 0x4b,0x32,0x8a,0x85,0x7c,0x3e,0xbf,0xc1,0x47,0x83,0x96,0xc8,0x64,0x32,0xfa,0xcd, + 0x22,0xe7,0xaa,0xc0,0x59,0xee,0x5c,0xa,0x3,0x6a,0x1f,0xa8,0x48,0x3d,0x3f,0x18, + 0x41,0x5a,0x1a,0x6e,0xdb,0xf,0x95,0x0,0x18,0x13,0x53,0x90,0x83,0x8a,0x57,0x72, + 0xd,0xa6,0x1c,0x40,0xdb,0x3c,0x96,0x1a,0x40,0x61,0xef,0xb2,0x30,0x52,0x31,0x3a, + 0x41,0x7e,0xc3,0x84,0x8e,0x70,0x8b,0x79,0x15,0xac,0x96,0xf9,0xfa,0xe0,0xc6,0x92, + 0xe7,0xa0,0x44,0xb8,0x84,0x90,0xb,0x2,0xd8,0xdf,0xc7,0x18,0x7f,0xbb,0x4e,0x2e, + 0xc4,0xc0,0xb9,0xc0,0x0,0xed,0xd5,0xc4,0xeb,0x85,0xd3,0x19,0xc2,0x22,0x1a,0x67, + 0xe5,0x60,0x2c,0xd,0xbb,0x72,0x14,0x4,0xc0,0x63,0xa9,0x83,0x1b,0xbc,0x58,0xf, + 0xd8,0xee,0x75,0x51,0x91,0x52,0xfb,0x51,0x2d,0xc8,0xad,0x2d,0xac,0x7e,0xd5,0x1a, + 0x84,0x66,0xbb,0xf9,0x2,0xbe,0xc8,0x16,0x30,0xb3,0x70,0x15,0x45,0xd9,0x60,0x16, + 0xa1,0xe0,0xb0,0x41,0x53,0x28,0x8a,0x62,0x54,0xfe,0x3c,0x77,0xd6,0x2d,0x0,0x8c, + 0xd2,0x91,0x42,0xa4,0x2,0x89,0x4f,0xeb,0xe0,0xb5,0xd3,0x71,0xeb,0xd5,0xbb,0x4c, + 0xc6,0xf7,0x85,0x5b,0xaf,0xe1,0x5d,0xbf,0xdd,0x75,0x87,0x31,0x60,0x8f,0xd3,0xb1, + 0xc8,0x7d,0xb7,0x5a,0xc8,0x6b,0xd2,0x20,0x2,0xd1,0xaa,0x69,0xc8,0xab,0xc0,0x68, + 0x2e,0xab,0x6d,0xd9,0xb2,0x65,0x8b,0x8f,0x1f,0x3f,0x7e,0x52,0x6b,0xe1,0x6e,0x30, + 0xab,0xe9,0x47,0xb8,0xd9,0x8c,0x1f,0x39,0xd7,0x3d,0xe1,0x2,0xc0,0x29,0xda,0x83, + 0xe5,0x64,0x55,0x0,0x9d,0x21,0x8a,0x4e,0x6f,0xfe,0x60,0x6,0x69,0x69,0x58,0xc9, + 0xb4,0xaa,0x13,0xc8,0x75,0xf2,0x58,0x6a,0xb6,0xba,0xf8,0x91,0x1f,0x72,0x2c,0x35, + 0x45,0xf4,0x91,0x9,0xe5,0x50,0xeb,0x15,0x28,0xf3,0x72,0x10,0xfb,0xa6,0xd,0x39, + 0xed,0x2,0x8,0xc6,0xee,0xd5,0xd,0x0,0x4a,0x84,0x4b,0x0,0x9c,0xef,0xb3,0x41, + 0x43,0x5d,0xd3,0x10,0x8b,0x73,0xbc,0x11,0xee,0x31,0xf5,0x8,0x96,0xa,0x2b,0xa, + 0xed,0xfb,0x78,0x88,0x58,0x74,0x86,0xc0,0x9,0x80,0xf1,0x6b,0x75,0x14,0x4,0xc0, + 0x57,0x2,0x6,0x3b,0x78,0x79,0x7d,0xa6,0x42,0x95,0xa9,0x29,0x8f,0xd0,0xa1,0xa9, + 0x54,0xab,0xd5,0x85,0xfc,0xea,0xb4,0x8e,0x70,0x8b,0x16,0x2e,0xeb,0xb9,0x2c,0x0, + 0xeb,0x0,0xfc,0x4e,0x2,0x80,0x6b,0xae,0xb9,0x66,0x11,0xa5,0x74,0x8e,0xcf,0x6, + 0xd,0x75,0xd,0x84,0x1b,0x3,0xc8,0x59,0xf6,0x9,0x6b,0xcc,0xd0,0xa3,0x1e,0x5, + 0x9d,0xfa,0x33,0x93,0xe5,0x65,0xd4,0xd,0xa3,0x6c,0x4b,0x0,0xdc,0x7a,0xf5,0x2e, + 0x93,0xf1,0x75,0x70,0xeb,0x35,0x98,0x7e,0x24,0xd3,0x7c,0x68,0xdb,0xe8,0xb8,0x85, + 0xbc,0x2a,0xd,0x3c,0x3b,0xb7,0xf4,0x59,0x10,0x4,0x57,0xe7,0xbb,0xe0,0xc6,0xb3, + 0x81,0x29,0x1f,0xae,0xa2,0x28,0xab,0xac,0x4,0xf9,0x61,0x7a,0xc3,0x84,0xd9,0x4a, + 0x5,0x88,0x3b,0x6f,0x4f,0x8b,0x61,0x9a,0xc2,0x28,0x1d,0xc1,0x1c,0x34,0x4,0xda, + 0x19,0xc2,0xb2,0x34,0x58,0xe9,0x15,0xc9,0xa0,0x12,0xb1,0xf5,0xaa,0x3d,0xee,0xab, + 0x6d,0x1e,0x4b,0xed,0x5d,0xa6,0x8b,0xf2,0x10,0x4d,0x95,0xb5,0x5f,0x3d,0xc8,0xaf, + 0x4a,0x1b,0x8e,0x55,0xca,0x1c,0xa6,0x85,0x1b,0x6e,0x54,0x14,0x65,0x25,0x30,0x45, + 0xb8,0xa2,0x28,0xae,0xb4,0x5a,0x25,0xe6,0x14,0x66,0x75,0xb5,0x4a,0x13,0x42,0x3c, + 0xfb,0x6f,0x8b,0x38,0xa9,0x1e,0xc7,0x59,0xc2,0x5a,0xad,0xd4,0xa9,0xff,0x57,0x29, + 0x1,0x44,0x60,0xbd,0x5a,0xea,0xe2,0x47,0x26,0xf3,0xd9,0xea,0xf0,0x3b,0x7d,0xe1, + 0x32,0xaa,0x6f,0xf0,0xa,0x6b,0xc0,0xae,0x54,0xe,0xb2,0x1f,0x4d,0xd2,0xea,0x9, + 0x3,0x33,0x83,0xbc,0x46,0x4f,0xb8,0x84,0x10,0xdb,0x15,0x67,0x5e,0x26,0xd2,0x8, + 0x21,0xab,0x80,0x29,0xc2,0xa5,0x94,0xae,0x2a,0xaf,0xe0,0xb6,0xc1,0x72,0xc8,0xb2, + 0x8c,0x62,0x98,0x59,0x29,0xfa,0xc1,0x65,0xfc,0x6d,0x39,0x8e,0xa8,0x7,0x71,0x96, + 0x70,0x2e,0xf3,0x7,0x3d,0x48,0x4b,0xc3,0x8f,0x2e,0x51,0x10,0x0,0xb7,0x5e,0x83, + 0x1d,0xbc,0x58,0x3c,0x53,0x61,0xd,0xd8,0x4e,0xca,0x95,0xbe,0x97,0x69,0x3e,0xf4, + 0x4,0xe3,0x6e,0x91,0x5f,0x92,0x1,0x95,0x28,0x88,0x4c,0x4a,0x3c,0x55,0x69,0x7, + 0x8,0x1f,0xdc,0xb8,0x2,0x0,0x91,0x34,0x1f,0x5c,0x37,0x58,0xa9,0x6e,0x31,0x1c, + 0x4c,0x17,0x6a,0xb6,0xc2,0x9b,0xff,0xb6,0x88,0x93,0xea,0x71,0x4c,0x62,0x2,0x35, + 0xa8,0x8d,0x84,0x0,0xb4,0xe5,0xa8,0xad,0x57,0x9d,0x2e,0x7e,0x64,0x32,0xbe,0x8e, + 0x28,0x3a,0x7d,0xe1,0x32,0x2a,0xeb,0x12,0xc9,0xe0,0xa5,0x2b,0xb3,0x19,0x24,0x22, + 0x1f,0xc8,0x1c,0x3e,0x53,0x14,0x85,0xa8,0x4,0xbd,0x2e,0x55,0x88,0x18,0x85,0x32, + 0x3f,0x87,0xd8,0xa9,0xe9,0xcc,0x61,0x41,0xb8,0x57,0x1,0xd4,0xac,0x58,0xb1,0x62, + 0x61,0x91,0x70,0x57,0x31,0x68,0x50,0x7,0x59,0x96,0x51,0x1e,0xd7,0x4b,0x96,0xfa, + 0x23,0x5c,0x15,0x2a,0x8e,0xa9,0x47,0x74,0x6e,0x85,0xd0,0x8,0x80,0xf1,0x6b,0x75, + 0x54,0x4,0x0,0x9b,0xd7,0xea,0x48,0x6,0x2f,0xb7,0x6d,0xf3,0x58,0x6a,0xef,0x32, + 0x19,0xdf,0x17,0xab,0x1,0x7b,0xc,0xa3,0x55,0x19,0x95,0x60,0x6,0x75,0x61,0xe, + 0xd0,0x10,0x6e,0x50,0xb9,0x71,0xf3,0xf9,0xfc,0xaa,0x22,0xe1,0x9a,0xfa,0x70,0xdd, + 0x36,0xa8,0x85,0xe9,0xf2,0xb8,0x25,0xfe,0x8,0x17,0x0,0xe,0x2b,0x7,0xb0,0xc6, + 0xa7,0x5b,0xc1,0x96,0x0,0xb8,0xf5,0xea,0x59,0x97,0x40,0x3a,0x3d,0xb7,0x5e,0x4d, + 0xcb,0x66,0x72,0xc3,0x1a,0xb0,0x2b,0xd5,0x49,0x63,0x12,0x69,0x5a,0xb6,0xa5,0x56, + 0x15,0x43,0x59,0x94,0x3,0x76,0x4e,0x7f,0x2e,0x27,0x5c,0x56,0xdc,0x28,0x8,0xc2, + 0x4a,0xe9,0xb6,0xdb,0x6e,0x13,0x7b,0x7a,0x7a,0x96,0xb3,0x68,0x50,0xb,0x3,0xe1, + 0xd6,0x50,0xa0,0xd5,0xff,0x76,0x1a,0x7d,0xf4,0x34,0xc6,0xe8,0x28,0xea,0xc9,0x1c, + 0x76,0x4,0xc0,0xad,0x57,0xef,0x32,0x5d,0xdc,0x17,0xaf,0xe4,0xea,0x56,0x26,0x33, + 0x5d,0x2,0x7c,0xa6,0xc2,0x1a,0xb0,0x9d,0x94,0x59,0xe,0xd8,0x79,0x44,0x9b,0x58, + 0xdc,0xb,0xe4,0x85,0xfa,0x49,0x3d,0x42,0x8,0x4,0x41,0x80,0xa2,0xb8,0x33,0x10, + 0xed,0xb8,0x91,0x52,0xba,0x4a,0x3a,0x79,0xf2,0xe4,0x2,0x0,0xb6,0x79,0xc9,0xdc, + 0x3a,0x8b,0xf3,0xf9,0xb2,0x25,0x7c,0x4b,0x15,0xd7,0x39,0x14,0x4c,0xf5,0x0,0xc5, + 0x1,0xf5,0x65,0x5c,0x28,0x5e,0xa6,0x3b,0xa6,0xad,0x61,0x76,0xdc,0xac,0x33,0x84, + 0xda,0x1,0x19,0x93,0x41,0x90,0x93,0x5b,0xa1,0x76,0x7a,0x1e,0x4b,0x5d,0x51,0xa6, + 0x55,0x9d,0x20,0x7,0x6c,0xb7,0xe7,0x16,0xff,0x2d,0x6c,0xa,0x39,0x5a,0x76,0x1d, + 0xd5,0x8f,0x72,0xc2,0x5,0xa,0x56,0xae,0x53,0xc2,0x75,0xc1,0x8d,0xcb,0x24,0x4a, + 0xe9,0x7c,0x86,0xd,0x96,0xea,0x1b,0x2c,0x5c,0x6,0xee,0x84,0x22,0xe,0x29,0xaf, + 0xe0,0x7c,0xe1,0x2,0x48,0x64,0x7a,0x36,0x31,0xbc,0xce,0x10,0x51,0xa7,0x67,0x3c, + 0x5b,0xcd,0x7a,0x20,0x61,0x43,0xae,0xee,0x64,0xfa,0xd2,0xc5,0x8f,0x7c,0xbe,0x12, + 0xd0,0x50,0x56,0xa1,0x62,0x8c,0x8e,0x44,0xb2,0x29,0xa4,0x5f,0x28,0x26,0x16,0xae, + 0x99,0x1f,0xd7,0xc,0x2e,0xb9,0x71,0x9e,0x44,0x29,0x6d,0x65,0xd5,0xa0,0xb6,0x6e, + 0xf9,0xe8,0x40,0x96,0xb1,0xfb,0x21,0xf2,0xc8,0xa1,0x5b,0x3d,0x84,0x35,0xe2,0xb9, + 0x5,0xb9,0x26,0x9d,0x21,0xa,0xd2,0xb1,0x2a,0x87,0x65,0x69,0xf8,0xd1,0x25,0x90, + 0x4e,0xcf,0xad,0xd7,0x8a,0x32,0xad,0xea,0x84,0x35,0x60,0x3b,0x29,0x3b,0xa9,0xab, + 0x42,0xc5,0x84,0x66,0xb3,0xd7,0x99,0x6,0x65,0x91,0x7e,0xbd,0x0,0x60,0x3e,0x71, + 0x56,0xe,0xf,0xdc,0xd8,0x26,0x51,0x4a,0xdb,0xac,0xb2,0x84,0x79,0x25,0x5b,0x55, + 0x55,0x75,0x9f,0x9,0x21,0x20,0xf3,0xd8,0xfe,0x18,0x7,0xd5,0x57,0xb0,0x4a,0x38, + 0x7b,0x5a,0x7e,0x58,0x1d,0x30,0x82,0xce,0x10,0x24,0xd1,0xb8,0x3d,0xd7,0xf,0x31, + 0xb1,0x26,0xd8,0x40,0xae,0x99,0xc7,0x52,0xbb,0x2c,0xab,0x98,0xa4,0x13,0x50,0xc0, + 0xee,0xd,0x36,0x6c,0x28,0x73,0xf3,0xa0,0x2,0x85,0x40,0xa7,0xc3,0xc1,0xec,0x96, + 0xf8,0x7a,0xe4,0xc6,0x56,0x49,0x10,0x84,0x56,0xd6,0xab,0xcc,0xb4,0xd6,0x6d,0x89, + 0xcc,0x9b,0xd9,0x12,0xee,0x28,0x1d,0xc6,0x51,0xf5,0x30,0x96,0x9,0x2b,0xa7,0xf5, + 0x8,0x89,0x74,0xac,0xca,0x41,0x5a,0x1a,0x7e,0x74,0x9,0xa4,0xd3,0xbb,0x20,0xd8, + 0x30,0x7,0x2f,0xbb,0xeb,0x66,0x41,0xae,0x6e,0x65,0x5a,0x95,0xc3,0x1a,0xb0,0x83, + 0xd0,0xa5,0xf0,0x89,0xce,0x78,0xb2,0x5,0x0,0x8,0x28,0x6c,0x8c,0x30,0xec,0x8c, + 0x70,0x7d,0x70,0x63,0x9b,0xc1,0xa5,0xc0,0x62,0x95,0x99,0xa2,0x28,0x86,0x18,0x5c, + 0x34,0xb1,0x7f,0xdd,0xe8,0x52,0x5f,0xc2,0x62,0x61,0x19,0x4,0x8,0xae,0x3a,0x43, + 0xa8,0x9d,0x9e,0x5b,0xaf,0x6c,0x75,0xf1,0x23,0x9f,0x5b,0xaf,0x9e,0xcb,0xe5,0xd7, + 0x4a,0x41,0x91,0xa6,0x93,0x33,0x9f,0x6c,0xa7,0xa0,0x34,0xe6,0x21,0xc,0x4f,0xcf, + 0x9,0x99,0x11,0x2e,0x3,0x6e,0x6c,0xd1,0xb9,0x14,0x58,0xc5,0x9b,0x99,0xee,0x1c, + 0xc1,0xd8,0xc2,0x5,0xa,0xeb,0xb4,0x8f,0xaa,0xaf,0x62,0x85,0xb0,0xa6,0xa0,0x53, + 0x48,0x9d,0x21,0x48,0x4b,0xc3,0x7d,0x39,0x80,0xb6,0x3d,0x12,0x6c,0x94,0x4,0x60, + 0xd0,0x85,0xc7,0x52,0x7b,0xd6,0xc5,0xf6,0xde,0xa2,0x40,0xb6,0x33,0xd5,0x67,0x6b, + 0x6,0xda,0xa8,0x1f,0x38,0xca,0x9,0x97,0x11,0x37,0xc6,0x4a,0x2e,0x5,0x96,0xb, + 0x1f,0x4c,0x9,0x37,0x0,0xb,0x17,0x0,0xf6,0xab,0x5d,0x58,0x2a,0xac,0x80,0x80, + 0xe9,0x1b,0x14,0x16,0x1,0xb8,0xe9,0xc,0x51,0x77,0x7a,0x4b,0x5d,0x22,0x4e,0x49, + 0xc8,0xec,0x9a,0x79,0x2c,0xb5,0x77,0x99,0x2e,0xee,0x8b,0x2,0x5,0x39,0x9a,0x9d, + 0x55,0x64,0xb,0x0,0x6a,0xa3,0x3e,0xaa,0x4a,0x4b,0xb8,0x2c,0xb9,0x51,0xa2,0x94, + 0xb6,0xb1,0x5e,0x65,0x66,0x46,0xb8,0xb4,0x49,0x65,0x11,0x86,0x6b,0x40,0x9a,0x4e, + 0xe2,0x65,0x65,0x37,0xd6,0x89,0x17,0x6,0x4a,0x0,0xdc,0x7a,0xad,0x22,0x2,0xe0, + 0xd6,0xab,0x67,0x5d,0xfc,0x3c,0x53,0x32,0x95,0x91,0x47,0xae,0xac,0xbd,0xd9,0x1, + 0xa5,0x51,0xbf,0x6e,0xa0,0x48,0xb8,0xac,0xb9,0x51,0xa2,0x94,0xce,0xb5,0xad,0xe5, + 0xa2,0x41,0xc0,0x9c,0x70,0x49,0x73,0x70,0x3f,0x52,0xb7,0x7a,0x8,0x4b,0x84,0xe5, + 0x68,0x24,0x73,0xd9,0x75,0xc0,0x0,0xc3,0x68,0xc2,0xb2,0x24,0xa3,0xb6,0x5e,0x75, + 0xba,0xf8,0x91,0xcf,0x63,0xa9,0xbd,0xcb,0x64,0xf4,0xec,0x2a,0x54,0x41,0x1e,0xf6, + 0x39,0x62,0x67,0x2a,0xb4,0x16,0x2e,0x21,0xc4,0x76,0xbb,0xf4,0x72,0x38,0xad,0x2b, + 0x51,0x4a,0x6b,0xec,0x36,0x8f,0x74,0xeb,0x2c,0x36,0xac,0xd0,0xa8,0xa5,0x40,0x2c, + 0x38,0xc2,0x55,0xa1,0x62,0xb7,0xd2,0x89,0x8d,0xd2,0x16,0x90,0x29,0x3b,0xda,0xcd, + 0xc3,0x15,0xf5,0x44,0x44,0xd4,0xd6,0xab,0xb6,0x5c,0x15,0x4,0xc0,0x63,0xa9,0x3d, + 0xe9,0x12,0xc8,0x40,0x42,0x29,0x64,0xe4,0x67,0xcd,0xe4,0x98,0x15,0xd4,0x29,0x1f, + 0xae,0x96,0xb,0x5,0x41,0x30,0x77,0x8f,0x6a,0xe0,0x96,0x1b,0x25,0x42,0x34,0x5b, + 0xe1,0x32,0x68,0xd0,0xac,0x3e,0xa9,0x75,0xd5,0x84,0x27,0x8c,0xd0,0x21,0x1c,0x55, + 0x5f,0xc5,0x72,0x61,0xf5,0xb4,0x2e,0x8c,0x3b,0x43,0xd4,0x9d,0x5e,0xa7,0xb,0xb7, + 0x5e,0x2d,0xca,0x11,0xd,0x9e,0x33,0xd8,0x7a,0x9d,0xbe,0x4,0xfd,0x71,0x8a,0x2, + 0xd9,0xea,0x65,0xce,0x4e,0xd0,0xb8,0x6a,0xcc,0x6e,0xc8,0xd8,0x10,0xa5,0x94,0x42, + 0x2,0x60,0x49,0xb8,0x7e,0x16,0x3e,0x14,0x41,0x8,0x1,0xa4,0x70,0x1c,0xec,0xfb, + 0x95,0x2e,0x34,0x92,0x26,0x34,0x92,0x26,0xad,0x62,0xd3,0xc5,0x30,0x3b,0x20,0xeb, + 0x4e,0xc7,0xad,0x57,0xef,0x32,0x19,0x13,0xd3,0x99,0x10,0x4b,0x4d,0xa1,0xce,0x98, + 0xf4,0x8a,0x4c,0x60,0xf2,0x6,0x5e,0x89,0x70,0xbd,0x72,0xa3,0x4,0x20,0xc1,0xb2, + 0xc1,0x22,0x74,0xca,0x9a,0x4a,0x60,0xf,0x15,0x2a,0x76,0x29,0x3b,0x70,0x95,0xd8, + 0x8e,0x18,0x62,0x81,0x76,0xba,0xb0,0x3a,0x43,0xd4,0xd6,0xab,0xb6,0x1c,0xbd,0xf5, + 0x3a,0x2d,0x37,0x6a,0xeb,0x55,0x5b,0x8e,0xda,0x7a,0x75,0xa4,0x8b,0x8b,0x1,0x5b, + 0x81,0x32,0xeb,0xa2,0x10,0xec,0x40,0x4d,0xf6,0x5a,0x64,0xbd,0x2,0x17,0x80,0xb9, + 0x85,0xcb,0xdc,0x59,0x1c,0xa0,0xff,0xb6,0x1c,0x19,0x9a,0xc6,0x3e,0x65,0x37,0xd6, + 0x8b,0x17,0x3,0x8,0xaf,0x33,0x44,0x6d,0xbd,0x32,0xd3,0xc5,0x8f,0x7c,0xc6,0xaf, + 0xd5,0xac,0x7,0x15,0x6e,0xbd,0x56,0x1e,0xbc,0x28,0xe8,0xac,0xf7,0xd5,0x5a,0x81, + 0x8a,0xce,0x6,0x18,0xbf,0xdc,0xa8,0x23,0x5c,0x16,0xfe,0x5a,0xd3,0xe3,0xb6,0xc9, + 0x1f,0xd9,0xa2,0x97,0x9e,0x42,0x83,0x3a,0xd7,0x74,0xd9,0x6f,0xd4,0x9d,0x1e,0x40, + 0x55,0x5a,0xaf,0xfa,0x32,0x9b,0xe,0x1d,0xf9,0x40,0xc6,0x98,0x60,0xa3,0xb6,0x5e, + 0x2d,0x75,0x61,0x30,0x60,0xab,0x50,0xcb,0xea,0x9f,0x61,0xb0,0xb1,0x70,0x59,0x71, + 0x63,0xc9,0xa5,0x10,0x44,0x8,0x44,0x9,0x1e,0xb7,0x46,0xf7,0x83,0x57,0xd5,0xfd, + 0x48,0x90,0x1a,0xb4,0x91,0xe9,0xec,0x93,0x2c,0x3a,0x43,0xd4,0xd6,0xab,0x2f,0x5d, + 0xfc,0xc8,0x67,0xfc,0x5a,0x1d,0xe4,0xa0,0x12,0xb5,0xf5,0xaa,0x2f,0x7,0x37,0x60, + 0x57,0xaa,0xe3,0x74,0xf0,0xa2,0x53,0x7f,0x67,0x3a,0xd4,0x98,0xb5,0x85,0xcb,0x74, + 0xe1,0x3,0x80,0x78,0xe0,0xb,0x1f,0x42,0x74,0x29,0x14,0x41,0x41,0x4b,0xae,0x85, + 0xb9,0xa4,0x59,0x77,0x5c,0x5b,0xcb,0xec,0x38,0xeb,0xce,0xc0,0xad,0x57,0x73,0xb9, + 0xdc,0x7a,0x75,0xa0,0x4b,0x48,0x3,0xf6,0x19,0xf,0x49,0x7f,0x2f,0x8a,0xbb,0x3e, + 0x4,0xb1,0xf0,0xa1,0x72,0x1e,0x32,0x97,0xd,0x2,0x26,0xce,0xe6,0x20,0x96,0x98, + 0x39,0x80,0xa,0x15,0xfb,0x94,0x3d,0xb8,0x40,0xbc,0x4,0xb5,0xa4,0x1e,0x76,0xf, + 0x26,0xb7,0x5e,0xd9,0xe8,0x12,0xe4,0xa0,0xc2,0xad,0x57,0x73,0xb9,0xee,0x7f,0x23, + 0xe,0x2d,0xa8,0x50,0xb8,0x37,0x5e,0xdd,0x8,0x8e,0x17,0x3e,0x0,0xc8,0x1,0xa8, + 0xb1,0xab,0xe8,0xda,0x8d,0xa0,0x85,0x1c,0x11,0xe3,0xa2,0x90,0xac,0x7c,0xb7,0xd2, + 0x89,0xf5,0xe2,0xc5,0xa8,0x23,0xf5,0x1,0x77,0x86,0x28,0x3a,0xbd,0x79,0x67,0x8c, + 0xda,0x7a,0xd5,0x96,0xa3,0xb6,0x5e,0x59,0xe9,0xc2,0xfa,0xf7,0xd,0x33,0x96,0x9a, + 0xa3,0x32,0x84,0xbc,0x60,0x30,0x14,0x9d,0x72,0x9e,0x1b,0x6e,0x74,0x44,0xb8,0x7e, + 0x98,0x9e,0x10,0x2,0xe4,0x49,0xa4,0x3f,0x7d,0x1e,0x79,0xec,0x55,0x5e,0xc2,0xf9, + 0xe2,0x5,0xce,0x49,0x37,0xa4,0xce,0x10,0xb5,0xf5,0xea,0x56,0x97,0xb0,0x6,0x95, + 0xe8,0xad,0xd7,0xc2,0x27,0xa6,0x6d,0x87,0x14,0x4b,0xcd,0xe1,0x1,0x1e,0x8c,0x42, + 0xaf,0xb,0x1f,0x2c,0x17,0x48,0x7b,0x9d,0x99,0x13,0x84,0xb2,0xd1,0x22,0x42,0xb, + 0xb7,0x88,0x3c,0x72,0xd8,0xa7,0xec,0xc1,0x5a,0x71,0x3d,0x6a,0x49,0x1d,0x0,0xb7, + 0x9d,0x21,0x9a,0x4e,0xcf,0xad,0xd7,0x2a,0x1a,0xbc,0xdc,0xe8,0xc2,0xad,0xd7,0x19, + 0x5,0x92,0x77,0x97,0xff,0xd6,0x2b,0x37,0x4a,0x0,0x8c,0x5b,0x56,0xba,0x6c,0xd0, + 0xd4,0xaa,0xd5,0x7e,0x6f,0x2a,0x21,0x7c,0xe4,0x90,0xc5,0xcb,0xca,0x2e,0xac,0x11, + 0xcf,0x45,0x23,0xa,0xab,0xd1,0x42,0xeb,0x80,0x41,0x10,0x0,0x63,0x62,0x8a,0x64, + 0x50,0x89,0xd8,0x7a,0xd5,0x1e,0xb5,0x5e,0x1a,0xfc,0x0,0x0,0x20,0x0,0x49,0x44, + 0x41,0x54,0x8f,0xda,0x7a,0x75,0xa2,0xb,0x47,0x30,0x20,0x26,0x46,0xa1,0xe3,0xb0, + 0xd7,0xa,0x30,0x5b,0xf8,0x60,0xb0,0x70,0x59,0x3b,0x8b,0x49,0xc4,0x2e,0x5,0x2d, + 0x64,0xc8,0x38,0xa0,0xbc,0x8c,0x25,0xc2,0x72,0x2c,0x20,0x8b,0x35,0xdf,0x4,0x67, + 0xb1,0x31,0x21,0x80,0x88,0x53,0x12,0x46,0x6d,0xbd,0xfa,0xd1,0x25,0x90,0x81,0x24, + 0xa4,0x58,0x6a,0x8e,0x70,0xe0,0xd4,0xc2,0x65,0xb1,0xf0,0x21,0x67,0x57,0xc9,0x4d, + 0x83,0x80,0x49,0x94,0x42,0x15,0xb8,0x14,0xb4,0xa0,0xa0,0xe8,0x51,0x8f,0x22,0x47, + 0xb2,0x58,0x22,0x2c,0x77,0x9c,0x61,0xcc,0xaa,0xcc,0xad,0x57,0x6e,0xbd,0x72,0xeb, + 0x75,0x66,0x83,0xe4,0xed,0x39,0x8a,0x5,0x37,0x96,0x5c,0xa,0xac,0x56,0x52,0x0, + 0x26,0x84,0x5b,0xa5,0x69,0x34,0xfb,0xe8,0x69,0x8c,0xa9,0xa3,0x58,0x29,0x9c,0x85, + 0xc4,0x54,0xc2,0x87,0xb0,0x8,0x40,0x5b,0x8e,0xda,0x7a,0xd5,0xe9,0xe2,0x47,0x26, + 0xe3,0xeb,0x88,0xda,0x7a,0xb5,0xd2,0x85,0x5b,0xaf,0xb3,0x10,0xb2,0x31,0x53,0x58, + 0x71,0x3d,0x1,0x4b,0x6e,0x94,0x0,0xe4,0x98,0xbb,0x10,0xca,0x9,0x77,0x52,0x0, + 0x54,0x0,0x8e,0x23,0x7e,0xc3,0x43,0x9a,0x4e,0xe2,0xa0,0xf2,0x32,0x96,0x9,0xab, + 0xd0,0x40,0x1a,0x4b,0xc7,0x3,0x25,0x0,0xc6,0xaf,0xd5,0x91,0x58,0xaf,0x85,0xb, + 0x9,0x5f,0x26,0xeb,0x1,0x83,0x2f,0x2c,0xe0,0x0,0x20,0x4c,0x16,0x36,0x90,0xf4, + 0x1a,0x1a,0xe6,0xb4,0xae,0x44,0x29,0x9d,0x64,0xd9,0x20,0x60,0xdc,0x80,0x8d,0x28, + 0x4,0x74,0x5c,0x0,0x1a,0xab,0x33,0x3,0x91,0xc,0x19,0x47,0xd4,0x83,0x98,0x4b, + 0x9a,0xb1,0x58,0x58,0xa,0x11,0x85,0x9b,0xcf,0xad,0x57,0x6e,0xbd,0x7a,0x2d,0x73, + 0xcc,0x2c,0x8,0x23,0x92,0x61,0xd1,0x83,0x61,0x23,0x85,0xa,0x70,0xbc,0xf0,0x81, + 0x10,0x32,0xe0,0xa4,0xb2,0x1b,0xa6,0xd7,0x12,0x6e,0xe9,0x22,0x86,0xaa,0x97,0x70, + 0x8b,0x18,0xa1,0x43,0x98,0x54,0x26,0xb0,0x44,0x58,0x86,0x3a,0x32,0x7,0x40,0x34, + 0xd6,0xab,0xbe,0x1c,0xad,0xf5,0xaa,0x3d,0x1e,0xb5,0xf5,0xea,0x5a,0x17,0x1e,0x9a, + 0xc5,0xe1,0x10,0xd2,0x98,0x3e,0xc3,0x96,0xdd,0x4e,0xf,0x5a,0xb8,0x5a,0xf8,0xa0, + 0xaa,0xea,0x0,0xcb,0xcc,0xe6,0x94,0x52,0x63,0x1c,0x2e,0x0,0x32,0x2c,0x80,0xae, + 0x70,0xdc,0x4c,0x64,0xc8,0x23,0x87,0x6e,0xf5,0x55,0x34,0x91,0x16,0xcc,0x23,0xb, + 0x20,0x11,0x1b,0x6b,0xb7,0xa,0x13,0x6a,0x47,0x6d,0xbd,0x3a,0xd1,0x25,0x2c,0xeb, + 0x55,0x5f,0xe6,0xe4,0xca,0x61,0xe,0x61,0x44,0xd2,0x7d,0x76,0x6a,0xdd,0xba,0xe5, + 0x46,0x49,0x10,0x84,0x14,0xab,0x0,0x5f,0xed,0xc2,0x7,0x3,0x86,0xaa,0xd0,0x81, + 0x5b,0x1,0xc3,0x34,0x85,0x51,0x3a,0x8c,0x26,0xd2,0x82,0x56,0x32,0xf,0x2,0x11, + 0xb8,0xf5,0x1a,0xd2,0x40,0xc2,0xad,0x57,0x8e,0xb0,0x21,0x8c,0xea,0x9,0xd7,0x89, + 0x85,0xeb,0x81,0x1b,0xa9,0xa5,0x85,0xeb,0x67,0x66,0xce,0x94,0x70,0x47,0x66,0x16, + 0xe1,0x2,0x85,0xe4,0x37,0x29,0x3a,0x80,0x31,0x3a,0x8a,0x56,0x61,0x1e,0x1a,0xd0, + 0x18,0x1a,0xe9,0x58,0x95,0xb9,0xf5,0xca,0xad,0x57,0xe,0xf6,0x10,0x47,0x9d,0xbb, + 0x14,0x7c,0x70,0xe3,0xa8,0x44,0x8,0x19,0xf0,0xd3,0xa0,0xed,0xf6,0x3a,0x45,0xcc, + 0x30,0xb,0x57,0x8b,0x3c,0x72,0x38,0xad,0x9e,0xc0,0x20,0xfa,0xd0,0x44,0x5a,0xd0, + 0x40,0xf4,0x3b,0xcb,0xdb,0x11,0x4f,0xd4,0xd6,0xab,0xb6,0x1c,0xb5,0xf5,0xea,0x48, + 0x17,0x6e,0xbd,0x72,0x84,0x8c,0x72,0xb,0xd7,0xca,0xa5,0xe0,0x93,0x1b,0x7,0x24, + 0x0,0x3,0x36,0x95,0xdc,0x34,0x8,0x60,0x76,0xb8,0x14,0xcc,0x90,0x47,0x1e,0xfd, + 0xb4,0x17,0xc3,0x74,0x8,0xcd,0xa4,0x5,0x75,0xa4,0x1e,0xd3,0xb9,0x27,0xc3,0xb1, + 0x1e,0xc3,0xb2,0x5e,0xad,0x74,0x89,0xc6,0x7a,0x9d,0x96,0xcb,0xc9,0x95,0x83,0x35, + 0x48,0x46,0x0,0xc9,0xea,0xf9,0x29,0x88,0x55,0x66,0x0,0x6,0x25,0x42,0xc8,0x60, + 0x69,0xe2,0x87,0x51,0xcc,0x59,0x31,0x79,0xaf,0x6e,0xf7,0xde,0x13,0xd2,0xac,0x79, + 0xf4,0xf3,0xc8,0xa1,0x8f,0x9e,0x86,0x44,0x25,0xcc,0x21,0x8d,0x68,0x20,0x8d,0x10, + 0x20,0x70,0xeb,0xd5,0x89,0x2e,0xdc,0x7a,0xe5,0xa8,0x32,0x48,0xbd,0xd3,0xbb,0xdc, + 0x16,0xdf,0xce,0xcb,0x2d,0x5c,0x46,0xdc,0x38,0x20,0x9,0x82,0x30,0x20,0xcb,0xee, + 0xb6,0x43,0x76,0x22,0x5c,0x14,0xc5,0x12,0xe1,0x12,0x42,0x40,0x4f,0x4a,0x36,0x67, + 0xcc,0x3c,0xc8,0x90,0x4b,0x93,0x6b,0x75,0xa4,0x1e,0xf5,0xa4,0x1,0x71,0xc4,0x99, + 0x10,0x13,0x4f,0xa8,0xcd,0xc9,0x95,0x23,0x1c,0xc4,0x4e,0x17,0xb2,0xd3,0x6a,0x5d, + 0xa1,0xf9,0x7c,0x1e,0x80,0x3b,0xa2,0xb5,0xab,0x4f,0x8,0x19,0x94,0x46,0x47,0x47, + 0x4f,0xd7,0xd5,0xd5,0xf9,0x6e,0xac,0x1c,0xa2,0x28,0x22,0x9f,0xcf,0x97,0x2e,0x82, + 0x9c,0x98,0x7d,0x84,0x5b,0x84,0xa,0x15,0xe3,0x74,0xc,0xe3,0x74,0xc,0x31,0xc4, + 0x50,0x4b,0xea,0x51,0x4b,0xea,0x20,0x42,0x4,0xc0,0xde,0x3d,0x10,0xb5,0xf5,0x6a, + 0xa9,0xb,0xb7,0x5e,0x39,0x66,0x20,0xc4,0xd3,0x9,0xc3,0xbc,0x93,0x2c,0xcb,0xcc, + 0x57,0x99,0xa9,0xaa,0x7a,0x4a,0xea,0xea,0xea,0x1a,0xbf,0xfc,0xf2,0xcb,0xfb,0x0, + 0xcc,0xaf,0x54,0xd9,0x2d,0xd3,0x8b,0xa2,0xa8,0xbf,0x88,0x41,0x1,0x48,0x13,0xa0, + 0x76,0x76,0x77,0x9a,0x3c,0xf2,0xc8,0xd3,0x61,0x8c,0xd2,0x61,0xc4,0x91,0x40,0xd, + 0xa9,0x45,0xd,0x6a,0x40,0x88,0xc6,0x47,0xc4,0xad,0x57,0x57,0x72,0x38,0x38,0x82, + 0x44,0xac,0xd7,0xb8,0xff,0x42,0xd1,0xc2,0x75,0x2,0x17,0xdc,0x78,0xb8,0x68,0x76, + 0x76,0xa3,0x2,0xe1,0x7a,0x61,0x7a,0x49,0x32,0x5a,0xb4,0xe4,0xa4,0x4,0xba,0xc6, + 0xf9,0x85,0xcc,0x74,0xe4,0x90,0x45,0x8e,0x66,0x31,0xa,0x20,0x46,0xe3,0xa8,0x21, + 0x35,0x88,0x21,0xe,0xc9,0xe1,0xd2,0xe1,0xa8,0xad,0x57,0x9d,0x2e,0xdc,0x7a,0xe5, + 0x98,0xa5,0xd0,0xfa,0x70,0x81,0x82,0xff,0x36,0x88,0xed,0x75,0x0,0x74,0x17,0x59, + 0xf1,0x8,0x80,0x2b,0xfc,0x36,0x68,0x1b,0x8b,0xdb,0x23,0x2,0x67,0x10,0xe1,0x6a, + 0x91,0x47,0xe,0x79,0x5a,0x48,0x9b,0x26,0x42,0x44,0x8c,0xc4,0x11,0x47,0x1c,0x22, + 0x24,0x8,0x53,0x59,0x7d,0x58,0x10,0x6c,0xd4,0xd6,0xab,0xb6,0xcc,0xc9,0x95,0x63, + 0x26,0x40,0x3a,0xad,0x27,0x5c,0xa7,0xd6,0xad,0x5b,0x6e,0x54,0x55,0xf5,0x88,0xd6, + 0xc2,0xf5,0xdd,0xa0,0x16,0xa6,0x16,0xee,0xa9,0xd9,0x13,0xa9,0xe0,0x7,0xa,0x14, + 0x28,0x34,0x8d,0xc,0xd2,0x0,0xa,0x4,0x2c,0x21,0x6,0x89,0x48,0x8e,0x8,0x98, + 0x5b,0xaf,0x1c,0x1c,0xec,0x50,0x6e,0xe1,0x3a,0x9,0x22,0xf0,0xc0,0x8d,0x6a,0x53, + 0x53,0xd3,0x51,0x9,0x0,0x8,0x21,0xdd,0xba,0x4e,0xc7,0x60,0x66,0xce,0xcc,0xc2, + 0xa5,0x87,0x66,0xef,0xc4,0x99,0x1f,0x28,0x53,0x7f,0xd9,0xa9,0xdb,0x28,0x40,0x80, + 0x8,0xb1,0xf0,0x7f,0x22,0x42,0x98,0xfa,0x3,0xd8,0xb8,0x1b,0x78,0x42,0x6d,0xe, + 0x8e,0x2,0xc4,0x54,0x1c,0xc2,0x84,0x9e,0x97,0x2a,0x11,0xae,0xf,0x6e,0x3c,0x7d, + 0xe8,0xd0,0xa1,0xac,0x34,0x75,0xb0,0xdb,0x4b,0x83,0x76,0xb1,0xb8,0xa2,0x28,0x96, + 0xe2,0xd9,0x8,0x21,0x10,0xe,0xc6,0xe1,0x3c,0xe1,0xd9,0x99,0xb,0x75,0xea,0xf, + 0xc8,0x97,0x78,0x8f,0x80,0x68,0x88,0x77,0xaa,0x3c,0x35,0x11,0x67,0xbb,0x63,0x5, + 0xdf,0xe,0x86,0x83,0xc3,0x14,0xf1,0x23,0xfa,0x8,0x2d,0x42,0x88,0xa5,0x4b,0xc1, + 0x27,0x37,0x1e,0x1,0xa,0x9,0xc8,0x41,0x29,0x3d,0x42,0x8,0x61,0x9f,0x6c,0x57, + 0x92,0xa0,0x28,0xca,0x74,0xb4,0xc2,0x81,0x58,0xa1,0x6f,0x57,0xd7,0x8e,0x3b,0x33, + 0x2,0x14,0xb4,0x64,0x9,0x6b,0xe,0x96,0x20,0x40,0x28,0x11,0x2f,0x99,0xfa,0x9b, + 0x6,0x81,0xfe,0xc6,0x73,0xeb,0x95,0x83,0x3,0xd0,0x13,0x6e,0x91,0xa7,0x72,0x39, + 0xe3,0x16,0x35,0xc,0xb8,0xb1,0x1b,0x98,0x22,0xdc,0x58,0x2c,0x76,0x2c,0x9f,0xcf, + 0x3b,0xa6,0x42,0xc7,0xc9,0x76,0x25,0x49,0xa7,0x3c,0x19,0x17,0x80,0xd3,0x22,0xb0, + 0x88,0xdb,0xb9,0xac,0x51,0xb0,0x88,0xdd,0x83,0x80,0x80,0x82,0x9a,0x5a,0xc9,0x1c, + 0x1c,0xb3,0x1d,0xb1,0xee,0x2,0xe1,0x16,0xc9,0x96,0x52,0x6a,0xb0,0x70,0x59,0x18, + 0xa2,0x45,0x2f,0x82,0x0,0x0,0xcf,0x3c,0xf3,0x4c,0x1a,0xc0,0x61,0x3f,0xd,0x9a, + 0xc1,0x6c,0xe2,0x4c,0x38,0x10,0x77,0x7c,0x3e,0x47,0xf0,0xd0,0x5a,0xb2,0x9c,0x6c, + 0x39,0xce,0x34,0xc4,0x8f,0xd4,0x19,0x56,0x98,0x69,0x53,0x1d,0xb0,0x7a,0xeb,0x17, + 0x4,0xa1,0xb,0xd0,0xec,0x32,0x46,0x29,0xdd,0xed,0xa7,0x41,0xb3,0xba,0x66,0x84, + 0x8b,0x3,0x31,0xe3,0x31,0xe,0xe,0xe,0x8e,0x90,0x41,0x64,0x82,0x78,0x8f,0xde, + 0x87,0x5b,0x7c,0x23,0x77,0xcb,0x75,0xe,0xea,0xef,0x1,0x34,0x84,0x4b,0x8,0xb1, + 0x24,0x5c,0xaf,0x4c,0x6f,0x58,0x6d,0x6,0x80,0x1c,0xe4,0x84,0xcb,0xc1,0xc1,0x11, + 0x3d,0x62,0x27,0x6b,0x41,0xf2,0xfa,0x68,0xaa,0x6c,0x36,0xcb,0x7c,0x2e,0xb,0x40, + 0xae,0xb7,0xb7,0x77,0x3f,0xa0,0xdf,0x47,0x77,0x8f,0x8f,0x6,0x4b,0x75,0x6d,0xe3, + 0x71,0x5f,0xe1,0x84,0xcb,0xc1,0xc1,0x11,0x3d,0xe2,0xaf,0xd6,0x1b,0x8e,0x99,0x4d, + 0x98,0x59,0xc1,0x5,0x37,0xee,0x3,0x90,0x7,0x34,0x84,0x2b,0x8,0x82,0x81,0x70, + 0x59,0x30,0x7d,0x39,0xe1,0xa,0x47,0xe3,0x20,0x29,0xd1,0x71,0xbb,0x1c,0x1c,0x1c, + 0x1c,0x41,0xa0,0xa6,0xab,0xd1,0x70,0x2c,0x9b,0xcd,0x3a,0x3a,0xd7,0xd,0x37,0xaa, + 0xaa,0x5a,0xf2,0x1e,0x94,0x8,0xf7,0xf9,0xe7,0x9f,0x3f,0x4,0x60,0xc2,0x4b,0x83, + 0x95,0xea,0xc6,0x62,0x5,0x8b,0x96,0x10,0x52,0x70,0x2f,0x50,0x0,0xbb,0xf8,0xc4, + 0x19,0x7,0x7,0x47,0xb4,0x48,0x74,0x35,0xe8,0x3e,0xe7,0xf3,0x79,0x47,0x9b,0x47, + 0x7a,0xd8,0x54,0xb7,0x64,0xcc,0x6a,0x5d,0xa,0x2a,0x80,0x2e,0x96,0x33,0x73,0x40, + 0xc1,0xc2,0x35,0xf8,0x71,0x77,0x26,0x2c,0x6a,0x73,0x70,0x70,0x70,0x4,0xf,0x61, + 0x4c,0x42,0xfc,0x98,0x7e,0xc2,0x2c,0x93,0xc9,0x54,0x3c,0xc7,0x2b,0x37,0x52,0x4a, + 0x4d,0x9,0x57,0xf7,0x85,0x93,0xc6,0x9c,0x26,0x22,0x17,0x45,0xbd,0xb,0x41,0xd8, + 0xc5,0x9,0x97,0x83,0x83,0x23,0x3a,0xd4,0xec,0x6f,0xd0,0x2d,0x1c,0x22,0x84,0x20, + 0x9d,0x4e,0x5b,0xd6,0xf7,0x33,0x97,0xa5,0x8d,0x0,0x2b,0x4f,0x78,0x60,0x1b,0x1a, + 0xe6,0x56,0x38,0x60,0xf4,0xe3,0x92,0xae,0x38,0x90,0xe5,0xcb,0xcd,0x38,0x38,0x38, + 0xa2,0x41,0xe2,0xe5,0x69,0x77,0x42,0xf1,0xd,0xdc,0xca,0x7f,0xeb,0x77,0xe3,0xc8, + 0x81,0x81,0x81,0x93,0xc5,0xf,0x3a,0xc2,0x25,0x84,0x3c,0xe9,0xa1,0xc1,0x8a,0x75, + 0x4d,0xe3,0x71,0x73,0x4,0x64,0x1f,0xf7,0xe3,0x72,0x70,0x70,0x44,0x83,0x44,0x57, + 0xc3,0xf4,0xbc,0x12,0xa,0x39,0x70,0x3,0x5a,0xd2,0xab,0xe3,0x54,0x1d,0xe1,0xae, + 0x5a,0xb5,0x6a,0x37,0x80,0x31,0x97,0xd,0xda,0xd6,0x35,0x4d,0xd5,0xc8,0xfd,0xb8, + 0x1c,0x1c,0x1c,0x11,0x80,0xe4,0x5,0xd4,0x1c,0xd4,0x4f,0x98,0x95,0xbb,0x13,0x58, + 0xcd,0x65,0x51,0x4a,0x9f,0xd6,0x7e,0xd6,0x11,0xee,0x83,0xf,0x3e,0xa8,0x50,0x4a, + 0x9f,0x73,0xd3,0xa0,0x93,0xba,0xe5,0x3e,0x5c,0x42,0x8,0x84,0x27,0x6b,0x1d,0xb7, + 0xc7,0xc1,0xc1,0xc1,0xc1,0xa,0x35,0x7b,0x1b,0x21,0x64,0xf5,0x9c,0xa4,0x75,0x27, + 0xb0,0xdc,0x38,0x52,0x14,0x45,0x6b,0xc2,0x5,0x0,0x41,0x10,0x74,0x15,0x58,0x30, + 0x3d,0x21,0x4,0xf1,0x78,0xbc,0x54,0x6,0x0,0x61,0x57,0xd,0x30,0x66,0xb2,0x2b, + 0x4,0x7,0x7,0x7,0x47,0x80,0xa8,0xdb,0xd1,0x6c,0x38,0x36,0x31,0x51,0x88,0x88, + 0x65,0xbc,0xa4,0x77,0xb2,0xb7,0xb7,0xb7,0x53,0x7b,0xc0,0xc0,0x78,0x84,0x90,0xa7, + 0xb4,0xd,0xb2,0x12,0x1e,0x8f,0xc7,0xf5,0xe1,0x61,0x32,0x20,0x3c,0x67,0xdc,0xbc, + 0x8d,0x83,0x83,0x83,0x23,0x48,0x94,0x13,0xae,0x2c,0xcb,0xc8,0xe5,0x72,0x41,0x2c, + 0xe9,0xdd,0x81,0xa9,0x15,0x66,0x45,0x18,0x8,0x77,0x72,0x72,0xf2,0x59,0x0,0x32, + 0x6b,0xe1,0xc5,0x5,0x10,0x3a,0xe1,0x4f,0x71,0xb7,0x2,0x7,0x7,0x47,0x78,0x88, + 0x9d,0xaa,0x41,0xac,0x47,0xcf,0x3b,0x13,0x13,0x13,0x41,0x90,0x2d,0x0,0x3c,0x55, + 0x7e,0xc0,0x40,0xb8,0x5d,0x5d,0x5d,0xe3,0x6e,0xe3,0x71,0x9d,0x40,0x10,0x4,0xa3, + 0x2f,0xf7,0xa9,0x5a,0xf0,0x8c,0x80,0x1c,0x1c,0x1c,0x61,0xa1,0xee,0x45,0xa3,0x3b, + 0x61,0x72,0x72,0xd2,0xf1,0xf9,0x2e,0xfd,0xbb,0x4f,0x97,0x1f,0xb0,0x72,0xa2,0xfe, + 0x2f,0x6b,0xe1,0x94,0x52,0x83,0x95,0x4b,0xfa,0x45,0x90,0x83,0x3c,0x3c,0x8c,0x83, + 0x83,0x23,0x1c,0xd4,0xec,0x68,0x32,0x1c,0x73,0x42,0xb8,0x1e,0xe6,0xb2,0xd4,0x6c, + 0x36,0xfb,0x6c,0xf9,0x71,0x2b,0xc2,0xfd,0x9d,0x13,0x5,0x5c,0x8,0x7,0x60,0x91, + 0x90,0x9c,0xbb,0x15,0x38,0x38,0x38,0x42,0x0,0xc9,0x9,0xa8,0xdd,0x3d,0x77,0xfa, + 0x33,0x21,0xc8,0x64,0x32,0x50,0xd5,0xca,0xbb,0xa5,0x78,0x9c,0xcb,0xda,0x31,0x3a, + 0x3a,0x9a,0x2a,0xff,0xde,0x94,0x70,0x65,0x59,0xfe,0x23,0x0,0xd3,0x65,0x17,0x7e, + 0xa2,0x16,0xb4,0x79,0x15,0x8a,0x41,0xc7,0xe2,0x23,0xc6,0x14,0x69,0x1c,0x1c,0x1c, + 0x1c,0xac,0x51,0xff,0x7c,0xb,0x84,0x4c,0xc1,0xad,0x59,0xe4,0xa1,0x62,0x74,0x82, + 0x15,0x7c,0xf8,0x76,0x7f,0x6b,0x56,0xc7,0x94,0x70,0x77,0xef,0xde,0x3d,0x1,0x13, + 0x87,0xaf,0xdf,0xa8,0x5,0x42,0x8,0x62,0xb1,0x98,0x2e,0x5a,0x81,0x1c,0x88,0x83, + 0x1c,0xe6,0x39,0x72,0x39,0x38,0x38,0x82,0x45,0xdd,0x93,0xad,0x0,0xa0,0xe3,0x9f, + 0xb1,0x31,0xcb,0x75,0x5e,0xbe,0x26,0xd2,0x54,0x55,0x7d,0xc4,0xac,0x9e,0x65,0x20, + 0x2c,0x21,0x44,0xc7,0xd0,0xac,0x66,0xf1,0x8a,0xf1,0xb8,0x5a,0x88,0xbf,0xe7,0x56, + 0x2e,0x7,0x7,0x47,0x70,0x10,0x32,0x22,0xea,0x5f,0x68,0xd1,0x91,0x6d,0x26,0x93, + 0x9,0x64,0x4b,0x74,0x42,0xc8,0x60,0x2a,0x95,0x7a,0xc1,0x54,0xf,0xab,0x46,0x64, + 0x59,0x2e,0x31,0x34,0xcb,0x90,0x89,0x72,0xb,0x17,0x0,0xc8,0xa3,0x75,0x16,0xb5, + 0x39,0x38,0x38,0x38,0xfc,0xa3,0xee,0xf9,0x16,0x8,0x39,0x7d,0x94,0xd4,0xf8,0xf8, + 0xb8,0xa1,0x1e,0x8b,0x85,0x5e,0x94,0xd2,0x47,0x1,0x98,0x26,0xd6,0xb5,0x24,0xdc, + 0x5d,0xbb,0x76,0x75,0x51,0x4a,0x8f,0x6,0x11,0x9f,0x56,0x1e,0xad,0x20,0x1c,0x8a, + 0x83,0xbc,0xca,0xdd,0xa,0x1c,0x1c,0x1c,0xc1,0x60,0xce,0x53,0x6d,0x86,0x63,0xa3, + 0xa3,0xa3,0xba,0xcf,0xac,0x16,0x7a,0x51,0x4a,0x4d,0xdd,0x9,0x40,0x5,0xc2,0x9d, + 0x3a,0xd1,0x36,0x5a,0xc1,0x4e,0xb8,0x19,0xcc,0xa2,0x15,0xc4,0xc7,0xb8,0x5b,0x81, + 0x83,0x83,0x83,0x3d,0x84,0x49,0xd1,0xb0,0xba,0x2c,0x93,0xc9,0x40,0x96,0xe5,0xd2, + 0x67,0x86,0x86,0xa5,0x1a,0x8b,0xc5,0x4c,0x27,0xcc,0x0,0x1b,0xc2,0x85,0xc5,0x4c, + 0x9b,0xb,0xe1,0x86,0xba,0xc5,0x78,0x5c,0x41,0x98,0x16,0x4d,0x8,0x81,0xf8,0xfb, + 0x39,0x8e,0xdb,0xe1,0xe0,0xe0,0xe0,0x70,0x8a,0xba,0xe7,0x5a,0x40,0x72,0x7a,0xaa, + 0xd3,0x5a,0xb7,0x8c,0xdf,0xe2,0x77,0x9e,0x3e,0x7d,0xba,0xdf,0xea,0xcb,0x8a,0x84, + 0x9b,0x4e,0xa7,0xff,0x0,0xc0,0x32,0xd,0xba,0x1f,0x45,0x8b,0x56,0x6e,0x29,0x4c, + 0xec,0xd5,0x18,0x84,0x17,0x79,0x6e,0x5,0xe,0xe,0xe,0xb6,0x98,0xfb,0xdb,0x45, + 0x86,0x63,0xc5,0xe5,0xbc,0x1,0xb8,0x4c,0x7f,0x53,0xe9,0xcb,0x8a,0x84,0xbb,0x7f, + 0xff,0xfe,0x31,0x42,0x88,0x69,0x3,0x7e,0x15,0x35,0x24,0xb3,0x1,0x20,0xfe,0x57, + 0x83,0xa1,0x1e,0x7,0x7,0x7,0x87,0x57,0xc4,0x8f,0xd5,0xa1,0xe6,0x65,0xfd,0xee, + 0xbc,0x13,0x13,0x13,0xae,0xb7,0x43,0x77,0xc1,0x77,0xf7,0x56,0xfa,0xd2,0x36,0x3f, + 0xa2,0xaa,0xaa,0xf,0x9a,0x29,0xe0,0x14,0x56,0x75,0xcd,0xf6,0x3a,0x13,0x7f,0x5f, + 0xf,0x8c,0xf0,0x94,0x8d,0x1c,0x1c,0x1c,0x6c,0xd0,0xf0,0xe8,0x2,0xc3,0xb1,0x91, + 0x91,0x11,0xc7,0xe7,0xbb,0xcc,0x9d,0xb0,0x6b,0x60,0x60,0xe0,0x40,0xa5,0xa,0xb6, + 0xec,0x26,0x8a,0xe2,0x43,0x0,0xc6,0x8b,0xc2,0x59,0x87,0x88,0xe9,0x90,0x25,0x10, + 0x1f,0xe2,0xbe,0x5c,0xe,0xe,0xe,0xff,0x20,0x79,0x1,0x8d,0x7f,0xd4,0x13,0xae, + 0xaa,0xaa,0xa6,0xe1,0x60,0x66,0xf0,0x30,0x3f,0x65,0x30,0x4e,0xcb,0x61,0x4b,0xb8, + 0x9d,0x9d,0x9d,0x93,0x0,0x1e,0x62,0x9c,0x98,0x17,0x80,0x45,0xb4,0x2,0x77,0x2b, + 0x70,0x70,0x70,0x30,0x40,0xdd,0x33,0x2d,0x10,0x46,0xa7,0xe7,0x8a,0x8,0x21,0x18, + 0x19,0x19,0x71,0xc4,0x4d,0x5e,0xc,0x4b,0x51,0x14,0xef,0xb7,0xab,0xeb,0xe8,0xfd, + 0x5d,0x55,0xd5,0x7,0xdc,0xa,0x77,0x82,0xe2,0x52,0x5f,0x2d,0xc4,0xc3,0x9,0x8, + 0xbb,0xf9,0xe4,0x19,0x7,0x7,0x87,0x3f,0xcc,0x7d,0x74,0x21,0x0,0xfd,0x52,0xde, + 0xe1,0xe1,0x61,0xdb,0xf3,0x3c,0xbe,0xc5,0xef,0xec,0xeb,0xeb,0x7b,0xd5,0xae,0xbe, + 0x23,0xc2,0x6d,0x6e,0x6e,0x7e,0x18,0xc0,0xa8,0x5d,0x3d,0x3f,0x19,0xc4,0xb4,0x3b, + 0x68,0x8a,0xf,0x72,0x2b,0x97,0x83,0x83,0xc3,0x3b,0x62,0x27,0x6a,0x51,0xbb,0xbb, + 0x49,0x47,0xb6,0xe9,0x74,0xba,0xe2,0x64,0x99,0x4f,0x97,0xa9,0x23,0xa3,0xd4,0x11, + 0xe1,0x6e,0xdf,0xbe,0x3d,0x3,0x9b,0x70,0x7,0xaf,0x8a,0x8a,0xa2,0xa8,0x8b,0xc9, + 0x5,0x0,0xf1,0x91,0x39,0x20,0xa7,0x8d,0xee,0x6,0xe,0xe,0xe,0xe,0x27,0x68, + 0xfe,0xaf,0xa5,0x20,0x54,0x1f,0x5,0x55,0xc9,0xba,0xf5,0xe9,0x32,0xa5,0xb2,0x2c, + 0xff,0xdc,0xc9,0xb9,0x8e,0x43,0x2,0x54,0x55,0x35,0xf5,0x4f,0xf8,0x9d,0x48,0x33, + 0x73,0x2b,0x10,0x85,0x40,0xba,0x7f,0x2e,0x38,0x38,0x38,0x38,0xdc,0x42,0x1a,0x8a, + 0xa3,0xe1,0xf1,0xf9,0xba,0x63,0xb2,0x2c,0x1b,0x96,0xf2,0x16,0xc1,0x20,0x10,0xe0, + 0x85,0x91,0x91,0x91,0x23,0x4e,0xce,0x77,0x4c,0xb8,0xbb,0x77,0xef,0x7e,0x8,0xc0, + 0x51,0x7,0xc2,0x2d,0x61,0x55,0xdf,0x34,0x26,0xf7,0x17,0xd,0x20,0xe3,0x3c,0x44, + 0x8c,0x83,0x83,0xc3,0x1d,0x1a,0x1f,0x5e,0x4,0x92,0xd7,0x73,0xc7,0xd0,0xd0,0x90, + 0x55,0xa2,0x19,0xc7,0xed,0x56,0xc8,0x9d,0xf0,0x5d,0xa7,0x6d,0xb8,0x61,0x34,0x15, + 0xc0,0x3d,0x76,0xc2,0x2d,0x14,0xb2,0xad,0x5f,0x1e,0xb1,0x40,0x26,0x4,0x48,0xbf, + 0x6a,0xb4,0xa8,0xcd,0xc1,0xc1,0xc1,0x61,0x84,0x90,0x15,0xd1,0xf4,0xd0,0x62,0xdd, + 0x31,0x55,0x55,0xd,0xee,0x4,0x86,0x21,0xae,0xa3,0xb1,0x58,0xcc,0x91,0x3b,0x1, + 0x70,0x47,0xb8,0x50,0x55,0xf5,0x6e,0x0,0x4a,0x18,0x19,0xc4,0x8,0x21,0x90,0xee, + 0x9d,0xb,0xa2,0x10,0x8b,0x33,0x38,0x38,0x38,0x38,0xf4,0x68,0xf8,0xc3,0x7c,0x8, + 0x63,0x7a,0xe3,0x6d,0x64,0x64,0x4,0x8a,0x32,0x9d,0x2d,0x91,0xa5,0xb1,0x48,0x29, + 0xbd,0xaf,0xb7,0xb7,0xb7,0xf2,0xb6,0x11,0x1a,0xb8,0x22,0xdc,0xdd,0xbb,0x77,0xf7, + 0x50,0x4a,0x1f,0x73,0x5a,0xdf,0x6d,0x88,0x98,0x21,0xbf,0xc2,0x29,0x9,0xe2,0xe3, + 0x3c,0x8b,0x18,0x7,0x7,0x87,0x3,0xa8,0xc0,0xdc,0x5f,0xeb,0xad,0x5b,0x4a,0x29, + 0x52,0xa9,0x94,0xee,0xb3,0x53,0x38,0xa9,0x2b,0x8,0xc2,0xdd,0xce,0x15,0x74,0x49, + 0xb8,0x53,0xf8,0x9e,0x93,0x4a,0x5e,0x2e,0xcc,0x2c,0x39,0x79,0xec,0xdb,0x2d,0xdc, + 0xca,0xe5,0xe0,0xe0,0xb0,0x45,0xc3,0xf6,0xf9,0x88,0xf7,0xe8,0x37,0x33,0x18,0x1b, + 0x1b,0x2b,0xed,0xea,0x10,0xc0,0x9b,0xf9,0xce,0x81,0x81,0x81,0x1d,0x2e,0x54,0x74, + 0x4f,0xb8,0xcd,0xcd,0xcd,0xbf,0x2,0x70,0xca,0xea,0x7b,0x3f,0xbe,0x11,0x41,0x10, + 0xc,0xf9,0x15,0xc8,0xd1,0x18,0xc4,0x47,0xf8,0x72,0x5f,0xe,0xe,0x8e,0xa,0xc8, + 0x13,0xb4,0xfc,0x6c,0x85,0xe1,0xf0,0xd0,0xd0,0x10,0x80,0x40,0xc8,0x16,0x0,0xbe, + 0xef,0xb8,0xd1,0x29,0xb8,0x26,0xdc,0xed,0xdb,0xb7,0xcb,0x0,0x7e,0x6c,0xf6,0x1d, + 0xb,0xdf,0x88,0x21,0xbf,0x2,0x0,0xe9,0xae,0x66,0x10,0x99,0x5b,0xb9,0x1c,0x1c, + 0x1c,0xe6,0x68,0xfc,0xe3,0x2,0xc4,0xfa,0xa6,0x57,0xa8,0x12,0x42,0x30,0x31,0x31, + 0x81,0xc9,0xc9,0xc9,0xa0,0xc8,0x76,0x52,0x55,0xd5,0x9f,0xba,0xd3,0xd2,0x9b,0x4b, + 0x1,0x8a,0xa2,0x7c,0xf,0x65,0x7b,0xf6,0xb0,0xba,0x28,0x33,0x2b,0x57,0xe8,0x89, + 0x41,0x7c,0x88,0xaf,0x3e,0xe3,0xe0,0xe0,0x30,0x82,0xe4,0x5,0xb4,0xfc,0x7c,0xf9, + 0xf4,0xe7,0x29,0xb7,0x64,0x6f,0x6f,0xaf,0xe3,0x36,0x3c,0xbc,0x99,0xff,0x7c,0x68, + 0x68,0xc8,0x79,0xda,0xb1,0x29,0x78,0x22,0xdc,0xbd,0x7b,0xf7,0xbe,0xa,0xe0,0x3f, + 0x35,0xc2,0x1d,0x9f,0xeb,0xa4,0xae,0x59,0xc4,0x42,0xfc,0x7b,0x2d,0x40,0x8e,0x5b, + 0xb9,0x1c,0x1c,0x1c,0x7a,0xcc,0x7d,0x74,0x21,0xa4,0xfe,0x4,0x80,0x69,0xb2,0x1d, + 0x1b,0x1b,0x43,0x36,0x9b,0x75,0x74,0xbe,0x87,0x37,0x73,0x55,0x10,0x84,0x7f,0x75, + 0xaf,0xa9,0x47,0xc2,0x5,0x0,0x41,0x10,0xbe,0x5c,0x54,0xc0,0x29,0x9c,0xd6,0x15, + 0x4,0x1,0x82,0x20,0xe8,0xf2,0x2b,0x90,0xd3,0x12,0x62,0xff,0xc3,0xe3,0x72,0x39, + 0x38,0x38,0xa6,0x41,0xb2,0x2,0x9a,0x1e,0x58,0x56,0x28,0x6b,0x26,0xdc,0xfb,0xfa, + 0xfa,0x1c,0x9d,0xef,0x85,0xbf,0x28,0xa5,0xbf,0x19,0x18,0x18,0xd8,0xef,0x42,0xcd, + 0x12,0x3c,0x13,0xee,0xce,0x9d,0x3b,0x77,0xa8,0xaa,0xba,0xdd,0x69,0x7d,0xb7,0x17, + 0x16,0x8f,0xc7,0xd,0xc7,0x63,0x3f,0x68,0x6,0xc9,0xf0,0xd5,0x67,0x1c,0x1c,0x1c, + 0x5,0x34,0x3d,0xb4,0x18,0xb1,0xa1,0x84,0x8e,0x6c,0x47,0x46,0x46,0x1c,0x59,0xb7, + 0x3e,0x8c,0xc5,0x7f,0x73,0xa1,0xa2,0xe,0xbe,0xd8,0x4b,0x10,0x84,0xaf,0xd8,0xd5, + 0xf1,0x1a,0xb5,0x40,0x8,0x31,0x46,0x2c,0xf4,0x4b,0x88,0x7d,0xaf,0xd9,0xec,0x34, + 0xe,0xe,0x8e,0x33,0xc,0x62,0x2a,0x8e,0x96,0xfb,0xf5,0x91,0x9,0x94,0x52,0xf4, + 0xf7,0x5b,0xee,0xe1,0x58,0xaa,0xe3,0x83,0x6c,0x9f,0x19,0x1a,0x1a,0x7a,0xca,0x85, + 0x9a,0x3a,0xf8,0x22,0xdc,0x5d,0xbb,0x76,0x3d,0x4,0xa0,0xcb,0xea,0x7b,0xbf,0x51, + 0xb,0x66,0x9,0xca,0x63,0xf7,0x36,0x81,0x1c,0x33,0x46,0x32,0x70,0x70,0x70,0x9c, + 0x59,0x68,0xfb,0xd1,0x2a,0x8,0x19,0xbd,0x51,0x36,0x32,0x32,0x62,0x9b,0x82,0xd1, + 0xd,0x4c,0xea,0xdb,0x1a,0x99,0x95,0xe0,0xf7,0xfd,0x9c,0x2,0xf8,0x9a,0xe9,0x17, + 0xc,0x7c,0xbb,0xda,0xd5,0x67,0x25,0xe4,0x9,0x12,0xdf,0x68,0x73,0xdc,0x36,0x7, + 0x7,0xc7,0xec,0x43,0xcd,0xfe,0x6,0x34,0x6e,0xd7,0x6f,0x9f,0xa3,0x28,0x4a,0xc5, + 0xc8,0x4,0x6,0x61,0xab,0x7,0x53,0xa9,0xd4,0x7f,0xbb,0x50,0xd3,0x0,0xdf,0xe, + 0xd1,0xfa,0xfa,0xfa,0x7b,0x1,0xe8,0x3c,0xd4,0x2c,0x27,0xd2,0x24,0x49,0x9a,0x9e, + 0x38,0x9b,0x9a,0x44,0x93,0xfe,0x34,0x7,0xe2,0xb3,0x75,0x15,0xcf,0xe3,0xe0,0xe0, + 0x98,0xa5,0xa0,0x40,0xdb,0xdd,0x6b,0xa,0xe6,0x9e,0x6,0x83,0x83,0x83,0xba,0x9c, + 0x9,0xba,0x53,0xd8,0x18,0x80,0xdf,0x44,0x21,0x89,0x97,0x67,0xf8,0x26,0xdc,0x67, + 0x9e,0x79,0x26,0xd,0xe0,0x8b,0x0,0xfb,0x4d,0x26,0x8b,0xd0,0x92,0x6e,0x11,0x89, + 0xaf,0xcd,0xe3,0x4b,0x7e,0x39,0x38,0xce,0x40,0x34,0x6e,0x5f,0x80,0xda,0xfd,0xfa, + 0x88,0xa5,0x5c,0x2e,0x87,0xc1,0xc1,0x41,0xd3,0xfa,0x8c,0x38,0xe9,0xf8,0xe0,0xe0, + 0xe0,0x5d,0x8e,0x1b,0xb2,0x0,0x93,0x29,0xff,0xd1,0xd1,0xd1,0xef,0x52,0x4a,0x7b, + 0x9c,0xd6,0x77,0x4b,0xcc,0xda,0xf0,0xb0,0x22,0x84,0xc3,0x71,0xc4,0xfe,0x8b,0x27, + 0x29,0xe7,0xe0,0x38,0x93,0x20,0xa4,0x45,0xb4,0xfe,0x64,0xa5,0xe1,0x78,0x5f,0x5f, + 0x9f,0x81,0x53,0x58,0x1a,0x80,0x94,0xd2,0x2f,0x0,0x70,0x16,0xd8,0x5b,0x1,0x4c, + 0x8,0xb7,0xbb,0xbb,0x3b,0x43,0x8,0xf9,0xa2,0x93,0xba,0x5e,0x9c,0xd6,0xa6,0xbe, + 0x5c,0x0,0xf1,0x6f,0xb4,0x41,0xe8,0xe1,0x13,0x68,0x1c,0x1c,0x67,0xa,0xda,0xbe, + 0xbf,0x1a,0xd2,0x40,0x42,0x77,0x6c,0x7c,0x7c,0xdc,0xb0,0x9b,0x3,0xe3,0x7c,0xdd, + 0x87,0x87,0x86,0x86,0x7e,0xe0,0x42,0x4d,0x4b,0x30,0xb,0x6a,0x8d,0xc5,0x62,0x77, + 0x3,0xa8,0xb8,0xcd,0x84,0x9f,0x9b,0x60,0x66,0xe5,0x22,0x43,0x10,0xff,0xc2,0x7c, + 0x83,0x2f,0x87,0x83,0x83,0x63,0xf6,0xa1,0x6e,0x57,0x33,0xe6,0x3e,0xb6,0xc8,0x70, + 0xbc,0x3c,0xc,0x2c,0x0,0xb7,0xe6,0x17,0x0,0xe4,0x1d,0x37,0x5a,0x1,0xa2,0x7d, + 0x15,0x67,0x38,0x75,0xea,0x94,0xba,0x70,0xe1,0xc2,0x9,0x0,0xb7,0x98,0x7d,0xcf, + 0xe2,0x26,0x8,0x82,0x0,0x55,0x9d,0xf6,0x59,0x13,0x42,0x20,0x9e,0x8a,0x83,0x2e, + 0xc9,0x43,0x3d,0xc7,0xb7,0xb5,0xcf,0xc1,0xc1,0x51,0xa5,0x20,0x39,0x1,0x4b,0xfe, + 0x79,0x3d,0xc4,0x31,0xfd,0x1b,0xed,0xe0,0xe0,0xa0,0x6e,0x37,0x87,0x0,0xc8,0x76, + 0x7f,0x2a,0x95,0x7a,0x37,0x18,0x99,0x75,0x4c,0x97,0x6d,0xc5,0x62,0xb1,0x1f,0x1, + 0x30,0xec,0xcd,0xce,0xea,0x26,0x98,0x25,0x29,0x7,0xa6,0x26,0xd0,0x6,0x99,0x8d, + 0x1d,0x1c,0x1c,0x1c,0x55,0x86,0xd6,0xfb,0x56,0x20,0x76,0xb2,0x56,0x77,0x2c,0x9f, + 0xcf,0x97,0x96,0xf0,0x6,0x35,0x61,0x4f,0x29,0xfd,0x3c,0xca,0x12,0x75,0xf9,0x1, + 0x53,0xc2,0xed,0xec,0xec,0xcc,0x13,0x42,0x3e,0x57,0xfc,0x1c,0xc4,0x4d,0x28,0xe6, + 0x59,0xd0,0x82,0x8c,0x8a,0x48,0x7c,0x65,0xbe,0xc5,0x19,0x1c,0x1c,0x1c,0x33,0x19, + 0x89,0x43,0x73,0xd0,0xf4,0xcb,0xa5,0xba,0x63,0x84,0x10,0x9c,0x3c,0x79,0xd2,0x35, + 0xc7,0x0,0xae,0xc,0xc0,0x7d,0x43,0x43,0x43,0xf7,0xb9,0x6a,0xdc,0x6,0xcc,0x13, + 0x13,0xb4,0xb4,0xb4,0xdc,0xb,0xe0,0x15,0xd6,0x9b,0x4c,0x6a,0x51,0xbe,0xe4,0x17, + 0x0,0x62,0xbf,0x6f,0x80,0xf8,0x24,0xdf,0x8e,0x87,0x83,0x63,0x36,0x81,0xc8,0x4, + 0xf3,0xbf,0x7d,0x76,0x29,0x4,0xb4,0x38,0x97,0x33,0x3c,0x3c,0x8c,0x89,0x89,0x9, + 0xe6,0x9b,0xd9,0x96,0xe1,0xb3,0x60,0x68,0xdd,0x2,0x1,0x10,0xee,0xf6,0xed,0xdb, + 0x65,0x55,0x55,0xdf,0xef,0xb4,0xbe,0xd7,0x1b,0x56,0x6e,0xe5,0x2,0x40,0xed,0x1d, + 0xb,0x41,0x7a,0x8d,0xd1,0xc,0x1c,0x1c,0x1c,0x33,0x13,0xad,0x3f,0x59,0x85,0x9a, + 0x43,0x85,0x5c,0xd8,0x45,0x37,0xa2,0x2c,0xcb,0x38,0x7d,0xfa,0x74,0x50,0x89,0xc5, + 0x41,0x29,0x85,0xaa,0xaa,0x8f,0xa5,0x52,0x29,0xc7,0xbb,0xf1,0x3a,0x45,0x20,0xa9, + 0xb7,0xba,0xba,0xba,0xfe,0x48,0x29,0xfd,0x1f,0xbb,0x7a,0x7e,0x6e,0x58,0x31,0x7d, + 0xa3,0xee,0xd8,0xb8,0x84,0xda,0xcf,0x2f,0xe4,0x51,0xb,0x1c,0x1c,0xb3,0x0,0xb5, + 0xbb,0x9a,0xd0,0xfc,0x3f,0x5,0x57,0x82,0xb6,0xaf,0xf7,0xf6,0xf6,0x42,0x96,0x65, + 0xc7,0xed,0x78,0xe0,0x19,0x59,0x10,0x84,0xf,0x3b,0x3e,0xc9,0x5,0x2,0xcb,0x75, + 0x28,0x8,0xc2,0x47,0x50,0x21,0x50,0x98,0xc5,0xe8,0xa4,0x75,0x2d,0x14,0x7f,0x10, + 0xe9,0xf9,0x7a,0xc4,0x7f,0xce,0x33,0x8a,0x71,0x70,0xcc,0x64,0x88,0x63,0x31,0x2c, + 0xfc,0xda,0xb9,0x20,0x94,0x18,0x52,0x2f,0x16,0xf7,0x29,0x73,0x2,0x8f,0x3c,0x73, + 0x77,0x2a,0x95,0xb2,0x4c,0xca,0xe5,0x7,0x81,0x4d,0xed,0xf7,0xf5,0xf5,0xd,0xcd, + 0x9b,0x37,0x6f,0xe,0x21,0x64,0x53,0xf9,0x77,0x41,0xbd,0xa,0x14,0x21,0xbd,0x58, + 0x87,0x7c,0xfb,0x38,0x68,0xb,0x53,0xf7,0xb,0x7,0x7,0x47,0x48,0x58,0xf8,0xd5, + 0xb5,0xa8,0x3d,0xa4,0x5f,0x49,0x9a,0xcb,0xe5,0x70,0xec,0xd8,0x31,0x47,0x9c,0xe0, + 0x63,0x22,0x6d,0x50,0x51,0x94,0xd7,0x67,0xb3,0xd9,0xb4,0xab,0x6,0x1c,0x22,0xd0, + 0x6c,0xde,0xb2,0x2c,0x7f,0x1,0x9a,0x1d,0x7e,0x83,0x8a,0x5a,0x30,0x2c,0x88,0xc8, + 0x11,0xd4,0x7e,0x72,0x11,0x90,0xe5,0xb9,0x16,0x38,0x38,0x66,0x1a,0x1a,0xff,0xb8, + 0x0,0xd,0xcf,0xce,0xd3,0x1d,0xa3,0x94,0xe2,0xc4,0x89,0x13,0x96,0xc9,0x69,0xca, + 0xeb,0x3a,0x45,0x39,0x27,0x51,0x4a,0x3f,0x3f,0x3a,0x3a,0x9a,0x72,0xae,0xad,0x3b, + 0x4,0x1a,0xbc,0x3a,0x38,0x38,0x98,0x5b,0xb0,0x60,0x41,0xa,0xc0,0xeb,0x82,0xb6, + 0x6a,0xd,0x3e,0xde,0x61,0x9,0x64,0x52,0x80,0xbc,0x71,0xc2,0x75,0x5b,0x1c,0x1c, + 0x1c,0xd1,0x20,0x76,0xb2,0x16,0x8b,0xff,0x65,0x1d,0x84,0xbc,0xde,0x16,0xec,0xef, + 0xef,0xd7,0x2d,0x70,0xb0,0x82,0x4f,0x9e,0xd9,0x3b,0x3c,0x3c,0xfc,0x2e,0xf8,0xcc, + 0x8,0x56,0x9,0x81,0xef,0x57,0xb3,0x76,0xed,0xda,0x1f,0x3,0x78,0xd1,0x69,0x7d, + 0xaf,0xa3,0x93,0xc1,0xca,0x5,0x90,0x78,0xa0,0x5,0xf1,0x5f,0x37,0x39,0x6e,0x8f, + 0x83,0x83,0x23,0x3a,0x88,0x93,0x12,0x96,0x7e,0x7e,0x3,0xc4,0x49,0x7d,0xa4,0xd1, + 0xe4,0xe4,0xa4,0xed,0x2e,0xe,0x0,0x13,0x57,0xe5,0x27,0x0,0x38,0x9f,0x8d,0xf3, + 0x80,0xc0,0x9,0xf7,0xc1,0x7,0x1f,0x54,0x0,0xbc,0x13,0xe,0xd6,0x22,0xfb,0xb9, + 0x61,0xe5,0x84,0x5b,0xfc,0x5c,0xfb,0xe5,0x5,0x10,0xf7,0xd5,0x80,0x83,0x83,0xa3, + 0x8a,0x41,0x81,0x85,0x5f,0x5b,0x8b,0xd8,0x9,0xfd,0x6a,0x32,0x55,0x55,0x71,0xe2, + 0xc4,0x9,0x5b,0x6e,0x60,0x40,0xb6,0xf7,0xd,0xd,0xd,0xfd,0xc6,0x71,0x23,0x1e, + 0x11,0xca,0x7a,0xd8,0xbe,0xbe,0xbe,0xde,0xf9,0xf3,0xe7,0xd7,0x3,0x30,0x4c,0xa0, + 0x15,0xc1,0x6a,0x87,0x8,0xed,0xbf,0x0,0x0,0x85,0x40,0x7a,0xb6,0x1e,0xf9,0x1b, + 0x47,0x81,0x5a,0x1e,0x2f,0xc6,0xc1,0x51,0x8d,0x68,0xf9,0xc5,0x72,0x34,0xfd,0x76, + 0xb1,0xe1,0xf8,0xf1,0xe3,0xc7,0x31,0x39,0x39,0x69,0x79,0x1e,0xa3,0x55,0x66,0x3, + 0xb2,0x2c,0xbf,0x36,0x97,0xcb,0x59,0xb,0x62,0x84,0xd0,0xb6,0xc0,0x6d,0x6c,0x6c, + 0xfc,0x2c,0x80,0x43,0xe5,0xc7,0x59,0x4f,0xa4,0x99,0xb9,0x16,0x84,0xde,0x18,0xea, + 0x3e,0xb5,0x98,0xf1,0x9a,0x11,0xe,0xe,0xe,0x16,0xa8,0x7f,0xb1,0x5,0x6d,0x3f, + 0x5b,0x65,0x38,0xde,0xdf,0xdf,0x6f,0x48,0xbb,0xa8,0x5,0xab,0x55,0x66,0x94,0xd2, + 0x7f,0x1c,0x1b,0x1b,0x1b,0x70,0xdc,0x98,0xf,0x84,0x96,0xf1,0xa5,0xa7,0xa7,0x47, + 0x5e,0xb0,0x60,0xc1,0x1e,0x0,0xef,0x0,0x40,0x0,0x66,0xa3,0x93,0x23,0x8,0x27, + 0xe3,0x0,0x1,0x94,0x4b,0x3,0x1f,0xc4,0x38,0x38,0x38,0x1c,0x42,0x1a,0x48,0x60, + 0xc9,0xe7,0x36,0x40,0x48,0xeb,0xa9,0x68,0x6c,0x6c,0xc,0x27,0x4e,0x9c,0xb0,0x3c, + 0x8f,0x61,0x62,0xf1,0xdf,0xf,0xf,0xf,0x7f,0xd4,0x71,0x63,0x3e,0x11,0x6a,0x8a, + 0xad,0xbe,0xbe,0xbe,0xee,0xf9,0xf3,0xe7,0xaf,0x2,0x70,0x51,0xd0,0x51,0xb,0x66, + 0x88,0xbd,0x54,0xf,0xda,0xaa,0x40,0x39,0x2f,0xc3,0xa4,0x3d,0xe,0xe,0xe,0xef, + 0x10,0xc6,0x25,0x2c,0xfb,0xe4,0x45,0x88,0xf5,0xe9,0xe7,0x58,0xf2,0xf9,0x3c,0xba, + 0xbb,0xbb,0x2b,0x59,0xa4,0x8e,0x65,0xd8,0xd4,0x4d,0xab,0xaa,0x7a,0x73,0x36,0x9b, + 0x35,0xdf,0x9b,0x27,0x0,0x84,0xe6,0x52,0xd0,0xe0,0x23,0x94,0xd2,0x3e,0xfb,0x6a, + 0x5,0xb0,0x7a,0x6d,0x28,0xba,0x1a,0x6a,0xbe,0xba,0x0,0xd2,0xf3,0x3c,0xc9,0xd, + 0x7,0x47,0x94,0x20,0x79,0x1,0x8b,0xbf,0xb8,0xe,0xf1,0xe3,0xfa,0xcd,0x60,0x29, + 0xa5,0x38,0x7a,0xf4,0xa8,0x69,0xbc,0x6d,0x0,0x71,0xfc,0x9f,0x1f,0x1d,0x1d,0x3d, + 0xe8,0xb8,0x41,0x6,0x8,0x3d,0x89,0x6c,0x7f,0x7f,0x7f,0x7a,0xfe,0xfc,0xf9,0xfd, + 0x0,0x6e,0xb5,0xab,0xcb,0x32,0x8f,0x6e,0xa9,0xac,0x12,0xc4,0x9e,0x6c,0x40,0xfe, + 0x6a,0xbe,0x12,0x8d,0x83,0x23,0x12,0x50,0x60,0xd1,0xd7,0xd7,0x62,0xce,0x8e,0x56, + 0xc3,0x57,0x27,0x4f,0x9e,0xc4,0xf8,0xf8,0xb8,0xf1,0x14,0xf6,0x6f,0xc4,0x2f,0xf, + 0xd,0xd,0xfd,0x15,0x42,0x9e,0xd9,0x89,0x24,0x6b,0x77,0x7f,0x7f,0xff,0xae,0x79, + 0xf3,0xe6,0x9d,0x3,0x60,0x83,0x55,0x1d,0xd6,0x37,0x58,0x47,0xba,0x79,0x82,0xf8, + 0x53,0xd,0xc8,0x5f,0x37,0x6,0x5a,0x1f,0x58,0x8c,0x33,0x7,0x7,0x87,0x9,0x5a, + 0x1f,0x58,0x81,0xa6,0xdf,0x2c,0x31,0x1c,0xef,0xeb,0xeb,0x33,0xdd,0x79,0x37,0x0, + 0xb2,0x4d,0x13,0x42,0x5e,0x93,0x4e,0xa7,0x4f,0x3b,0x6e,0x98,0x11,0xa2,0x70,0x29, + 0x0,0x0,0x32,0x99,0xcc,0xfb,0x0,0x74,0x97,0x1f,0xf,0x2a,0x73,0x7b,0x39,0x48, + 0xbf,0x84,0xfa,0x8f,0x2d,0x5,0xc9,0x44,0x76,0xb,0x38,0x38,0xce,0x38,0x34,0x3e, + 0xbe,0x0,0xad,0xf7,0xad,0x34,0x1c,0x1f,0x19,0x19,0x29,0xed,0xde,0xa0,0x45,0x40, + 0x5c,0xf0,0x8f,0xa9,0x54,0xea,0x65,0xc7,0xd,0x33,0x44,0x64,0x6c,0x73,0xf8,0xf0, + 0xe1,0x11,0x42,0xc8,0xdb,0x8,0x21,0x25,0x93,0x3e,0xc8,0x64,0xc2,0x66,0x75,0xa5, + 0x3,0xb5,0xa8,0xff,0xcc,0x12,0x10,0x99,0xe7,0x5c,0xe0,0xe0,0x8,0x1a,0x75,0xbb, + 0x9b,0xb0,0xe0,0xdb,0xe7,0x18,0xd2,0xa7,0x4e,0x4c,0x4c,0xa0,0xa7,0xa7,0x47,0x77, + 0x2c,0x40,0xc3,0xeb,0xd7,0x43,0x43,0x43,0xdf,0x72,0xdc,0x30,0x63,0x44,0xba,0x11, + 0x58,0x7f,0x7f,0xff,0xf1,0xb6,0xb6,0x36,0x89,0x10,0xb2,0x25,0xc8,0x64,0xc2,0x5a, + 0x94,0x2f,0x8e,0x10,0x8f,0x25,0x20,0x1e,0xaa,0x41,0xbe,0x63,0x2c,0xc2,0xe1,0x87, + 0x83,0x63,0x76,0xa3,0x6e,0x4f,0x13,0x96,0xfc,0xf3,0x6,0x90,0x9c,0xbe,0x93,0xe5, + 0x72,0x39,0x1c,0x3d,0x7a,0x54,0xb7,0x39,0x6c,0x80,0xe1,0xa2,0xa7,0xf2,0xf9,0xfc, + 0xb6,0x5c,0x2e,0x17,0x59,0x82,0x95,0xc8,0x29,0x66,0xc1,0x82,0x5,0x9f,0xa3,0x94, + 0x3e,0xe3,0xb4,0xbe,0x1f,0xb2,0xb5,0xca,0xbb,0x10,0x7b,0xb2,0x1,0x75,0x9f,0x59, + 0x52,0xda,0xc6,0x83,0x83,0x83,0x83,0x1d,0x6a,0x5f,0x9e,0x6b,0x20,0x5b,0xf2,0xff, + 0xb7,0x77,0xe6,0xc1,0x91,0x5c,0xf5,0x1d,0xff,0xbc,0xee,0x9e,0x43,0xf7,0x5a,0xab, + 0x63,0x57,0x2b,0x4b,0xab,0xc3,0xbb,0xf1,0xca,0x5e,0x48,0x16,0x53,0xc6,0x60,0x70, + 0xd9,0x80,0x21,0x60,0x8,0x60,0x17,0x84,0xa3,0x62,0x96,0x60,0x7,0xf8,0x23,0x5, + 0x14,0xc1,0x1,0x1b,0x8,0x21,0x15,0x88,0xab,0x42,0x70,0x62,0x2a,0x85,0x39,0x42, + 0xa0,0x8,0xc1,0xc1,0xe6,0xf0,0x41,0x62,0x27,0x40,0xe2,0x83,0x0,0xc6,0x60,0x62, + 0xaf,0x6d,0x6c,0x56,0xb2,0xb4,0xab,0x95,0x34,0xa3,0x99,0x9e,0x19,0xcd,0xdd,0xfd, + 0xf2,0x87,0x34,0xb3,0x23,0xcd,0xa1,0x9e,0xdd,0x39,0x7a,0x46,0xef,0x53,0x35,0x35, + 0x52,0xcf,0xaf,0x5f,0xbf,0x9a,0x7e,0xef,0x3b,0xaf,0xdf,0xfb,0xbd,0xdf,0x4f,0x8, + 0x6c,0xdb,0x66,0x76,0x76,0x76,0x53,0x30,0xf1,0x3a,0x3e,0xe5,0x4a,0xdb,0xb6,0xaf, + 0x8d,0xc5,0x62,0xdb,0x7,0x65,0xa8,0x23,0x4d,0x4f,0x75,0x3b,0x3b,0x3b,0x6b,0xf7, + 0xf7,0xf7,0xff,0x50,0xd3,0xb4,0x77,0x2,0xbe,0x4a,0xb6,0xb5,0x18,0x5,0x4b,0x29, + 0xf3,0x79,0x91,0xa,0xd1,0x67,0x7d,0x88,0x53,0x1e,0x32,0x97,0x46,0x37,0xb6,0x65, + 0x28,0x14,0x8a,0xb3,0xc5,0xff,0x6c,0xf,0xfb,0x3e,0x71,0x21,0x5a,0x72,0x73,0xb2, + 0x0,0xdb,0xb6,0x99,0x9b,0x9b,0x23,0x99,0x3c,0xed,0x13,0x5f,0xe7,0xa7,0xdc,0x5b, + 0x4c,0xd3,0x6c,0xda,0x54,0x42,0x8e,0xa6,0xb,0x2e,0x40,0x30,0x18,0xc,0xd,0xd, + 0xd,0x2d,0x3,0xaf,0x2f,0x67,0x53,0xcb,0x9b,0x51,0x4e,0x74,0x8d,0x67,0xfc,0x68, + 0x11,0x83,0xcc,0x8b,0x8a,0xdd,0x52,0x14,0xa,0x45,0x75,0xf8,0xe6,0xbb,0x18,0xbd, + 0xe9,0x30,0x7a,0xcc,0x93,0x3f,0x56,0x38,0xb2,0x5d,0x5b,0x3b,0xfd,0x64,0x5f,0x67, + 0xb1,0xfd,0xbf,0xee,0xee,0xee,0xb7,0x44,0x22,0x91,0xba,0x46,0x2,0x73,0x82,0x2b, + 0x4,0x17,0x60,0x65,0x65,0xe5,0xd1,0xc1,0xc1,0xc1,0x41,0xe0,0x85,0x85,0xc7,0xeb, + 0x35,0x9f,0x53,0x4a,0x74,0x85,0x10,0x18,0xc7,0x3a,0x10,0x19,0x8d,0xcc,0xb,0x54, + 0x1c,0x5d,0x85,0xe2,0x4c,0xf1,0x9c,0xe8,0x60,0xf4,0xe3,0x87,0x31,0x42,0x5e,0xe0, + 0x74,0xb6,0xdd,0xdc,0xc6,0x86,0x9c,0xd8,0xd6,0x73,0x7b,0xff,0x86,0x6d,0x0,0xb8, + 0x6c,0x79,0x79,0xb9,0x21,0xb1,0x12,0xb6,0xc3,0x35,0x82,0xb,0x30,0x3e,0x3e,0x7e, + 0x5f,0x26,0x93,0xb9,0xc,0x18,0x87,0xfa,0xa6,0xe2,0xc9,0xcd,0xff,0x8,0x21,0x8a, + 0xb2,0x46,0x18,0x8f,0x75,0xa2,0x5,0x3c,0x64,0x2e,0x51,0xd3,0xb,0xa,0x45,0xb5, + 0xf8,0x9f,0xee,0x61,0xec,0xc6,0xe7,0xa3,0x87,0x4f,0x8b,0x2d,0xac,0xf7,0xb9,0xe7, + 0x9e,0x7b,0x8e,0x68,0x34,0x9a,0xff,0xdf,0x29,0x67,0x28,0xcc,0x96,0x94,0xf2,0x8d, + 0xa6,0x69,0x3a,0x8e,0xc7,0x5d,0x6f,0x5c,0x25,0xb8,0x8b,0x8b,0x8b,0xf6,0xf0,0xf0, + 0xf0,0xbd,0x52,0xca,0xb7,0x4a,0x29,0x7b,0x9c,0x9e,0x77,0xb6,0xb,0x69,0xa5,0xd2, + 0xf4,0x18,0x4f,0x75,0xa0,0x2f,0xf8,0xd6,0xe7,0x74,0x9b,0xbe,0xb4,0xa8,0x50,0xb4, + 0x6,0xfe,0x63,0xbd,0xec,0xfb,0x8b,0xc3,0xe8,0x6b,0xeb,0x41,0xc4,0xb,0xc5,0x76, + 0x7e,0x7e,0x3e,0x1f,0xfd,0xab,0x41,0x5e,0x49,0x9f,0x34,0x4d,0xf3,0xcb,0x8e,0x4f, + 0x6e,0x0,0xae,0x12,0x5c,0x80,0x95,0x95,0x95,0xd8,0xc0,0xc0,0xc0,0x4f,0x80,0x77, + 0xe0,0xa0,0x7e,0xb5,0xb8,0x71,0xb6,0x6d,0x97,0x14,0x5d,0xfd,0xb7,0x7e,0x8c,0xa7, + 0xfd,0xa4,0x5f,0x16,0x71,0xe1,0x37,0xa5,0x50,0xb8,0x8b,0xce,0x5f,0x9d,0xc3,0xbe, + 0x4f,0x5e,0x88,0x9e,0x2c,0x16,0xdb,0x93,0x27,0x4f,0xe6,0x53,0xe4,0x34,0x48,0x6c, + 0xef,0xe,0x87,0xc3,0xef,0xa1,0xc8,0xeb,0xb7,0xb9,0xb8,0x52,0x46,0x2,0x81,0xc0, + 0xfc,0xc0,0xc0,0x40,0x1c,0xb8,0xb2,0x92,0x5d,0x2d,0x6f,0x5c,0x39,0xd1,0x35,0x16, + 0xfc,0x18,0x4f,0x75,0x90,0xb9,0x2c,0xa,0xba,0xab,0xee,0x9d,0x42,0xe1,0x1a,0xba, + 0x7f,0x3a,0xb0,0x9e,0x8b,0x2c,0xad,0x6f,0x5a,0x1b,0xc9,0x4d,0x23,0x84,0xc3,0xe1, + 0x46,0xcc,0xd7,0xe6,0x78,0x56,0x4a,0xf9,0xea,0x7a,0x65,0xde,0x3d,0x1b,0x5c,0x29, + 0xb8,0x0,0x81,0x40,0xe0,0xe1,0xdd,0xbb,0x77,0x9f,0x2f,0x84,0xb8,0x60,0xeb,0x67, + 0xf5,0x5c,0x48,0x83,0x12,0x9b,0x23,0x16,0x7c,0x18,0x4f,0x74,0x90,0xbe,0x34,0x2, + 0x5e,0x25,0xba,0xa,0x45,0x21,0x3d,0xf,0xe,0xb2,0xf7,0x6f,0xcf,0x47,0x64,0x36, + 0xf,0x58,0x72,0xb,0x64,0xd1,0x68,0xb4,0x91,0x62,0x1b,0x17,0x42,0xbc,0x32,0x1c, + 0xe,0xcf,0x55,0x75,0xc1,0x6,0xe1,0xf6,0xd9,0xc9,0x77,0x3,0x8f,0x15,0x1e,0xa8, + 0xe7,0x8d,0xb3,0x6d,0x9b,0x6c,0x36,0x9b,0x5f,0x4c,0x2b,0xc4,0xf3,0xb3,0x6e,0x76, + 0xbd,0x6b,0x1a,0x7d,0xbe,0xa2,0xab,0xb0,0x42,0xb1,0x73,0x90,0xb0,0xfb,0x5f,0xc6, + 0xd9,0x7b,0xf3,0x21,0x44,0x7a,0xb3,0xd8,0xda,0xb6,0xcd,0xf1,0xe3,0xc7,0xab,0x16, + 0xdb,0xb3,0xdc,0xd2,0x2b,0x85,0x10,0xd7,0x87,0x42,0xa1,0xc7,0xca,0xd9,0x37,0x1b, + 0xd7,0xaf,0xc1,0xcf,0xcc,0xcc,0xec,0xb1,0x2c,0xeb,0x27,0xc0,0x78,0x3,0x56,0x35, + 0x81,0xd,0xf7,0x30,0xc3,0x40,0xd3,0x8a,0x7f,0x8f,0x64,0x9f,0x45,0xe4,0xaf,0xe7, + 0xc8,0x1e,0x56,0x99,0x23,0x14,0x3b,0x98,0x8c,0x60,0xcf,0xe7,0xf,0xd2,0xfb,0x5f, + 0xc3,0x45,0x83,0x93,0x6c,0x36,0xcb,0xec,0xec,0x2c,0x89,0x44,0xa2,0x51,0xf3,0xb5, + 0xb9,0x63,0x37,0x98,0xa6,0xf9,0x19,0xc7,0x85,0x34,0x1,0xd7,0xb,0x2e,0xc0,0xcc, + 0xcc,0xcc,0xa1,0x6c,0x36,0xfb,0x20,0xe0,0x28,0xe7,0x79,0xad,0x6e,0xb2,0xc7,0xe3, + 0x29,0x29,0xba,0xc2,0x7,0xd1,0x8f,0x2c,0x90,0xba,0x22,0xec,0xf8,0x3a,0xa,0x45, + 0xbb,0xa0,0xad,0x19,0x8c,0x7c,0x7a,0x86,0xce,0xc7,0x76,0x95,0x14,0xdb,0xb9,0xb9, + 0x39,0xe2,0xf1,0x78,0xa3,0xc5,0xf6,0xf3,0xa6,0x69,0xbe,0xcf,0x71,0x21,0x4d,0xc2, + 0xb5,0x73,0xb8,0x85,0xac,0xac,0xac,0xac,0xc,0xe,0xe,0xfe,0x2f,0xf0,0x56,0xb6, + 0xa9,0x73,0xad,0x17,0xd2,0x80,0x4d,0xa2,0x2b,0x84,0x0,0x4b,0xe0,0xfd,0xef,0x5e, + 0xd8,0x65,0x91,0x3d,0xdf,0x75,0xf3,0xf2,0xa,0x45,0xdd,0x30,0x56,0x7d,0x8c,0x7e, + 0xfc,0x30,0x1d,0x4f,0xf5,0x16,0x89,0x6d,0x2a,0x95,0xe2,0xf8,0xf1,0xe3,0x24,0x12, + 0xd5,0xf5,0x89,0x1a,0xf4,0xd9,0xef,0x9b,0xa6,0x79,0x2d,0x2e,0xf3,0x48,0x28,0x45, + 0x4b,0x8,0x2e,0x40,0x20,0x10,0x98,0x1d,0x18,0x18,0x38,0x41,0x83,0xb6,0xff,0x16, + 0xda,0x49,0x29,0x31,0xc,0x63,0xf3,0xae,0x34,0x29,0xf0,0x3e,0xdc,0x83,0x3e,0xef, + 0x23,0x73,0x71,0xc,0xc,0xd7,0xdf,0x6b,0x85,0xe2,0xac,0xe8,0x7a,0xb4,0x9f,0xd1, + 0x8f,0x1d,0xc6,0xb3,0xd4,0x51,0x24,0xb6,0x6b,0x6b,0x6b,0x1c,0x3f,0x7e,0x9c,0x4c, + 0x26,0xe3,0xb8,0xbc,0x1a,0xad,0xc7,0xfc,0xd2,0x30,0x8c,0xab,0xe2,0xf1,0x78,0x4b, + 0x24,0x2a,0x6c,0x19,0xc1,0x5,0x8,0x6,0x83,0xbf,0x1c,0x18,0x18,0xf0,0x0,0x2f, + 0x2d,0x3c,0x5e,0xef,0x15,0x50,0x29,0x25,0xb6,0x6d,0xa3,0xeb,0x7a,0xb1,0xdb,0xd8, + 0x6f,0xfd,0xf8,0x1e,0xea,0x25,0x73,0x51,0xc,0xd9,0xab,0x52,0xf6,0x28,0xda,0x10, + 0x1b,0x6,0xbf,0x36,0xc9,0xd0,0x3f,0x9e,0x87,0x9e,0x36,0x8a,0xfa,0x40,0x38,0x1c, + 0x66,0x7e,0x7e,0xbe,0x64,0x1e,0xb2,0x72,0xd4,0x68,0x70,0x34,0x6f,0x18,0xc6,0xe5, + 0x81,0x40,0xa0,0x61,0x49,0x20,0xcf,0x96,0x96,0x12,0x5c,0x80,0x60,0x30,0xf8,0xa3, + 0x81,0x81,0x81,0xdf,0x1,0x2e,0x80,0x86,0x6c,0xf,0xcc,0xff,0x5d,0x4e,0x74,0xb5, + 0x90,0x81,0xff,0xde,0x7e,0xec,0xf1,0x34,0xd6,0x78,0xaa,0xaa,0x6b,0x28,0x14,0x6e, + 0x46,0x5b,0x33,0xd8,0x7b,0xf3,0x21,0xfa,0xee,0xdf,0x53,0xd4,0xee,0x1,0x96,0x96, + 0x96,0x58,0x5c,0x5c,0xdc,0x14,0xcf,0x76,0x3b,0x6a,0xd4,0x67,0xa3,0xb6,0x6d,0xbf, + 0x26,0x14,0xa,0x3d,0xe5,0xb8,0x30,0x17,0xd0,0x72,0x82,0xb,0xc8,0x60,0x30,0x78, + 0xe7,0xe0,0xe0,0xe0,0x1,0x29,0x65,0x91,0x8f,0x6e,0xd9,0x93,0x6a,0x30,0xa,0x96, + 0x52,0x62,0x59,0x56,0xd1,0x6,0x9,0x21,0x4,0x22,0xa3,0xe1,0xfb,0xe1,0x2e,0xb4, + 0xb4,0x46,0xfa,0xf7,0x62,0x2d,0xb2,0x1c,0xa9,0x50,0x94,0xc7,0x37,0xd7,0xc5,0xb9, + 0x37,0x3d,0xaf,0xe4,0x7c,0xad,0x94,0x92,0xc5,0xc5,0x45,0x56,0x56,0xaa,0xb,0x2f, + 0x5b,0x43,0xb1,0x7d,0x45,0x24,0x12,0xf9,0x69,0x55,0x17,0x77,0x1,0xad,0x28,0xb8, + 0x0,0x72,0x7c,0x7c,0xfc,0x7b,0xa9,0x54,0xea,0x79,0x42,0x88,0x83,0xdb,0x1a,0xd7, + 0x78,0x14,0x6c,0x59,0x56,0xc9,0xa0,0x37,0x0,0x9e,0x5f,0x77,0xe1,0xf9,0x4d,0x7, + 0x99,0x17,0xc4,0x90,0x7e,0x95,0xa0,0x52,0xd1,0x9a,0xf4,0xfc,0x78,0x88,0x91,0x4f, + 0x5f,0x80,0x11,0xf2,0x16,0xb5,0xf1,0x74,0x3a,0xcd,0xec,0xec,0x2c,0xa6,0x69,0x56, + 0x55,0x66,0x8d,0xfa,0xe1,0x9a,0x10,0xe2,0x55,0xa6,0x69,0x3a,0x4e,0x5a,0xe0,0x26, + 0x5a,0x7a,0x1c,0x36,0x33,0x33,0xe3,0xcd,0x64,0x32,0x77,0x2,0xbf,0x5f,0xce,0xa6, + 0x9e,0xae,0x29,0x86,0x61,0xe0,0xf5,0x16,0x37,0x48,0x0,0xbb,0x2f,0x4b,0xf4,0xc3, + 0xb,0xa4,0x5f,0x12,0x71,0x5c,0xa6,0x42,0xd1,0x6c,0xf4,0xa8,0x87,0xe1,0x7f,0x38, + 0x40,0xf7,0x4f,0x6,0x4a,0xb6,0xeb,0x58,0x2c,0xc6,0xfc,0xfc,0x7c,0x33,0x16,0xc7, + 0x90,0x52,0x26,0x81,0xab,0x4c,0xd3,0xbc,0xbf,0xaa,0x2,0x5d,0x44,0x4b,0xb,0x2e, + 0xc0,0xe8,0xe8,0x68,0x47,0x47,0x47,0xc7,0x3d,0x42,0x88,0xcb,0xb6,0x7e,0xd6,0x8, + 0x3f,0x40,0x4d,0xd3,0xf0,0xfb,0xfd,0x25,0x1b,0xa7,0x10,0x82,0xe4,0x95,0x21,0xa2, + 0xef,0x5f,0x40,0x76,0xa8,0xd1,0xae,0xc2,0xdd,0x74,0x3d,0xd2,0xcf,0xf0,0x2d,0x7, + 0x31,0xc2,0xc5,0x83,0x8,0x29,0x25,0xcb,0xcb,0xcb,0xac,0xac,0xac,0x34,0x63,0xbe, + 0x16,0x20,0x3,0x5c,0x1d,0xe,0x87,0xbf,0xe7,0xb8,0x40,0x17,0xd2,0xf2,0x82,0xb, + 0x70,0xf8,0xf0,0xe1,0xae,0x64,0x32,0x79,0x2f,0x70,0x29,0x34,0x24,0xa8,0xf1,0x26, + 0x84,0x10,0xf8,0x7c,0x3e,0x74,0x7d,0x73,0x1a,0x91,0x1c,0xd6,0x58,0xa,0xf3,0xc6, + 0x39,0xb2,0x7,0x95,0xcf,0xae,0xc2,0x7d,0x88,0x8c,0xc6,0xe0,0x57,0x27,0xd9,0x75, + 0xd7,0x3e,0x90,0xc5,0x39,0xff,0x6c,0xdb,0xe6,0xc4,0x89,0x13,0x55,0x7,0xa0,0xa9, + 0xa1,0x6d,0x16,0x78,0x73,0x38,0x1c,0xbe,0xc3,0x71,0x81,0x2e,0xa5,0x2d,0x4,0x17, + 0xe0,0xc0,0x81,0x3,0x3,0xc0,0x7d,0x52,0xca,0xe7,0x3b,0x3d,0xa7,0xd6,0xc2,0xec, + 0xf1,0x78,0xca,0x4e,0x31,0xe0,0x93,0xc4,0x8e,0x2e,0x92,0xb8,0x26,0x80,0x54,0x51, + 0xc7,0x14,0x2e,0xc1,0x37,0xdf,0xc5,0xd0,0x2d,0x7,0xe8,0x78,0xba,0x78,0x61,0xc, + 0x4e,0xa7,0x30,0x4f,0xa5,0xaa,0xf3,0xbe,0xa9,0xa1,0xd8,0xda,0x52,0xca,0xeb,0x4d, + 0xd3,0xfc,0x62,0x55,0x15,0x70,0x29,0x6d,0x23,0xb8,0x0,0x33,0x33,0x33,0xdd,0xa9, + 0x54,0xea,0xbb,0x42,0x88,0xcb,0xb7,0xb3,0xad,0xd7,0x2f,0x75,0x6e,0x8a,0xa1,0xd4, + 0x96,0x60,0x80,0xec,0x44,0x92,0xe8,0x87,0xe6,0xc9,0xcc,0xa8,0x58,0xc,0x8a,0xe6, + 0xa1,0xa5,0x74,0x6,0xbe,0x36,0x41,0xdf,0x3d,0x23,0x8,0xab,0x38,0xbf,0x9f,0x94, + 0x92,0xa5,0xa5,0x25,0x2,0x81,0x40,0xdd,0xa6,0x10,0x1c,0xd8,0x67,0xa4,0x94,0x6f, + 0x33,0x4d,0xf3,0xf6,0xaa,0xa,0x75,0x31,0x6d,0x25,0xb8,0x0,0x23,0x23,0x23,0x9d, + 0x5d,0x5d,0x5d,0xdf,0x1,0x5e,0x51,0xce,0xa6,0x11,0x8f,0x45,0x7e,0xbf,0x1f,0x8f, + 0xc7,0x53,0x64,0x23,0x84,0x0,0xd,0x12,0xaf,0x9,0x12,0x7d,0xcf,0x9,0x64,0xa7, + 0x9a,0xdb,0x55,0x34,0x96,0xce,0x5f,0x9d,0xc3,0xf0,0xe7,0xf,0xe0,0x39,0xe5,0x7, + 0x8a,0xa7,0x10,0xd2,0xe9,0x34,0xf3,0xf3,0xf3,0xd,0x8f,0x87,0xb0,0x85,0x84,0x10, + 0xe2,0xea,0x50,0x28,0x74,0x8f,0xe3,0x42,0x5b,0x80,0xb6,0x13,0x5c,0x80,0xe9,0xe9, + 0x69,0x1f,0xf0,0x4d,0x21,0xc4,0x1f,0x6c,0xfd,0xac,0x91,0xd,0xc8,0x30,0xc,0x7c, + 0x3e,0x5f,0x7e,0xb4,0xbb,0xb5,0x61,0x5b,0x7b,0xd2,0x44,0x3e,0x30,0x4f,0xfa,0x85, + 0x51,0xc7,0xd7,0x51,0x28,0xce,0x14,0x3d,0xea,0x61,0xf0,0x4b,0x53,0xf4,0xfe,0x68, + 0x38,0x1f,0x75,0x60,0x6b,0x9b,0x5c,0x5d,0x5d,0xe5,0xd4,0xa9,0x53,0x58,0x96,0xd5, + 0x4c,0xb1,0x8d,0x2,0x57,0x85,0xc3,0xe1,0x1f,0x3b,0x2e,0xb4,0x45,0x68,0x4b,0xc1, + 0x5,0x38,0x72,0xe4,0x88,0x27,0x12,0x89,0x7c,0x3,0xb8,0x1a,0x1a,0xbf,0x90,0x96, + 0x43,0x8,0x51,0x76,0xb4,0xbb,0x6e,0x0,0xc9,0x57,0xad,0x12,0x7b,0xf7,0x22,0x56, + 0xbf,0x73,0x57,0x1b,0x85,0xc2,0x31,0x12,0xba,0x1f,0x18,0x64,0xe8,0x9f,0xa6,0x30, + 0x2,0xeb,0xf1,0x9c,0x8b,0x7e,0xfc,0x2d,0x2b,0x9f,0x6,0xa7,0x59,0x7d,0x65,0x3, + 0x53,0x8,0xf1,0xda,0x50,0x28,0xf4,0x40,0x55,0x95,0x68,0x11,0xda,0x56,0x70,0x37, + 0xd0,0xcf,0x3b,0xef,0xbc,0x2f,0x4a,0x29,0xaf,0xad,0xe6,0xa4,0x7a,0xfc,0xb2,0x1b, + 0x86,0x51,0x71,0x6e,0x57,0xfa,0x6c,0x12,0x6f,0xa,0x10,0x7b,0xc7,0x29,0xe5,0x42, + 0xa6,0xa8,0x19,0x1d,0xc7,0xfa,0x18,0xbc,0x6d,0xa,0xff,0xb3,0xa7,0x73,0xb2,0x6e, + 0xcd,0xca,0x10,0xc,0x6,0x59,0x5e,0x5e,0xae,0xeb,0xa8,0xd6,0xa1,0x7d,0x40,0x4a, + 0x79,0xa5,0x9b,0xb2,0xec,0xd6,0x9a,0x76,0x17,0x5c,0x0,0x7d,0x6a,0x6a,0xea,0x56, + 0x21,0xc4,0xf5,0xdb,0x19,0xd6,0xfb,0x97,0x3d,0xe7,0x3e,0x56,0xca,0x93,0x21,0xf7, + 0xbf,0x3d,0x98,0x21,0xfa,0xc7,0x27,0x49,0xbc,0x62,0x75,0x67,0xdc,0x1d,0x45,0x5d, + 0xf0,0xac,0xf8,0x19,0xf8,0xca,0x24,0x3d,0xf,0xd,0x6e,0xa,0x5a,0x58,0xd8,0xee, + 0x92,0xc9,0x24,0x27,0x4f,0x9e,0x64,0x6d,0x6d,0xd,0x68,0x5c,0x5c,0x92,0x32,0x9c, + 0x4,0x5e,0x1b,0xe,0x87,0x1f,0xad,0xaa,0xe0,0x16,0x63,0xc7,0x74,0xe9,0xa9,0xa9, + 0xa9,0xeb,0x84,0x10,0xb7,0x2,0x46,0xa9,0xcf,0x1b,0xd9,0xd8,0x74,0x5d,0xa7,0xa3, + 0xa3,0xa3,0x64,0x20,0x9c,0x1c,0xe9,0x8b,0xa2,0x44,0xde,0xbb,0x40,0x76,0x7f,0x4b, + 0x44,0x9d,0x53,0xb8,0x85,0x8c,0xe0,0x9c,0x7b,0xf6,0xd1,0xff,0xcd,0x71,0xf4,0xf8, + 0xe9,0xa6,0xbe,0x75,0x54,0x9b,0xf3,0x40,0xc8,0xb5,0xcd,0x26,0xce,0xd7,0x2,0xfc, + 0xdc,0x30,0x8c,0xd7,0x5,0x2,0x81,0x45,0xc7,0x5,0xb7,0x28,0x3b,0x46,0x70,0x1, + 0xa6,0xa7,0xa7,0xaf,0x4,0xbe,0x5,0xf4,0x16,0x1e,0x6f,0x56,0x63,0xf3,0xf9,0x7c, + 0x65,0x77,0xa9,0x1,0x20,0x20,0x75,0xb1,0x49,0xec,0xe8,0x29,0x32,0xd3,0xca,0x8d, + 0x4c,0x51,0x1e,0x91,0xd6,0xd8,0xf5,0xfd,0x7d,0xf4,0x7f,0xf7,0x5c,0x74,0x73,0xf3, + 0x7a,0x41,0x61,0xfb,0x8a,0xc5,0x62,0x2c,0x2e,0x2e,0x92,0x4c,0x9e,0xfe,0x21,0x6f, + 0xb2,0xd8,0x7e,0xcf,0xe7,0xf3,0xbd,0x75,0x69,0x69,0x69,0xcd,0x71,0xc1,0x2d,0xcc, + 0x8e,0x12,0x5c,0x80,0x89,0x89,0x89,0xc3,0xba,0xae,0xdf,0xd,0x8c,0x42,0xd3,0x1b, + 0x5b,0x7e,0x51,0xad,0xdc,0x86,0x89,0xbc,0x1b,0xd9,0xa5,0x21,0x62,0x47,0x17,0xc9, + 0x9e,0xab,0x46,0xbc,0x8a,0xd3,0x88,0x8c,0x46,0xdf,0xf,0xf6,0xd2,0x7f,0xe7,0xb9, + 0x18,0xc1,0xe2,0x4,0xa7,0xb9,0x36,0x95,0x4c,0x26,0x59,0x5c,0x5c,0x24,0x16,0x8b, + 0xe5,0x3f,0x6b,0xf2,0xe2,0x18,0xc0,0x2d,0xe1,0x70,0xf8,0x3,0xc0,0x8e,0x9,0x24, + 0xbd,0xe3,0x4,0x17,0xe0,0xc0,0x81,0x3,0xfb,0xb2,0xd9,0xec,0x5d,0x42,0x88,0xba, + 0xec,0x4a,0x3b,0x13,0xdb,0xdc,0x34,0x43,0xa1,0x37,0x43,0x91,0x0,0x6f,0x8,0x6f, + 0xf4,0x5d,0x27,0xb1,0x46,0x55,0xdc,0xdd,0x9d,0x8c,0xb0,0x4,0xbd,0xf7,0xef,0x61, + 0xf7,0xed,0xe3,0x18,0x2b,0xa5,0x33,0x49,0xb,0x21,0xb0,0x2c,0x8b,0xe5,0xe5,0x65, + 0x82,0xc1,0x60,0x51,0x7c,0x67,0xa7,0xd4,0x41,0x98,0x2d,0xe0,0x83,0xe1,0x70,0xf8, + 0x73,0x55,0x15,0xdc,0x6,0xec,0x48,0xc1,0x5,0x18,0x1d,0x1d,0xed,0xf7,0xf9,0x7c, + 0x77,0x0,0x2f,0xab,0x64,0xd7,0xe8,0x51,0x80,0xd7,0xeb,0xcd,0xcf,0xef,0x96,0xc5, + 0x2b,0x49,0xbc,0x7c,0x95,0xd8,0x35,0x4b,0x64,0xc7,0xd5,0x88,0x77,0x27,0x21,0x32, + 0x1a,0xbd,0x3f,0x1a,0xe6,0x9c,0xef,0x8c,0xe2,0x5d,0xe8,0x2c,0x6d,0xb3,0xf1,0x43, + 0x6d,0x9a,0x26,0x8b,0x8b,0x8b,0x45,0x91,0xbd,0x9a,0xfc,0x54,0x97,0x90,0x52,0xbe, + 0xd3,0x34,0xcd,0x7f,0x75,0x5c,0x70,0x1b,0xb1,0x63,0x5,0x77,0x3,0x7d,0x7a,0x7a, + 0xfa,0x26,0x29,0xe5,0x4d,0x40,0x91,0xbf,0x56,0x33,0x1f,0xb9,0x9c,0x8,0xaf,0x10, + 0x82,0xf4,0x5,0x31,0x62,0x6f,0x39,0x45,0xf2,0x62,0x53,0xdd,0xcd,0x36,0x46,0x5f, + 0xf5,0xb2,0x91,0x64,0x19,0x4e,0x0,0x0,0xa,0x15,0x49,0x44,0x41,0x54,0xfb,0x8e, + 0x31,0x7a,0xfe,0x73,0x78,0xd3,0x62,0x58,0x29,0x4c,0xd3,0x64,0x79,0x79,0xb9,0x64, + 0xfc,0x83,0x66,0x8a,0xad,0x94,0xf2,0x98,0x6d,0xdb,0x6f,0x88,0x46,0xa3,0x2d,0x95, + 0xa5,0xa1,0x96,0xa8,0x2e,0xa,0x4c,0x4f,0x4f,0x5f,0x25,0xa5,0xfc,0x1a,0xd0,0x97, + 0x3b,0xd6,0xe4,0x47,0xae,0x3c,0x3e,0x9f,0x8f,0x8e,0x8e,0x8e,0xe2,0xcc,0xc1,0x5b, + 0xc8,0x4e,0x26,0x88,0xbd,0x7e,0x99,0xc4,0x2b,0x57,0x91,0x5e,0xe5,0xc7,0xdb,0x2e, + 0x78,0xe7,0x3b,0xe9,0xff,0xf6,0x18,0xbd,0xf,0xc,0x41,0xa6,0x7c,0x77,0x95,0x52, + 0x12,0x89,0x44,0x6a,0x22,0xb4,0xd5,0xda,0x3b,0xb4,0xbd,0xc3,0x30,0x8c,0x6b,0x3, + 0x81,0xc0,0x8e,0xde,0x56,0xa9,0x4,0x77,0x83,0xc9,0xc9,0xc9,0x3,0x42,0x88,0x3b, + 0x81,0x43,0xcd,0x5e,0x48,0x2b,0x65,0xef,0xf7,0xfb,0xb7,0x9f,0x6a,0x60,0x7d,0xbb, + 0x70,0xfc,0xca,0x0,0xf1,0x57,0x5,0xb1,0x86,0xd2,0x55,0x5d,0x4f,0xe1,0xe,0x84, + 0x25,0xe8,0x7c,0xa4,0x9f,0x5d,0xf7,0xed,0xa5,0xf3,0x91,0x7e,0x84,0x55,0xb9,0x9b, + 0x86,0xc3,0x61,0x2,0x81,0xc0,0x26,0xcf,0x83,0x42,0x9a,0x3c,0x78,0xb0,0xa5,0x94, + 0x1f,0x31,0x4d,0xf3,0x6f,0xc0,0xfd,0x69,0xcc,0xeb,0x8d,0x12,0xdc,0x2,0xe,0x1e, + 0x3c,0xd8,0x93,0xc9,0x64,0xbe,0x2,0xbc,0xc9,0x89,0x7d,0xa3,0x85,0x39,0xe7,0xd1, + 0xb0,0x75,0xc4,0x5b,0xca,0xe,0x20,0x73,0x20,0xce,0xda,0x6b,0x56,0x88,0x5f,0x1e, + 0x54,0xbb,0xd7,0x5a,0x0,0xdf,0xb3,0xdd,0xf4,0xfd,0x60,0x2f,0x3d,0xf,0xc,0xa2, + 0xc7,0xcb,0x6c,0x5,0xdf,0x20,0x37,0xa2,0xd,0x4,0x2,0x24,0x12,0xe5,0xe3,0x2c, + 0x37,0x59,0x6c,0x43,0x42,0x88,0xb7,0x85,0x42,0xa1,0x7b,0xab,0x2a,0xb8,0x8d,0x51, + 0x82,0x5b,0x8c,0x36,0x35,0x35,0xf5,0x49,0x29,0xe5,0x47,0xa8,0xf0,0xfd,0x34,0x7b, + 0x14,0xec,0xf5,0x7a,0xf3,0xee,0x64,0x85,0x94,0x4c,0xf7,0xd3,0x9b,0x25,0x7e,0x45, + 0x90,0xf8,0x95,0x41,0xe5,0xcf,0xeb,0x32,0xf4,0xb8,0x41,0xd7,0xc3,0x3,0xf4,0xfe, + 0xc7,0x30,0x1d,0xc7,0xd6,0x67,0xb4,0xca,0xfa,0x65,0xb3,0x1e,0xf3,0x20,0x18,0xc, + 0xb2,0xba,0xba,0x4a,0x36,0x9b,0xad,0x58,0x76,0x93,0xe7,0x6b,0x9f,0x34,0xc,0xe3, + 0x8d,0xc1,0x60,0xf0,0x98,0xe3,0x82,0x77,0x0,0x4a,0x70,0xcb,0x30,0x3d,0x3d,0xfd, + 0x22,0xcb,0xb2,0xbe,0x2e,0x84,0x98,0x2c,0x3c,0xee,0x82,0xb9,0xb0,0x4d,0xb6,0x86, + 0x61,0xd0,0xd1,0xd1,0x51,0x79,0x3,0x45,0x1,0xd6,0x40,0x9a,0xe4,0x4b,0xc3,0xc4, + 0x5f,0xba,0x4a,0x7a,0x46,0x65,0x17,0x6e,0x6,0x7a,0xd8,0x43,0xcf,0xff,0xc,0xd1, + 0xfd,0xc0,0x0,0xfe,0xa7,0x7a,0x11,0xf6,0xfa,0x4d,0xa8,0x74,0xff,0xd2,0xe9,0x34, + 0x2b,0x2b,0x2b,0x98,0xa6,0xe9,0x28,0x3e,0x6d,0x13,0xc5,0x56,0x2,0x7f,0xbf,0x6b, + 0xd7,0xae,0xf,0xcf,0xce,0xce,0x2a,0x17,0x9a,0x2d,0xa8,0xee,0x56,0x81,0xe9,0xe9, + 0xe9,0x5e,0xdb,0xb6,0x6f,0x5,0xde,0xe,0x4d,0x7f,0x3c,0xab,0x68,0x9b,0xf3,0xe3, + 0xad,0x14,0x20,0xa7,0x28,0x42,0xd4,0x50,0x9a,0xc4,0x8b,0x43,0x4a,0x7c,0x1b,0x80, + 0x1e,0xf1,0xd0,0xf3,0xe3,0x62,0x91,0xcd,0x51,0x4e,0x6c,0xd7,0xd6,0xd6,0x58,0x5d, + 0x5d,0x25,0x12,0x89,0x38,0x1d,0x59,0x56,0x55,0xaf,0x1a,0xb7,0xe9,0x45,0x29,0xe5, + 0x1f,0x99,0xa6,0x79,0x5f,0x55,0x95,0xd8,0x41,0xa8,0x2e,0xe6,0x80,0x89,0x89,0x89, + 0x6b,0x80,0x2f,0x0,0xbb,0x9c,0xd8,0x37,0x7b,0x14,0x9c,0x73,0x29,0x2b,0xdc,0xbd, + 0xb6,0xdd,0xe8,0x37,0x3b,0x9a,0x24,0x79,0x91,0x49,0xf2,0x22,0x93,0xd4,0xf3,0xa2, + 0xca,0xd3,0xa1,0x6,0x78,0x4e,0x76,0xd0,0xf5,0x8b,0x7e,0x3a,0x1f,0x39,0x87,0xce, + 0x5f,0xef,0x42,0xa4,0x9d,0xfd,0x10,0x66,0x32,0x19,0x56,0x57,0x57,0x31,0x4d,0x93, + 0x74,0xda,0xf9,0xc2,0x67,0x93,0x7,0x4,0x77,0x65,0xb3,0xd9,0xa3,0xb1,0x58,0x6c, + 0xa5,0xaa,0x82,0x77,0x18,0x4a,0x70,0x1d,0x32,0x31,0x31,0x31,0xe,0x7c,0x1d,0x78, + 0x49,0x25,0x3b,0x37,0x8d,0x82,0x73,0xa3,0xde,0xce,0xce,0xce,0x8a,0x8b,0x6c,0x39, + 0x72,0x1d,0x5f,0x6a,0x92,0xcc,0x54,0x9c,0xe4,0xc5,0x61,0x12,0x17,0x87,0x49,0x4f, + 0xaf,0xa9,0x96,0xe2,0x0,0x2d,0x66,0xd0,0xf5,0xd3,0x7e,0xba,0x7e,0xb6,0x9b,0xce, + 0xc7,0x77,0xa1,0x87,0x2b,0x2f,0x7c,0x41,0x71,0x9c,0x83,0x50,0x28,0x44,0x34,0x1a, + 0x45,0x4a,0xd9,0xf4,0x75,0x2,0x87,0xb6,0x71,0x29,0xe5,0xfb,0x4d,0xd3,0xbc,0xd, + 0xe5,0x85,0xb0,0x2d,0xaa,0x1b,0x55,0xc1,0xcc,0xcc,0x8c,0x37,0x91,0x48,0xfc,0xa5, + 0x94,0xf2,0x83,0x40,0x91,0x7f,0x96,0x1b,0x3a,0x48,0x39,0x7b,0x8f,0xc7,0x53,0x71, + 0xca,0xa1,0xe2,0x42,0xcd,0x50,0x9a,0xd4,0x5,0x51,0xd2,0x87,0x62,0x24,0x2f,0x88, + 0x92,0xdd,0x9f,0x40,0x6a,0xaa,0x6f,0xe9,0x11,0xf,0xfe,0x27,0x7b,0xe9,0x78,0xa2, + 0x17,0xff,0xb1,0x5e,0x7c,0xbf,0xe9,0x46,0xcb,0x56,0x76,0xdb,0xcb,0x21,0x84,0x40, + 0x4a,0x49,0x2c,0x16,0x23,0x12,0x89,0x10,0x8d,0x46,0xb1,0xac,0xf5,0x90,0x2,0xcd, + 0x7e,0x42,0x72,0x6a,0x2b,0xa5,0x3c,0x6,0xbc,0xbd,0x9d,0xe3,0xd7,0xd6,0x1a,0x25, + 0xb8,0x67,0xc0,0xe4,0xe4,0xe4,0x85,0x52,0xca,0x2f,0x0,0x17,0xe7,0x8e,0xb9,0x41, + 0x6c,0x9d,0xd8,0xa,0x21,0x36,0x2d,0xb4,0x69,0x9a,0xe6,0x68,0xb1,0x2d,0x77,0x2e, + 0x80,0xdd,0x69,0x91,0x3e,0x14,0x23,0x75,0x28,0x4a,0xea,0xfc,0x18,0x99,0xa9,0x38, + 0x56,0x5f,0x7b,0x67,0xab,0x10,0x59,0x81,0x67,0xa1,0x13,0xff,0xb3,0xdd,0xf8,0x1f, + 0xef,0xc5,0xff,0x64,0xef,0xfa,0xd6,0xda,0x32,0xb1,0x66,0x2b,0x91,0x48,0x24,0x30, + 0x4d,0x93,0x68,0x34,0xda,0xb0,0x6d,0xb7,0x35,0x2e,0x7b,0xd,0xf8,0x68,0x38,0x1c, + 0xbe,0x95,0xf5,0x14,0xe6,0xa,0x87,0x28,0xc1,0x3d,0x73,0xc4,0xc4,0xc4,0xc4,0xbb, + 0xa5,0x94,0x37,0xb3,0x25,0xdc,0x63,0x25,0xdc,0x24,0xcc,0x9a,0xa6,0xe5,0x43,0x44, + 0x7a,0xbd,0xde,0x6d,0xb7,0x11,0x57,0xc2,0xee,0xb2,0xc8,0xec,0x8f,0x93,0xdd,0x9f, + 0x24,0x3d,0x16,0x27,0x7d,0xde,0x1a,0xe9,0xa9,0x35,0xa4,0xbf,0xc5,0xe6,0x82,0xe5, + 0xfa,0xee,0x2e,0xef,0x73,0xeb,0x2f,0xff,0xb3,0x3d,0xf8,0x9e,0xe9,0x46,0x5f,0xf5, + 0x96,0x3d,0x65,0xbb,0xef,0x46,0x4a,0x49,0x22,0x91,0x60,0x6d,0x6d,0x8d,0x68,0x34, + 0xda,0xf0,0xd,0xa,0xb5,0x14,0x66,0x21,0xc4,0xbf,0xdb,0xb6,0xfd,0x5e,0xd3,0x34, + 0x7f,0x5b,0x55,0xa1,0xa,0x40,0x9,0xee,0x59,0x33,0x3e,0x3e,0xbe,0x17,0xb8,0x45, + 0x8,0x71,0x75,0x25,0xbb,0x56,0x78,0x4c,0xd4,0x75,0x3d,0x2f,0xbe,0x39,0x37,0x33, + 0xa7,0xa3,0x36,0x28,0x21,0x3c,0x1e,0x49,0x76,0x28,0x45,0x76,0x38,0x75,0xfa,0x3d, + 0xf7,0xda,0x9b,0xc2,0x3a,0x27,0xdd,0x94,0x16,0x28,0x52,0x1a,0x9e,0x25,0x3f,0x9e, + 0x25,0x3f,0xc6,0x92,0xf,0x63,0x79,0xfd,0xdd,0xb3,0xf1,0xae,0x47,0x3c,0x55,0x8f, + 0xfa,0xb7,0x92,0x4c,0x26,0x89,0xc5,0x62,0xc4,0xe3,0x71,0xd6,0xd6,0xd6,0x9c,0x3c, + 0x9e,0x3b,0xae,0x7f,0x93,0xc4,0x76,0x45,0x4a,0xf9,0xbe,0x76,0x4a,0x59,0xde,0xc, + 0x94,0xe0,0xd6,0x88,0x89,0x89,0x89,0xab,0xa4,0x94,0xb7,0x2,0xe7,0x6e,0xfd,0xac, + 0x45,0x1e,0x13,0x8b,0xf0,0xf9,0x7c,0xf9,0xd7,0xd6,0xd,0x16,0x85,0x9c,0xb1,0x28, + 0x6b,0x60,0xf5,0x66,0xb0,0x7b,0xb3,0x58,0x3d,0x19,0xec,0xbe,0x2c,0x56,0x5f,0x6, + 0x7b,0x57,0x16,0xab,0x37,0x83,0xf4,0xad,0x8f,0x8e,0xed,0x4e,0xb,0x34,0x89,0x34, + 0x24,0xb6,0x7f,0x73,0xe8,0x54,0xcd,0xd6,0xd0,0x12,0xeb,0x23,0x73,0x91,0xd4,0x10, + 0x59,0xd,0xec,0xf5,0xf9,0x55,0x2d,0x62,0xa0,0x47,0x3d,0x68,0xa6,0x81,0x11,0xf1, + 0xa2,0x9b,0x9e,0x75,0x31,0x4d,0x55,0x5e,0x40,0x3c,0x13,0xb1,0xcd,0x66,0xb3,0xc4, + 0xe3,0x71,0x12,0x89,0x4,0xd1,0x68,0xd4,0xb1,0x77,0x81,0x5b,0xee,0x77,0x5,0x5b, + 0x29,0x84,0xb8,0xcd,0xb6,0xed,0x1b,0x4c,0xd3,0xc,0x39,0x2e,0x50,0x51,0x12,0x25, + 0xb8,0x35,0x64,0x74,0x74,0xb4,0xdf,0x30,0x8c,0x4f,0x1,0xd7,0xb1,0xb1,0xa8,0xd6, + 0x8a,0x62,0x5b,0xca,0x56,0x8,0x81,0xc7,0xe3,0xc1,0xeb,0xf5,0xe6,0x5,0xb8,0x52, + 0x8a,0xa0,0x52,0xe7,0x3b,0xa5,0xd6,0x65,0xd6,0xda,0x4e,0x4a,0x49,0x2a,0x95,0xca, + 0xb,0x6c,0x22,0x91,0xc8,0xef,0xfa,0x6a,0x97,0xfb,0xbd,0x71,0xfc,0x49,0x4d,0xd3, + 0x3e,0xa0,0xb6,0xe6,0xd6,0xe,0x25,0xb8,0x75,0x60,0x72,0x72,0xf2,0x3c,0xdb,0xb6, + 0xff,0x4a,0x4a,0x79,0x8d,0xd3,0x73,0x5a,0xad,0xa3,0xa,0x21,0xd0,0x75,0x1d,0xaf, + 0xd7,0x8b,0xc7,0xe3,0xc9,0x8b,0x71,0xa9,0x79,0xe0,0x56,0x16,0xe5,0x9c,0xb8,0x16, + 0xbe,0x92,0xc9,0x64,0xde,0xa3,0x60,0xab,0xad,0x53,0x5c,0x7e,0xbf,0x97,0x80,0x3f, + 0xb,0x87,0xc3,0x5f,0x7,0x5a,0x6c,0x12,0xde,0xdd,0x28,0xc1,0xad,0x23,0x63,0x63, + 0x63,0x57,0x68,0x9a,0xf6,0x59,0x29,0xe5,0x85,0x95,0xec,0xda,0xa8,0xa3,0xa2,0x69, + 0x5a,0x5e,0x84,0xd,0xc3,0xc8,0xbf,0x1b,0x86,0x51,0x51,0xfc,0x9a,0x2d,0xca,0xd9, + 0x6c,0x96,0x4c,0x26,0x93,0x7f,0x25,0x93,0x49,0x52,0xa9,0x14,0x99,0x4c,0xa6,0xe6, + 0x3b,0xbc,0xdc,0x60,0x5b,0xc6,0x3e,0x25,0x84,0xf8,0x3b,0x29,0xe5,0xa7,0xc3,0xe1, + 0x70,0xb8,0xaa,0xc2,0x14,0x8e,0x50,0x82,0x5b,0x7f,0x8c,0xb1,0xb1,0xb1,0xa3,0x42, + 0x88,0x4f,0x1,0x83,0x5b,0x3f,0x74,0x43,0xe7,0x6b,0x94,0x30,0x1b,0x86,0x81,0xae, + 0xeb,0x79,0x21,0xd6,0x34,0xd,0x5d,0xd7,0xf3,0x2f,0x4d,0xd3,0xf2,0xaf,0x52,0x54, + 0x2b,0xca,0x52,0x4a,0x6c,0xdb,0xc6,0xb2,0xac,0xfc,0xcb,0xb6,0x6d,0xb2,0xd9,0x6c, + 0x91,0xc0,0x16,0xd6,0xd3,0x8d,0xdf,0x5d,0xbd,0x6d,0x85,0x10,0xb7,0x5b,0x96,0xf5, + 0xd1,0x48,0x24,0xf2,0x1b,0xc7,0x5,0x29,0xaa,0x46,0x9,0x6e,0x83,0xd8,0xbf,0x7f, + 0xff,0x1e,0xdb,0xb6,0x3f,0x21,0x84,0x38,0xa,0x78,0xda,0xa5,0xa3,0xd6,0xa3,0x6c, + 0x21,0xc4,0x26,0xe1,0xcd,0xbd,0xe7,0x8e,0x6f,0x15,0xc7,0x5c,0x30,0x97,0xc2,0xdd, + 0x59,0x39,0x71,0x3d,0x9b,0x7a,0x34,0xcb,0xb6,0xc1,0xf5,0x78,0x2,0xb8,0x31,0x1c, + 0xe,0xdf,0xe9,0xb8,0x10,0xc5,0x19,0xa3,0x4,0xb7,0xc1,0xec,0xdb,0xb7,0x6f,0x54, + 0xd7,0xf5,0xf,0x1,0xd7,0x3,0xa5,0xb3,0xff,0x15,0xe0,0xe2,0x8e,0x5a,0x13,0x5b, + 0x55,0x8f,0x33,0xb7,0x3d,0xcb,0xb2,0x7f,0x29,0x84,0xf8,0x58,0x28,0x14,0xba,0xb, + 0xb5,0x25,0xb7,0x61,0x28,0xc1,0x6d,0x12,0x93,0x93,0x93,0x63,0xd9,0x6c,0xf6,0xa3, + 0xc0,0x51,0xa0,0x64,0x92,0x2a,0x97,0x76,0xd4,0xb6,0xab,0xc7,0xe,0xab,0xf3,0xd3, + 0x52,0xca,0x1b,0x4d,0xd3,0xfc,0x36,0x6a,0x41,0xac,0xe1,0x28,0xc1,0x6d,0x32,0xe3, + 0xe3,0xe3,0x13,0x52,0xca,0x1b,0x80,0x77,0x51,0x10,0x9f,0xc1,0x85,0x1d,0x75,0xc7, + 0xd7,0xa3,0x15,0xeb,0x5c,0x60,0xff,0xac,0x94,0xf2,0xcf,0x95,0xd0,0x36,0x17,0x25, + 0xb8,0x2e,0x61,0x6c,0x6c,0xec,0x8,0x70,0x3,0xf0,0x6,0x29,0xa5,0xb3,0x8,0x28, + 0xb4,0xbf,0x60,0xa8,0x3a,0x9f,0xb5,0xed,0x2c,0xf0,0xd9,0xee,0xee,0xee,0xdb,0x16, + 0x16,0x16,0xca,0xe7,0xe2,0x51,0x34,0x4,0x25,0xb8,0x2e,0x63,0x63,0x71,0xed,0x4f, + 0xa4,0x94,0x7f,0xca,0x36,0xf1,0x77,0x77,0x88,0x60,0xd4,0xdc,0x76,0x87,0xd4,0xe3, + 0x41,0x21,0xc4,0x67,0x42,0xa1,0xd0,0xdd,0xa8,0x11,0xad,0x6b,0x50,0x82,0xeb,0x52, + 0x6,0x6,0x6,0x7a,0x3a,0x3b,0x3b,0x8f,0xca,0xf5,0x50,0x90,0xd,0xdb,0x2e,0xdc, + 0xa2,0xe2,0x52,0x17,0xdb,0x16,0xac,0x87,0x5,0x7c,0xc3,0xb6,0xed,0xcf,0x99,0xa6, + 0xf9,0x48,0x55,0x17,0x50,0x34,0x4,0x25,0xb8,0x2e,0x67,0x74,0x74,0xb4,0x43,0x8, + 0x71,0x2d,0xf0,0x7e,0xe0,0xbc,0x56,0x14,0x8c,0x56,0xac,0xb3,0x5b,0xea,0xe1,0xd0, + 0x36,0xd,0x7c,0xb,0xb8,0x39,0x14,0xa,0x3d,0xe6,0xb8,0x70,0x45,0xc3,0x51,0x82, + 0xdb,0x42,0x8c,0x8d,0x8d,0x1d,0xb1,0x6d,0xfb,0x3a,0xe0,0xf,0x81,0x9e,0x4a,0xb6, + 0x6d,0x2c,0x2e,0xaa,0x1e,0xa7,0x79,0x50,0x8,0xf1,0xcf,0xc0,0x37,0x57,0x57,0x57, + 0x23,0x8e,0xb,0x56,0x34,0xd,0x25,0xb8,0x2d,0xc8,0xfe,0xfd,0xfb,0xfd,0x99,0x4c, + 0xe6,0x2a,0x4d,0xd3,0xae,0x93,0x52,0x5e,0xc1,0x96,0xfb,0xd8,0xa6,0xe2,0xe2,0xba, + 0x7a,0x34,0xa9,0xce,0x2b,0xc0,0x97,0x35,0x4d,0xfb,0xaa,0x4a,0x41,0xde,0x7a,0x28, + 0xc1,0x6d,0x71,0x46,0x46,0x46,0x7e,0x57,0xd3,0xb4,0xa3,0xc0,0xdb,0x80,0x73,0xda, + 0x4c,0x5c,0xda,0xa2,0x1e,0x35,0xa8,0xb3,0x4,0x1e,0x94,0x52,0x7e,0xc9,0xe7,0xf3, + 0xdd,0xbe,0xb4,0xb4,0xb4,0x56,0x55,0x81,0xa,0xd7,0xa0,0x4,0xb7,0x7d,0xd0,0x46, + 0x46,0x46,0x2e,0x1,0xae,0x11,0x42,0xbc,0x19,0x18,0xae,0x64,0xac,0x44,0xce,0x7d, + 0xf5,0xd8,0x62,0x9b,0x5,0x7e,0x20,0xa5,0xbc,0xdd,0xb2,0xac,0xbb,0xa3,0xd1,0x68, + 0xd0,0x71,0x41,0xa,0xd7,0xa2,0x4,0xb7,0x3d,0xd1,0x47,0x46,0x46,0x5e,0xc4,0xba, + 0xf8,0xbe,0x5,0x18,0x2a,0xfc,0xd0,0xd,0xe2,0xe2,0x96,0x7a,0xb8,0xac,0xce,0x12, + 0x78,0x48,0x4a,0x79,0xbb,0xae,0xeb,0xff,0x16,0xc,0x6,0x4f,0x54,0x55,0x39,0x85, + 0xeb,0x51,0x82,0xdb,0xe6,0x8c,0x8e,0x8e,0x76,0x0,0xaf,0x6,0xae,0x96,0x52,0x5e, + 0x29,0xa5,0xec,0x77,0x7a,0xee,0xe,0x11,0xb9,0x9a,0xdb,0x56,0x69,0x6f,0x3,0xbf, + 0x90,0x52,0x7e,0xc7,0xb2,0xac,0x6f,0xa9,0x68,0x5d,0xed,0x8d,0x12,0xdc,0x1d,0xc6, + 0x9e,0x3d,0x7b,0x66,0x34,0x4d,0x7b,0x2d,0xf0,0x72,0xe0,0x32,0x1a,0x1c,0xc7,0xc1, + 0x25,0x22,0xd7,0x6c,0xdb,0x93,0xc0,0x5d,0x52,0xca,0xbb,0xc,0xc3,0xf8,0xe1,0xca, + 0xca,0x4a,0xcc,0xf1,0x5,0x14,0x2d,0x8d,0x12,0xdc,0x1d,0xcc,0xbe,0x7d,0xfb,0x76, + 0x3,0x97,0x3,0x2f,0x97,0x52,0xbe,0xe,0xd8,0xd3,0xc6,0x22,0xd7,0xcc,0x7a,0xd8, + 0xc0,0xc3,0x52,0xca,0xef,0xeb,0xba,0x7e,0x7f,0x20,0x10,0x78,0x14,0xb5,0xfb,0x6b, + 0x47,0xa2,0x4,0x57,0x1,0xc0,0x91,0x23,0x47,0x3c,0xb,0xb,0xb,0x47,0x34,0x4d, + 0xbb,0x4,0x78,0x31,0x70,0x9,0xb0,0xa7,0x9c,0x7d,0xb,0x88,0xdc,0x59,0xd9,0x9e, + 0x65,0xd9,0x19,0xe0,0x17,0xc0,0xc3,0xc0,0x83,0x9a,0xa6,0x3d,0x18,0x8,0x4,0x16, + 0xab,0xba,0xb8,0xa2,0x2d,0x51,0x82,0xab,0x28,0xcb,0xd0,0xd0,0xd0,0x94,0xae,0xeb, + 0x97,0x0,0x97,0x8,0x21,0x5e,0x2c,0xa5,0x9c,0x1,0x34,0x97,0x8a,0x5c,0x33,0xeb, + 0xb1,0xa,0x3c,0x2c,0x84,0x78,0xc8,0xb2,0xac,0x7,0x3a,0x3b,0x3b,0x7f,0x7e,0xf2, + 0xe4,0xc9,0x78,0x55,0x17,0x54,0xec,0x8,0x94,0xe0,0x2a,0xaa,0xc1,0xd8,0xb3,0x67, + 0xcf,0x41,0xe0,0x10,0x30,0x3,0x1c,0xd9,0xf8,0x7b,0x82,0x12,0x6d,0xa9,0x15,0xc5, + 0x76,0x1b,0xdb,0xb8,0x10,0xe2,0x51,0xdb,0xb6,0x1f,0x7,0x9e,0x90,0x52,0x3e,0x62, + 0xdb,0xf6,0xe3,0x2a,0x7d,0xb8,0xc2,0x29,0x4a,0x70,0x15,0x67,0xcd,0xe8,0xe8,0xe8, + 0x3e,0xcb,0xb2,0x2e,0x94,0x52,0x1e,0x96,0x52,0x4e,0xa,0x21,0xc6,0xa5,0x94,0xe3, + 0xc0,0x7e,0xa0,0x63,0xbb,0xf3,0x5d,0x26,0xcc,0x12,0x38,0x5,0xcc,0x4a,0x29,0xe7, + 0x84,0x10,0x73,0xc0,0x31,0x4d,0xd3,0x1e,0xeb,0xeb,0xeb,0x7b,0xe2,0x99,0x67,0x9e, + 0x49,0x55,0x55,0x59,0x85,0xa2,0x0,0x25,0xb8,0x8a,0xba,0x32,0x3c,0x3c,0x3c,0x24, + 0x84,0x18,0x7,0xc6,0x6d,0xdb,0x1e,0xdf,0xf8,0x7b,0x80,0xf5,0x8d,0x19,0x83,0x52, + 0xca,0x1,0xd6,0x93,0x6b,0x96,0xf4,0x96,0x28,0xa4,0x6,0xc2,0x1c,0x5,0x96,0x84, + 0x10,0x2b,0x52,0xca,0x80,0x94,0x72,0x45,0x8,0x71,0x42,0x8,0x31,0x67,0xdb,0xf6, + 0x9c,0xa6,0x69,0x73,0x7d,0x7d,0x7d,0xcf,0x29,0x51,0x55,0xd4,0x8b,0xff,0x7,0x9a, + 0x30,0x30,0x1,0x6,0x91,0xaa,0xbc,0x0,0x0,0x0,0x0,0x49,0x45,0x4e,0x44,0xae, + 0x42,0x60,0x82, + +}; + +static const unsigned char qt_resource_name[] = { + // images + 0x0,0x6, + 0x7,0x3,0x7d,0xc3, + 0x0,0x69, + 0x0,0x6d,0x0,0x61,0x0,0x67,0x0,0x65,0x0,0x73, + // Red.png + 0x0,0x7, + 0x8,0xb7,0x57,0xe7, + 0x0,0x52, + 0x0,0x65,0x0,0x64,0x0,0x2e,0x0,0x70,0x0,0x6e,0x0,0x67, + // Black.png + 0x0,0x9, + 0x7,0x9e,0xc5,0x7, + 0x0,0x42, + 0x0,0x6c,0x0,0x61,0x0,0x63,0x0,0x6b,0x0,0x2e,0x0,0x70,0x0,0x6e,0x0,0x67, + // Green.png + 0x0,0x9, + 0xb,0xc1,0xca,0x47, + 0x0,0x47, + 0x0,0x72,0x0,0x65,0x0,0x65,0x0,0x6e,0x0,0x2e,0x0,0x70,0x0,0x6e,0x0,0x67, + +}; + +static const unsigned char qt_resource_struct[] = { + // : + 0x0,0x0,0x0,0x0,0x0,0x2,0x0,0x0,0x0,0x1,0x0,0x0,0x0,0x1, +0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0, + // :/images + 0x0,0x0,0x0,0x0,0x0,0x2,0x0,0x0,0x0,0x3,0x0,0x0,0x0,0x2, +0x0,0x0,0x0,0x0,0x0,0x0,0x0,0x0, + // :/images/Black.png + 0x0,0x0,0x0,0x26,0x0,0x0,0x0,0x0,0x0,0x1,0x0,0x0,0x64,0x85, +0x0,0x0,0x1,0x83,0x89,0xee,0xdd,0xbf, + // :/images/Red.png + 0x0,0x0,0x0,0x12,0x0,0x0,0x0,0x0,0x0,0x1,0x0,0x0,0x0,0x0, +0x0,0x0,0x1,0x83,0x89,0xee,0xdd,0xdd, + // :/images/Green.png + 0x0,0x0,0x0,0x3e,0x0,0x0,0x0,0x0,0x0,0x1,0x0,0x0,0xe8,0x49, +0x0,0x0,0x1,0x83,0x89,0xee,0xdd,0xce, + +}; + +#ifdef QT_NAMESPACE +# define QT_RCC_PREPEND_NAMESPACE(name) ::QT_NAMESPACE::name +# define QT_RCC_MANGLE_NAMESPACE0(x) x +# define QT_RCC_MANGLE_NAMESPACE1(a, b) a##_##b +# define QT_RCC_MANGLE_NAMESPACE2(a, b) QT_RCC_MANGLE_NAMESPACE1(a,b) +# define QT_RCC_MANGLE_NAMESPACE(name) QT_RCC_MANGLE_NAMESPACE2( \ + QT_RCC_MANGLE_NAMESPACE0(name), QT_RCC_MANGLE_NAMESPACE0(QT_NAMESPACE)) +#else +# define QT_RCC_PREPEND_NAMESPACE(name) name +# define QT_RCC_MANGLE_NAMESPACE(name) name +#endif + +#ifdef QT_NAMESPACE +namespace QT_NAMESPACE { +#endif + +bool qRegisterResourceData(int, const unsigned char *, const unsigned char *, const unsigned char *); +bool qUnregisterResourceData(int, const unsigned char *, const unsigned char *, const unsigned char *); + +#ifdef QT_NAMESPACE +} +#endif + +int QT_RCC_MANGLE_NAMESPACE(qInitResources_QtGPIO)(); +int QT_RCC_MANGLE_NAMESPACE(qInitResources_QtGPIO)() +{ + int version = 3; + QT_RCC_PREPEND_NAMESPACE(qRegisterResourceData) + (version, qt_resource_struct, qt_resource_name, qt_resource_data); + return 1; +} + +int QT_RCC_MANGLE_NAMESPACE(qCleanupResources_QtGPIO)(); +int QT_RCC_MANGLE_NAMESPACE(qCleanupResources_QtGPIO)() +{ + int version = 3; + QT_RCC_PREPEND_NAMESPACE(qUnregisterResourceData) + (version, qt_resource_struct, qt_resource_name, qt_resource_data); + return 1; +} + +namespace { + struct initializer { + initializer() { QT_RCC_MANGLE_NAMESPACE(qInitResources_QtGPIO)(); } + ~initializer() { QT_RCC_MANGLE_NAMESPACE(qCleanupResources_QtGPIO)(); } + } dummy; +} diff --git a/sigslot/.gitignore b/sigslot/.gitignore new file mode 100644 index 0000000..eb787d4 --- /dev/null +++ b/sigslot/.gitignore @@ -0,0 +1,12 @@ +# Allow in source build +[Bb]uild*/ +# Ignore qt creator generated CMakeLists.txt.users +*.users +# Ignore CLion project files +*.idea +# Ignore CLion default generated build folder +cmake-build*/ +# For macOs users +.DS_Store +# Ignore sublime merge file that can be created on merge fail +Sublimerge* diff --git a/sigslot/LICENSE b/sigslot/LICENSE new file mode 100644 index 0000000..c4745db --- /dev/null +++ b/sigslot/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2017 Pierre-Antoine Lacaze + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/sigslot/include/sigslot/adapter/boost.hpp b/sigslot/include/sigslot/adapter/boost.hpp new file mode 100644 index 0000000..af3182f --- /dev/null +++ b/sigslot/include/sigslot/adapter/boost.hpp @@ -0,0 +1,22 @@ +#pragma once +#include +#include + +/** + * Bring ADL conversion for boost smart pointers + */ + +namespace boost { + +template +weak_ptr to_weak(shared_ptr p) { + return {p}; +} + +template +weak_ptr to_weak(weak_ptr p) { + return p; +} + +} // namespace boost + diff --git a/sigslot/include/sigslot/adapter/qt.hpp b/sigslot/include/sigslot/adapter/qt.hpp new file mode 100644 index 0000000..7ac4870 --- /dev/null +++ b/sigslot/include/sigslot/adapter/qt.hpp @@ -0,0 +1,88 @@ +#pragma once +#include +#include +#include +#include +#include + +/** + * Definition of a few adapters that allow object life tracking for QObject, + * QWeakPointer and QSharedPointer objects, when connected to signals. + */ + +namespace sigslot { +namespace detail { + +// a weak pointer adater to allow QObject life tracking +template +struct qpointer_adater { + qpointer_adater(T *o) noexcept + : m_ptr{o} + {} + + void reset() noexcept { + m_ptr.clear(); + } + + bool expired() const noexcept { + return m_ptr.isNull(); + } + + // Warning: very unsafe because QPointer does not provide weak pointer semantics + // In a multithreaded context, m_ptr may very well be destroyed in the lapse of + // time between expired() and data() (and also while data() is being used). + T* lock() const noexcept { + return expired() ? nullptr : m_ptr.data(); + } + +private: + QPointer m_ptr; +}; + +// a wrapper that exposes the right concepts for QWeakPointer +template +struct qweakpointer_adater { + qweakpointer_adater(QWeakPointer o) noexcept + : m_ptr{std::move(o)} + {} + + void reset() noexcept { + m_ptr.clear(); + } + + bool expired() const noexcept { + return m_ptr.isNull(); + } + + QSharedPointer lock() const noexcept { + return m_ptr.lock(); + } + +private: + QWeakPointer m_ptr; +}; + +} // namespace detail +} // namespace sigslot + + +QT_BEGIN_NAMESPACE + +template +std::enable_if_t::value, sigslot::detail::qpointer_adater> +to_weak(T *p) { + return {p}; +} + +template +sigslot::detail::qweakpointer_adater to_weak(QWeakPointer p) { + return {p}; +} + +template +sigslot::detail::qweakpointer_adater to_weak(QSharedPointer p) { + return {p}; +} + +QT_END_NAMESPACE + diff --git a/sigslot/include/sigslot/signal.hpp b/sigslot/include/sigslot/signal.hpp new file mode 100644 index 0000000..5e27ffe --- /dev/null +++ b/sigslot/include/sigslot/signal.hpp @@ -0,0 +1,1631 @@ +#pragma once +#include +#include +#include +#include +#include +#include +#include +#include + +#if defined(__GXX_RTTI) || defined(__cpp_rtti) || defined(_CPPRTTI) +#define SIGSLOT_RTTI_ENABLED 1 +#include +#endif + +namespace sigslot { + +namespace detail { + +// Used to detect an object of observer type +struct observer_type {}; + +} // namespace detail + +namespace trait { + +/// represent a list of types +template struct typelist {}; + +/** + * Pointers that can be converted to a weak pointer concept for tracking + * purpose must implement the to_weak() function in order to make use of + * ADL to convert that type and make it usable + */ + +template +std::weak_ptr to_weak(std::weak_ptr w) { + return w; +} + +template +std::weak_ptr to_weak(std::shared_ptr s) { + return s; +} + +// tools +namespace detail { + +template +struct voider { using type = void; }; + +// void_t from c++17 +template +using void_t = typename detail::voider::type; + +template +struct has_call_operator : std::false_type {}; + +template +struct has_call_operator::type::operator())>> + : std::true_type {}; + +template +struct is_callable : std::false_type {}; + +template +struct is_callable, + void_t()).*std::declval())(std::declval()...))>> + : std::true_type {}; + +template +struct is_callable, + void_t()(std::declval()...))>> + : std::true_type {}; + + +template +struct is_weak_ptr : std::false_type {}; + +template +struct is_weak_ptr().expired()), + decltype(std::declval().lock()), + decltype(std::declval().reset())>> + : std::true_type {}; + +template +struct is_weak_ptr_compatible : std::false_type {}; + +template +struct is_weak_ptr_compatible()))>> + : is_weak_ptr()))> {}; + +} // namespace detail + +static constexpr bool with_rtti = +#ifdef SIGSLOT_RTTI_ENABLED + true; +#else + false; +#endif + +/// determine if a pointer is convertible into a "weak" pointer +template +constexpr bool is_weak_ptr_compatible_v = detail::is_weak_ptr_compatible>::value; + +/// determine if a type T (Callable or Pmf) is callable with supplied arguments +template +constexpr bool is_callable_v = detail::is_callable::value; + +template +constexpr bool is_weak_ptr_v = detail::is_weak_ptr::value; + +template +constexpr bool has_call_operator_v = detail::has_call_operator::value; + +template +constexpr bool is_pointer_v = std::is_pointer::value; + +template +constexpr bool is_func_v = std::is_function::value; + +template +constexpr bool is_pmf_v = std::is_member_function_pointer::value; + +template +constexpr bool is_observer_v = std::is_base_of<::sigslot::detail::observer_type, + std::remove_pointer_t>>::value; + +} // namespace trait + +template +class signal_base; + +/** + * A group_id is used to identify a group of slots + */ +using group_id = std::int32_t; + +namespace detail { + +/** + * The following function_traits and object_pointer series of templates are + * used to circumvent the type-erasing that takes place in the slot_base + * implementations. They are used to compare the stored functions and objects + * with another one for disconnection purpose. + */ + +/* + * Function pointers and member function pointers size differ from compiler to + * compiler, and for virtual members compared to non virtual members. On some + * compilers, multiple inheritance has an impact too. Hence, we form an union + * big enough to store any kind of function pointer. + */ +namespace mock { + +struct a { virtual ~a() = default; void f(); virtual void g(); static void h(); }; +struct b { virtual ~b() = default; void f(); virtual void g(); }; +struct c : a, b { void f(); void g() override; }; +struct d : virtual a { void g() override; }; + +union fun_types { + decltype(&d::g) dm; + decltype(&c::g) mm; + decltype(&c::g) mvm; + decltype(&a::f) m; + decltype(&a::g) vm; + decltype(&a::h) s; + void (*f)(); + void *o; + }; + +} // namespace mock + +/* + * This struct is used to store function pointers. + * This is needed for slot disconnection by function pointer. + * It assumes the underlying implementation to be trivially copiable. + */ +struct func_ptr { + func_ptr() + : sz{0} + { + std::uninitialized_fill(std::begin(data), std::end(data), '\0'); + } + + template + void store(const T &t) { + const auto *b = reinterpret_cast(&t); + sz = sizeof(T); + std::memcpy(data, b, sz); + } + + template + const T* as() const { + if (sizeof(T) != sz) { + return nullptr; + } + return reinterpret_cast(data); + } + +private: + alignas(sizeof(mock::fun_types)) char data[sizeof(mock::fun_types)]; + size_t sz; +}; + + +template +struct function_traits { + static void ptr(const T &/*t*/, func_ptr &/*d*/) { + } + + static bool eq(const T &/*t*/, const func_ptr &/*d*/) { + return false; + } + + static constexpr bool is_disconnectable = false; + static constexpr bool must_check_object = true; +}; + +template +struct function_traits>> { + static void ptr(T &t, func_ptr &d) { + d.store(&t); + } + + static bool eq(T &t, const func_ptr &d) { + const auto *r = d.as(); + return r && *r == &t; + } + + static constexpr bool is_disconnectable = true; + static constexpr bool must_check_object = false; +}; + +template +struct function_traits>> { + static void ptr(T *t, func_ptr &d) { + function_traits::ptr(*t, d); + } + + static bool eq(T *t, const func_ptr &d) { + return function_traits::eq(*t, d); + } + + static constexpr bool is_disconnectable = true; + static constexpr bool must_check_object = false; +}; + +template +struct function_traits>> { + static void ptr(T t, func_ptr &d) { + d.store(t); + } + + static bool eq(T t, const func_ptr &d) { + const auto *r = d.as(); + return r && *r == t; + } + + static constexpr bool is_disconnectable = trait::with_rtti; + static constexpr bool must_check_object = true; +}; + +// for function objects, the assumption is that we are looking for the call operator +template +struct function_traits>> { + using call_type = decltype(&std::remove_reference::type::operator()); + + static void ptr(const T &/*t*/, func_ptr &d) { + function_traits::ptr(&T::operator(), d); + } + + static bool eq(const T &/*t*/, const func_ptr &d) { + return function_traits::eq(&T::operator(), d); + } + + static constexpr bool is_disconnectable = function_traits::is_disconnectable; + static constexpr bool must_check_object = function_traits::must_check_object; +}; + +template +func_ptr get_function_ptr(const T &t) { + func_ptr d; + function_traits>::ptr(t, d); + return d; +} + +template +bool eq_function_ptr(const T& t, const func_ptr &d) { + return function_traits>::eq(t, d); +} + +/* + * obj_ptr is used to store a pointer to an object. + * The object_pointer traits are needed to handle trackable objects correctly, + * as they are likely to not be pointers. + */ +using obj_ptr = const void*; + +template +obj_ptr get_object_ptr(const T &t); + +template +struct object_pointer { + static obj_ptr get(const T&) { + return nullptr; + } +}; + +template +struct object_pointer>> { + static obj_ptr get(const T *t) { + return reinterpret_cast(t); + } +}; + +template +struct object_pointer>> { + static obj_ptr get(const T &t) { + auto p = t.lock(); + return get_object_ptr(p); + } +}; + +template +struct object_pointer && + !trait::is_weak_ptr_v && + trait::is_weak_ptr_compatible_v>> +{ + static obj_ptr get(const T &t) { + return t ? reinterpret_cast(t.get()) : nullptr; + } +}; + +template +obj_ptr get_object_ptr(const T &t) { + return object_pointer::get(t); +} + + +// noop mutex for thread-unsafe use +struct null_mutex { + null_mutex() noexcept = default; + ~null_mutex() noexcept = default; + null_mutex(const null_mutex &) = delete; + null_mutex& operator=(const null_mutex &) = delete; + null_mutex(null_mutex &&) = delete; + null_mutex& operator=(null_mutex &&) = delete; + + inline bool try_lock() noexcept { return true; } + inline void lock() noexcept {} + inline void unlock() noexcept {} +}; + +/** + * A spin mutex that yields, mostly for use in benchmarks and scenarii that invoke + * slots at a very high pace. + * One should almost always prefer a standard mutex over this. + */ +struct spin_mutex { + spin_mutex() noexcept = default; + ~spin_mutex() noexcept = default; + spin_mutex(spin_mutex const&) = delete; + spin_mutex& operator=(const spin_mutex &) = delete; + spin_mutex(spin_mutex &&) = delete; + spin_mutex& operator=(spin_mutex &&) = delete; + + void lock() noexcept { + while (true) { + while (!state.load(std::memory_order_relaxed)) { + std::this_thread::yield(); + } + + if (try_lock()) { + break; + } + } + } + + bool try_lock() noexcept { + return state.exchange(false, std::memory_order_acquire); + } + + void unlock() noexcept { + state.store(true, std::memory_order_release); + } + +private: + std::atomic state {true}; +}; + +/** + * A simple copy on write container that will be used to improve slot lists + * access efficiency in a multithreaded context. + */ +template +class copy_on_write { + struct payload { + payload() = default; + + template + explicit payload(Args && ...args) + : value(std::forward(args)...) + {} + + std::atomic count{1}; + T value; + }; + +public: + using element_type = T; + + copy_on_write() + : m_data(new payload) + {} + + template + explicit copy_on_write(U && x, std::enable_if_t, + copy_on_write>::value>* = nullptr) + : m_data(new payload(std::forward(x))) + {} + + copy_on_write(const copy_on_write &x) noexcept + : m_data(x.m_data) + { + ++m_data->count; + } + + copy_on_write(copy_on_write && x) noexcept + : m_data(x.m_data) + { + x.m_data = nullptr; + } + + ~copy_on_write() { + if (m_data && (--m_data->count == 0)) { + delete m_data; + } + } + + copy_on_write& operator=(const copy_on_write &x) noexcept { + if (&x != this) { + *this = copy_on_write(x); + } + return *this; + } + + copy_on_write& operator=(copy_on_write && x) noexcept { + auto tmp = std::move(x); + swap(*this, tmp); + return *this; + } + + element_type& write() { + if (!unique()) { + *this = copy_on_write(read()); + } + return m_data->value; + } + + const element_type& read() const noexcept { + return m_data->value; + } + + friend inline void swap(copy_on_write &x, copy_on_write &y) noexcept { + using std::swap; + swap(x.m_data, y.m_data); + } + +private: + bool unique() const noexcept { + return m_data->count == 1; + } + +private: + payload *m_data; +}; + +/** + * Specializations for thread-safe code path + */ +template +const T& cow_read(const T &v) { + return v; +} + +template +const T& cow_read(copy_on_write &v) { + return v.read(); +} + +template +T& cow_write(T &v) { + return v; +} + +template +T& cow_write(copy_on_write &v) { + return v.write(); +} + +/** + * std::make_shared instantiates a lot a templates, and makes both compilation time + * and executable size far bigger than they need to be. We offer a make_shared + * equivalent that will avoid most instantiations with the following tradeoffs: + * - Not exception safe, + * - Allocates a separate control block, and will thus make the code slower. + */ +#ifdef SIGSLOT_REDUCE_COMPILE_TIME +template +inline std::shared_ptr make_shared(Arg && ... arg) { + return std::shared_ptr(static_cast(new D(std::forward(arg)...))); +} +#else +template +inline std::shared_ptr make_shared(Arg && ... arg) { + return std::static_pointer_cast(std::make_shared(std::forward(arg)...)); +} +#endif + +/* slot_state holds slot type independent state, to be used to interact with + * slots indirectly through connection and scoped_connection objects. + */ +class slot_state { +public: + constexpr slot_state(group_id gid) noexcept + : m_index(0) + , m_group(gid) + , m_connected(true) + , m_blocked(false) + {} + + virtual ~slot_state() = default; + + virtual bool connected() const noexcept { return m_connected; } + + bool disconnect() noexcept { + bool ret = m_connected.exchange(false); + if (ret) { + do_disconnect(); + } + return ret; + } + + bool blocked() const noexcept { return m_blocked.load(); } + void block() noexcept { m_blocked.store(true); } + void unblock() noexcept { m_blocked.store(false); } + +protected: + virtual void do_disconnect() {} + + auto index() const { + return m_index; + } + + auto& index() { + return m_index; + } + + group_id group() const { + return m_group; + } + +private: + template + friend class ::sigslot::signal_base; + + std::size_t m_index; // index into the array of slot pointers inside the signal + const group_id m_group; // slot group this slot belongs to + std::atomic m_connected; + std::atomic m_blocked; +}; + +} // namespace detail + +/** + * connection_blocker is a RAII object that blocks a connection until destruction + */ +class connection_blocker { +public: + connection_blocker() = default; + ~connection_blocker() noexcept { release(); } + + connection_blocker(const connection_blocker &) = delete; + connection_blocker & operator=(const connection_blocker &) = delete; + + connection_blocker(connection_blocker && o) noexcept + : m_state{std::move(o.m_state)} + {} + + connection_blocker & operator=(connection_blocker && o) noexcept { + release(); + m_state.swap(o.m_state); + return *this; + } + +private: + friend class connection; + explicit connection_blocker(std::weak_ptr s) noexcept + : m_state{std::move(s)} + { + if (auto d = m_state.lock()) { + d->block(); + } + } + + void release() noexcept { + if (auto d = m_state.lock()) { + d->unblock(); + } + } + +private: + std::weak_ptr m_state; +}; + + +/** + * A connection object allows interaction with an ongoing slot connection + * + * It allows common actions such as connection blocking and disconnection. + * Note that connection is not a RAII object, one does not need to hold one + * such object to keep the signal-slot connection alive. + */ +class connection { +public: + connection() = default; + virtual ~connection() = default; + + connection(const connection &) noexcept = default; + connection & operator=(const connection &) noexcept = default; + connection(connection &&) noexcept = default; + connection & operator=(connection &&) noexcept = default; + + bool valid() const noexcept { + return !m_state.expired(); + } + + bool connected() const noexcept { + const auto d = m_state.lock(); + return d && d->connected(); + } + + bool disconnect() noexcept { + auto d = m_state.lock(); + return d && d->disconnect(); + } + + bool blocked() const noexcept { + const auto d = m_state.lock(); + return d && d->blocked(); + } + + void block() noexcept { + if (auto d = m_state.lock()) { + d->block(); + } + } + + void unblock() noexcept { + if (auto d = m_state.lock()) { + d->unblock(); + } + } + + connection_blocker blocker() const noexcept { + return connection_blocker{m_state}; + } + +protected: + template friend class signal_base; + explicit connection(std::weak_ptr s) noexcept + : m_state{std::move(s)} + {} + +protected: + std::weak_ptr m_state; +}; + +/** + * scoped_connection is a RAII version of connection + * It disconnects the slot from the signal upon destruction. + */ +class scoped_connection final : public connection { +public: + scoped_connection() = default; + ~scoped_connection() override { + disconnect(); + } + + /*implicit*/ scoped_connection(const connection &c) noexcept : connection(c) {} + /*implicit*/ scoped_connection(connection &&c) noexcept : connection(std::move(c)) {} + + scoped_connection(const scoped_connection &) noexcept = delete; + scoped_connection & operator=(const scoped_connection &) noexcept = delete; + + scoped_connection(scoped_connection && o) noexcept + : connection{std::move(o.m_state)} + {} + + scoped_connection & operator=(scoped_connection && o) noexcept { + disconnect(); + m_state.swap(o.m_state); + return *this; + } + +private: + template friend class signal_base; + explicit scoped_connection(std::weak_ptr s) noexcept + : connection{std::move(s)} + {} +}; + +/** + * Observer is a base class for intrusive lifetime tracking of objects. + * + * This is an alternative to trackable pointers, such as std::shared_ptr, + * and manual connection management by keeping connection objects in scope. + * Deriving from this class allows automatic disconnection of all the slots + * connected to any signal when an instance is destroyed. + */ +template +struct observer_base : private detail::observer_type { + virtual ~observer_base() = default; + +protected: + /** + * Disconnect all signals connected to this object. + * + * To avoid invocation of slots on a semi-destructed instance, which may happen + * in multi-threaded contexts, derived classes should call this method in their + * destructor. This will ensure proper disconnection prior to the destruction. + */ + void disconnect_all() { + std::unique_lock _{m_mutex}; + m_connections.clear(); + } + +private: + template + friend class signal_base; + + void add_connection(connection conn) { + std::unique_lock _{m_mutex}; + m_connections.emplace_back(std::move(conn)); + } + + Lockable m_mutex; + std::vector m_connections; +}; + +/** + * Specialization of observer_base to be used in single threaded contexts. + */ +using observer_st = observer_base; + +/** + * Specialization of observer_base to be used in multi-threaded contexts. + */ +using observer = observer_base; + + +namespace detail { + +// interface for cleanable objects, used to cleanup disconnected slots +struct cleanable { + virtual ~cleanable() = default; + virtual void clean(slot_state *) = 0; +}; + +template +class slot_base; + +template +using slot_ptr = std::shared_ptr>; + + +/* A base class for slot objects. This base type only depends on slot argument + * types, it will be used as an element in an intrusive singly-linked list of + * slots, hence the public next member. + */ +template +class slot_base : public slot_state { +public: + using base_types = trait::typelist; + + explicit slot_base(cleanable &c, group_id gid) + : slot_state(gid) + , cleaner(c) + {} + ~slot_base() override = default; + + // method effectively responsible for calling the "slot" function with + // supplied arguments whenever emission happens. + virtual void call_slot(Args...) = 0; + + template + void operator()(U && ...u) { + if (slot_state::connected() && !slot_state::blocked()) { + call_slot(std::forward(u)...); + } + } + + // check if we are storing callable c + template + bool has_callable(const C &c) const { + auto p = get_callable(); + return eq_function_ptr(c, p); + } + + template + std::enable_if_t::must_check_object, bool> + has_full_callable(const C &c) const { + return has_callable(c) && check_class_type>(); + } + + template + std::enable_if_t::must_check_object, bool> + has_full_callable(const C &c) const { + return has_callable(c); + } + + // check if we are storing object o + template + bool has_object(const O &o) const { + return get_object() == get_object_ptr(o); + } + +protected: + void do_disconnect() final { + cleaner.clean(this); + } + + // retieve a pointer to the object embedded in the slot + virtual obj_ptr get_object() const noexcept { + return nullptr; + } + + // retieve a pointer to the callable embedded in the slot + virtual func_ptr get_callable() const noexcept { + return get_function_ptr(nullptr); + } + +#ifdef SIGSLOT_RTTI_ENABLED + // retieve a pointer to the callable embedded in the slot + virtual const std::type_info& get_callable_type() const noexcept { + return typeid(nullptr); + } + +private: + template + bool check_class_type() const { + return typeid(U) == get_callable_type(); + } + +#else + template + bool check_class_type() const { + return false; + } +#endif + +private: + cleanable &cleaner; +}; + +/* + * A slot object holds state information, and a callable to to be called + * whenever the function call operator of its slot_base base class is called. + */ +template +class slot final : public slot_base { +public: + template + constexpr slot(cleanable &c, F && f, Gid gid) + : slot_base(c, gid) + , func{std::forward(f)} {} + +protected: + void call_slot(Args ...args) override { + func(args...); + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(func); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(func); + } +#endif + +private: + std::decay_t func; +}; + +/* + * Variation of slot that prepends a connection object to the callable + */ +template +class slot_extended final : public slot_base { +public: + template + constexpr slot_extended(cleanable &c, F && f, group_id gid) + : slot_base(c, gid) + , func{std::forward(f)} {} + + connection conn; + +protected: + void call_slot(Args ...args) override { + func(conn, args...); + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(func); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(func); + } +#endif + +private: + std::decay_t func; +}; + +/* + * A slot object holds state information, an object and a pointer over member + * function to be called whenever the function call operator of its slot_base + * base class is called. + */ +template +class slot_pmf final : public slot_base { +public: + template + constexpr slot_pmf(cleanable &c, F && f, P && p, group_id gid) + : slot_base(c, gid) + , pmf{std::forward(f)} + , ptr{std::forward

(p)} {} + +protected: + void call_slot(Args ...args) override { + ((*ptr).*pmf)(args...); + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(pmf); + } + + obj_ptr get_object() const noexcept override { + return get_object_ptr(ptr); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(pmf); + } +#endif + +private: + std::decay_t pmf; + std::decay_t ptr; +}; + +/* + * Variation of slot that prepends a connection object to the callable + */ +template +class slot_pmf_extended final : public slot_base { +public: + template + constexpr slot_pmf_extended(cleanable &c, F && f, P && p, group_id gid) + : slot_base(c, gid) + , pmf{std::forward(f)} + , ptr{std::forward

(p)} {} + + connection conn; + +protected: + void call_slot(Args ...args) override { + ((*ptr).*pmf)(conn, args...); + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(pmf); + } + obj_ptr get_object() const noexcept override { + return get_object_ptr(ptr); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(pmf); + } +#endif + +private: + std::decay_t pmf; + std::decay_t ptr; +}; + +/* + * An implementation of a slot that tracks the life of a supplied object + * through a weak pointer in order to automatically disconnect the slot + * on said object destruction. + */ +template +class slot_tracked final : public slot_base { +public: + template + constexpr slot_tracked(cleanable &c, F && f, P && p, group_id gid) + : slot_base(c, gid) + , func{std::forward(f)} + , ptr{std::forward

(p)} + {} + + bool connected() const noexcept override { + return !ptr.expired() && slot_state::connected(); + } + +protected: + void call_slot(Args ...args) override { + auto sp = ptr.lock(); + if (!sp) { + slot_state::disconnect(); + return; + } + if (slot_state::connected()) { + func(args...); + } + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(func); + } + + obj_ptr get_object() const noexcept override { + return get_object_ptr(ptr); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(func); + } +#endif + +private: + std::decay_t func; + std::decay_t ptr; +}; + +/* + * An implementation of a slot as a pointer over member function, that tracks + * the life of a supplied object through a weak pointer in order to automatically + * disconnect the slot on said object destruction. + */ +template +class slot_pmf_tracked final : public slot_base { +public: + template + constexpr slot_pmf_tracked(cleanable &c, F && f, P && p, group_id gid) + : slot_base(c, gid) + , pmf{std::forward(f)} + , ptr{std::forward

(p)} + {} + + bool connected() const noexcept override { + return !ptr.expired() && slot_state::connected(); + } + +protected: + void call_slot(Args ...args) override { + auto sp = ptr.lock(); + if (!sp) { + slot_state::disconnect(); + return; + } + if (slot_state::connected()) { + ((*sp).*pmf)(args...); + } + } + + func_ptr get_callable() const noexcept override { + return get_function_ptr(pmf); + } + + obj_ptr get_object() const noexcept override { + return get_object_ptr(ptr); + } + +#ifdef SIGSLOT_RTTI_ENABLED + const std::type_info& get_callable_type() const noexcept override { + return typeid(pmf); + } +#endif + +private: + std::decay_t pmf; + std::decay_t ptr; +}; + +} // namespace detail + + +/** + * signal_base is an implementation of the observer pattern, through the use + * of an emitting object and slots that are connected to the signal and called + * with supplied arguments when a signal is emitted. + * + * signal_base is the general implementation, whose locking policy must be + * set in order to decide thread safety guarantees. signal and signal_st + * are partial specializations for multi-threaded and single-threaded use. + * + * It does not allow slots to return a value. + * + * Slot execution order can be constrained by assigning group ids to the slots. + * The execution order of slots in a same group is unspecified and should not be + * relied upon, however groups are executed in ascending group ids order. When + * the group id of a slot is not set, it is assigned to the group 0. Group ids + * can have any value in the range of signed 32 bit integers. + * + * @tparam Lockable a lock type to decide the lock policy + * @tparam T... the argument types of the emitting and slots functions. + */ +template +class signal_base final : public detail::cleanable { + template + using is_thread_safe = std::integral_constant::value>; + + template + using cow_type = std::conditional_t::value, + detail::copy_on_write, U>; + + template + using cow_copy_type = std::conditional_t::value, + detail::copy_on_write, const U&>; + + using lock_type = std::unique_lock; + using slot_base = detail::slot_base; + using slot_ptr = detail::slot_ptr; + using slots_type = std::vector; + struct group_type { slots_type slts; group_id gid; }; + using list_type = std::vector; // kept ordered by ascending gid + +public: + using arg_list = trait::typelist; + using ext_arg_list = trait::typelist; + + signal_base() noexcept : m_block(false) {} + ~signal_base() override { + disconnect_all(); + } + + signal_base(const signal_base&) = delete; + signal_base & operator=(const signal_base&) = delete; + + signal_base(signal_base && o) /* not noexcept */ + : m_block{o.m_block.load()} + { + lock_type lock(o.m_mutex); + using std::swap; + swap(m_slots, o.m_slots); + } + + signal_base & operator=(signal_base && o) /* not noexcept */ { + lock_type lock1(m_mutex, std::defer_lock); + lock_type lock2(o.m_mutex, std::defer_lock); + std::lock(lock1, lock2); + + using std::swap; + swap(m_slots, o.m_slots); + m_block.store(o.m_block.exchange(m_block.load())); + return *this; + } + + /** + * Emit a signal + * + * Effect: All non blocked and connected slot functions will be called + * with supplied arguments. + * Safety: With proper locking (see pal::signal), emission can happen from + * multiple threads simultaneously. The guarantees only apply to the + * signal object, it does not cover thread safety of potentially + * shared state used in slot functions. + * + * @param a... arguments to emit + */ + template + void operator()(U && ...a) { + if (m_block) { + return; + } + + // Reference to the slots to execute them out of the lock + // a copy may occur if another thread writes to it. + cow_copy_type ref = slots_reference(); + + for (const auto &group : detail::cow_read(ref)) { + for (const auto &s : group.slts) { + s->operator()(a...); + } + } + } + + /** + * Connect a callable of compatible arguments + * + * Effect: Creates and stores a new slot responsible for executing the + * supplied callable for every subsequent signal emission. + * Safety: Thread-safety depends on locking policy. + * + * @param c a callable + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t, connection> + connect(Callable && c, group_id gid = 0) { + using slot_t = detail::slot; + auto s = make_slot(std::forward(c), gid); + connection conn(s); + add_slot(std::move(s)); + return conn; + } + + /** + * Connect a callable with an additional connection argument + * + * The callable's first argument must be of type connection. This overload + * the callable to manage it's own connection through this argument. + * + * @param c a callable + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t, connection> + connect_extended(Callable && c, group_id gid = 0) { + using slot_t = detail::slot_extended; + auto s = make_slot(std::forward(c), gid); + connection conn(s); + std::static_pointer_cast(s)->conn = conn; + add_slot(std::move(s)); + return conn; + } + + /** + * Overload of connect for pointers over member functions derived from + * observer + * + * @param pmf a pointer over member function + * @param ptr an object pointer derived from observer + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t && + trait::is_observer_v, connection> + connect(Pmf && pmf, Ptr && ptr, group_id gid = 0) { + using slot_t = detail::slot_pmf; + auto s = make_slot(std::forward(pmf), std::forward(ptr), gid); + connection conn(s); + add_slot(std::move(s)); + ptr->add_connection(conn); + return conn; + } + + /** + * Overload of connect for pointers over member functions + * + * @param pmf a pointer over member function + * @param ptr an object pointer + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t && + !trait::is_observer_v && + !trait::is_weak_ptr_compatible_v, connection> + connect(Pmf && pmf, Ptr && ptr, group_id gid = 0) { + using slot_t = detail::slot_pmf; + auto s = make_slot(std::forward(pmf), std::forward(ptr), gid); + connection conn(s); + add_slot(std::move(s)); + return conn; + } + + /** + * Overload of connect for pointer over member functions and + * + * @param pmf a pointer over member function + * @param ptr an object pointer + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t && + !trait::is_weak_ptr_compatible_v, connection> + connect_extended(Pmf && pmf, Ptr && ptr, group_id gid = 0) { + using slot_t = detail::slot_pmf_extended; + auto s = make_slot(std::forward(pmf), std::forward(ptr), gid); + connection conn(s); + std::static_pointer_cast(s)->conn = conn; + add_slot(std::move(s)); + return conn; + } + + /** + * Overload of connect for lifetime object tracking and automatic disconnection + * + * Ptr must be convertible to an object following a loose form of weak pointer + * concept, by implementing the ADL-detected conversion function to_weak(). + * + * This overload covers the case of a pointer over member function and a + * trackable pointer of that class. + * + * Note: only weak references are stored, a slot does not extend the lifetime + * of a suppied object. + * + * @param pmf a pointer over member function + * @param ptr a trackable object pointer + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t && + trait::is_weak_ptr_compatible_v, connection> + connect(Pmf && pmf, Ptr && ptr, group_id gid = 0) { + using trait::to_weak; + auto w = to_weak(std::forward(ptr)); + using slot_t = detail::slot_pmf_tracked; + auto s = make_slot(std::forward(pmf), w, gid); + connection conn(s); + add_slot(std::move(s)); + return conn; + } + + /** + * Overload of connect for lifetime object tracking and automatic disconnection + * + * Trackable must be convertible to an object following a loose form of weak + * pointer concept, by implementing the ADL-detected conversion function to_weak(). + * + * This overload covers the case of a standalone callable and unrelated trackable + * object. + * + * Note: only weak references are stored, a slot does not extend the lifetime + * of a suppied object. + * + * @param c a callable + * @param ptr a trackable object pointer + * @param gid an identifier that can be used to order slot execution + * @return a connection object that can be used to interact with the slot + */ + template + std::enable_if_t && + trait::is_weak_ptr_compatible_v, connection> + connect(Callable && c, Trackable && ptr, group_id gid = 0) { + using trait::to_weak; + auto w = to_weak(std::forward(ptr)); + using slot_t = detail::slot_tracked; + auto s = make_slot(std::forward(c), w, gid); + connection conn(s); + add_slot(std::move(s)); + return conn; + } + + /** + * Creates a connection whose duration is tied to the return object + * Use the same semantics as connect + */ + template + scoped_connection connect_scoped(CallArgs && ...args) { + return connect(std::forward(args)...); + } + + /** + * Disconnect slots bound to a callable + * + * Effect: Disconnects all the slots bound to the callable in argument. + * Safety: Thread-safety depends on locking policy. + * + * If the callable is a free or static member function, this overload is always + * available. However, RTTI is needed for it to work for pointer to member + * functions, function objects or and (references to) lambdas, because the + * C++ spec does not mandate the pointers to member functions to be unique. + * + * @param c a callable + * @return the number of disconnected slots + */ + template + std::enable_if_t<(trait::is_callable_v || + trait::is_callable_v || + trait::is_pmf_v) && + detail::function_traits::is_disconnectable, size_t> + disconnect(const Callable &c) { + return disconnect_if([&] (const auto &s) { + return s->has_full_callable(c); + }); + } + + /** + * Disconnect slots bound to this object + * + * Effect: Disconnects all the slots bound to the object or tracked object + * in argument. + * Safety: Thread-safety depends on locking policy. + * + * The object may be a pointer or trackable object. + * + * @param obj an object + * @return the number of disconnected slots + */ + template + std::enable_if_t && + !trait::is_callable_v && + !trait::is_pmf_v, size_t> + disconnect(const Obj &obj) { + return disconnect_if([&] (const auto &s) { + return s->has_object(obj); + }); + } + + /** + * Disconnect slots bound both to a callable and object + * + * Effect: Disconnects all the slots bound to the callable and object in argument. + * Safety: Thread-safety depends on locking policy. + * + * For naked pointers, the Callable is expected to be a pointer over member + * function. If obj is trackable, any kind of Callable can be used. + * + * @param c a callable + * @param obj an object + * @return the number of disconnected slots + */ + template + size_t disconnect(const Callable &c, const Obj &obj) { + return disconnect_if([&] (const auto &s) { + return s->has_object(obj) && s->has_callable(c); + }); + } + + /** + * Disconnect slots in a particular group + * + * Effect: Disconnects all the slots in the group id in argument. + * Safety: Thread-safety depends on locking policy. + * + * @param gid a group id + * @return the number of disconnected slots + */ + size_t disconnect(group_id gid) { + lock_type lock(m_mutex); + for (auto &group : detail::cow_write(m_slots)) { + if (group.gid == gid) { + size_t count = group.slts.size(); + group.slts.clear(); + return count; + } + } + return 0; + } + + /** + * Disconnects all the slots + * Safety: Thread safety depends on locking policy + */ + void disconnect_all() { + lock_type lock(m_mutex); + clear(); + } + + /** + * Blocks signal emission + * Safety: thread safe + */ + void block() noexcept { + m_block.store(true); + } + + /** + * Unblocks signal emission + * Safety: thread safe + */ + void unblock() noexcept { + m_block.store(false); + } + + /** + * Tests blocking state of signal emission + */ + bool blocked() const noexcept { + return m_block.load(); + } + + /** + * Get number of connected slots + * Safety: thread safe + */ + size_t slot_count() noexcept { + cow_copy_type ref = slots_reference(); + size_t count = 0; + for (const auto &g : detail::cow_read(ref)) { + count += g.slts.size(); + } + return count; + } + +protected: + /** + * remove disconnected slots + */ + void clean(detail::slot_state *state) override { + lock_type lock(m_mutex); + const auto idx = state->index(); + const auto gid = state->group(); + + // find the group + for (auto &group : detail::cow_write(m_slots)) { + if (group.gid == gid) { + auto &slts = group.slts; + + // ensure we have the right slot, in case of concurrent cleaning + if (idx < slts.size() && slts[idx] && slts[idx].get() == state) { + std::swap(slts[idx], slts.back()); + slts[idx]->index() = idx; + slts.pop_back(); + } + + return; + } + } + } + +private: + // used to get a reference to the slots for reading + inline cow_copy_type slots_reference() { + lock_type lock(m_mutex); + return m_slots; + } + + // create a new slot + template + inline auto make_slot(A && ...a) { + return detail::make_shared(*this, std::forward(a)...); + } + + // add the slot to the list of slots of the right group + void add_slot(slot_ptr &&s) { + const group_id gid = s->group(); + + lock_type lock(m_mutex); + auto &groups = detail::cow_write(m_slots); + + // find the group + auto it = groups.begin(); + while (it != groups.end() && it->gid < gid) { + it++; + } + + // create a new group if necessary + if (it == groups.end() || it->gid != gid) { + it = groups.insert(it, {{}, gid}); + } + + // add the slot + s->index() = it->slts.size(); + it->slts.push_back(std::move(s)); + } + + // disconnect a slot if a condition occurs + template + size_t disconnect_if(Cond && cond) { + lock_type lock(m_mutex); + auto &groups = detail::cow_write(m_slots); + + size_t count = 0; + + for (auto &group : groups) { + auto &slts = group.slts; + size_t i = 0; + while (i < slts.size()) { + if (cond(slts[i])) { + std::swap(slts[i], slts.back()); + slts[i]->index() = i; + slts.pop_back(); + ++count; + } else { + ++i; + } + } + } + + return count; + } + + // to be called under lock: remove all the slots + void clear() { + detail::cow_write(m_slots).clear(); + } + +private: + Lockable m_mutex; + cow_type m_slots; + std::atomic m_block; +}; + +/** + * Specialization of signal_base to be used in single threaded contexts. + * Slot connection, disconnection and signal emission are not thread-safe. + * The performance improvement over the thread-safe variant is not impressive, + * so this is not very useful. + */ +template +using signal_st = signal_base; + +/** + * Specialization of signal_base to be used in multi-threaded contexts. + * Slot connection, disconnection and signal emission are thread-safe. + * + * Recursive signal emission and emission cycles are supported too. + */ +template +using signal = signal_base; + +} // namespace sigslot + diff --git a/sigslot/readme.md b/sigslot/readme.md new file mode 100644 index 0000000..34e3b25 --- /dev/null +++ b/sigslot/readme.md @@ -0,0 +1,718 @@ +# Sigslot, a signal-slot library + +Sigslot is a header-only, thread safe implementation of signal-slots for C++. + +## Features + +The main goal was to replace Boost.Signals2. + +Apart from the usual features, it offers + +- Thread safety, +- Object lifetime tracking for automatic slot disconnection (extensible through ADL), +- RAII connection management, +- Slot groups to enforce slots execution order, +- Reasonable performance. and a simple and straightforward implementation. + +Sigslot is unit-tested and should be reliable and stable enough to replace Boost Signals2. + +The tests run cleanly under the address, thread and undefined behaviour sanitizers. + +Many implementations allow signal return types, Sigslot does not because I have +no use for them. If I can be convinced of otherwise I may change my mind later on. + +## Installation + +No compilation or installation is required, just include `sigslot/signal.hpp` +and use it. Sigslot currently depends on a C++14 compliant compiler, but if need +arises it may be retrofitted to C++11. It is known to work with Clang 4.0 and GCC +5.0+ compilers on GNU Linux, MSVC 2017 and up, Clang-cl and MinGW on Windows. + +However, be aware of a potential gotcha on Windows with MSVC and Clang-Cl compilers, +which may need the `/OPT:NOICF` linker flags in exceptional situations. Read The +Implementation Details chapter for an explanation. + +A CMake list file is supplied for installation purpose and generating a CMake import +module. This is the preferred installation method. The `Pal::Sigslot` imported target +is available and already applies the needed linker flags. It is also required for +examples and tests, which optionally depend on Qt5 and Boost for adapters unit tests. + +```cmake +# Using Sigslot from cmake +find_package(PalSigslot) + +add_executable(MyExe main.cpp) +target_link_libraries(MyExe PRIVATE Pal::Sigslot) +``` + +A configuration option `SIGSLOT_REDUCE_COMPILE_TIME` is available at configuration +time. When activated, it attempts to reduce code bloat by avoiding heavy template +instantiations resulting from calls to `std::make_shared`. +This option is off by default, but can be activated for those who wish to favor +code size and compilation time at the expanse of slightly less efficient code. + +Installation may be done using the following instructions from the root directory: + +```sh +mkdir build && cd build +cmake .. -DSIGSLOT_REDUCE_COMPILE_TIME=ON -DCMAKE_INSTALL_PREFIX=~/local +cmake --build . --target install + +# If you want to compile examples: +cmake --build . --target sigslot-examples + +# And compile/execute unit tests: +cmake --build . --target sigslot-tests +``` + +### CMake FetchContent + +`Pal::Sigslot` can also be integrated using the [FetchContent](https://cmake.org/cmake/help/latest/module/FetchContent.html) method. + +```cmake +include(FetchContent) + +FetchContent_Declare( + sigslot + GIT_REPOSITORY https://github.com/palacaze/sigslot + GIT_TAG 19a6f0f5ea11fc121fe67f81fd5e491f2d7a4637 # v1.2.0 +) +FetchContent_MakeAvailable(sigslot) + +add_executable(MyExe main.cpp) +target_link_libraries(MyExe PRIVATE Pal::Sigslot) +``` + +## Documentation + +Sigslot implements the signal-slot construct popular in UI frameworks, making it +easy to use the observer pattern or event-based programming. The main entry point +of the library is the `sigslot::signal` class template. + +A signal is an object that can emit typed notifications, really values parametrized +after the signal class template parameters, and register any number of notification +handlers (callables) of compatible argument types to be executed with the values +supplied whenever a signal emission happens. In signal-slot parlance this is called +connecting a slot to a signal, where a "slot" represents a callable instance and +a "connection" can be thought of as a conceptual link from signal to slot. + +All the snippets presented below are available in compilable source code form in +the example subdirectory. + +### Basic usage + +Here is a first example that showcases the most basic features of the library. + +We first declare a parameter-free signal `sig`, then we proceed to connect several +slots and at last emit a signal which triggers the invocation of every slot callable +connected beforehand. Notice how The library handles diverse forms of callables. + +```cpp +#include +#include + +void f() { std::cout << "free function\n"; } + +struct s { + void m() { std::cout << "member function\n"; } + static void sm() { std::cout << "static member function\n"; } +}; + +struct o { + void operator()() { std::cout << "function object\n"; } +}; + +int main() { + s d; + auto lambda = []() { std::cout << "lambda\n"; }; + auto gen_lambda = [](auto && ...a) { std::cout << "generic lambda\n"; }; + + // declare a signal instance with no arguments + sigslot::signal<> sig; + + // connect slots + sig.connect(f); + sig.connect(&s::m, &d); + sig.connect(&s::sm); + sig.connect(o()); + sig.connect(lambda); + sig.connect(gen_lambda); + + // emit a signal + sig(); +} +``` + +By default, the slot invocation order when emitting a signal is unspecified, please +do not rely on it being always the same. You may constrain a particular invocation +order by using slot groups, which are presented later on. + +### Signal with arguments + +That first example was simple but not so useful, let us move on to a signal that +emits values instead. A signal can emit any number of arguments, below. + +```cpp +#include +#include +#include + +struct foo { + // Notice how we accept a double as first argument here. + // This is fine because float is convertible to double. + // 's' is a reference and can thus be modified. + void bar(double d, int i, bool b, std::string &s) { + s = b ? std::to_string(i) : std::to_string(d); + } +}; + +// Function objects can cope with default arguments and overloading. +// It does not work with static and member functions. +struct obj { + void operator()(float, int, bool, std::string &, int = 0) { + std::cout << "I was here\n"; + } + + void operator()() {} +}; + +int main() { + // declare a signal with float, int, bool and string& arguments + sigslot::signal sig; + + // a generic lambda that prints its arguments to stdout + auto printer = [] (auto a, auto && ...args) { + std::cout << a; + (void)std::initializer_list{ + ((void)(std::cout << " " << args), 1)... + }; + std::cout << "\n"; + }; + + // connect the slots + foo ff; + sig.connect(printer); + sig.connect(&foo::bar, &ff); + sig.connect(obj()); + + float f = 1.f; + short i = 2; // convertible to int + std::string s = "0"; + + // emit a signal + sig(f, i, false, s); + sig(f, i, true, s); +} +``` + +As shown, slots arguments types don't need to be strictly identical to the signal +template parameters, being convertible-from is fine. Generic arguments are fine too, +as shown with the `printer` generic lambda (which could have been written as a +function template too). + +Right now there are two limitations that I can think of with respect to callable +handling: default arguments and function overloading. Both are working correctly +in the case of function objects but will fail to compile with static and member +functions, for different but related reasons. + +#### Coping with overloaded functions + +Consider the following piece of code: + +```cpp +struct foo { + void bar(double d); + void bar(); +}; +``` + +What should `&foo::bar` refer to? As per overloading, this pointer over member +function does not map to a unique symbol, so the compiler won't be able to pick +the right symbol. One way of resolving the right symbol is to explicitly cast the +function pointer to the right function type. Here is an example that does just that +using a little helper tool for a lighter syntax (In fact I will probably add this +to the library soon). + +```cpp +#include + +template +constexpr auto overload(void (C::*ptr)(Args...)) { + return ptr; +} + +template +constexpr auto overload(void (*ptr)(Args...)) { + return ptr; +} + +struct obj { + void operator()(int) const {} + void operator()() {} +}; + +struct foo { + void bar(int) {} + void bar() {} + + static void baz(int) {} + static void baz() {} +}; + +void moo(int) {} +void moo() {} + +int main() { + sigslot::signal sig; + + // connect the slots, casting to the right overload if necessary + foo ff; + sig.connect(overload(&foo::bar), &ff); + sig.connect(overload(&foo::baz)); + sig.connect(overload(&moo)); + sig.connect(obj()); + + sig(0); + + return 0; +} +``` + +#### Coping with function with default arguments + +Default arguments are not part of the function type signature, and can be redefined, +so they are really difficult to deal with. When connecting a slot to a signal, the +library determines if the supplied callable can be invoked with the signal argument +types, but at this point the existence of default function arguments is unknown +so there might be a mismatch in the number of arguments. + +A simple work around for this use case would is to create a bind adapter, in fact +we can even make it quite generic like so: + +```cpp +#include + +#define ADAPT(func) \ + [=](auto && ...a) { (func)(std::forward(a)...); } + +void foo(int &i, int b = 1) { + i += b; +} + +int main() { + int i = 0; + + // fine, all the arguments are handled + sigslot::signal sig1; + sig1.connect(foo); + sig1(i, 2); + + // must wrap in an adapter + i = 0; + sigslot::signal sig2; + sig2.connect(ADAPT(foo)); + sig2(i); + + return 0; +} +``` + +### Connection management + +#### Connection object + +What was not made apparent until now is that `signal::connect()` actually returns +a `sigslot::connection` object that may be used to manage the behaviour and lifetime +of a signal-slot connection. `sigslot::connection` is a lightweight object (basically +a `std::weak_ptr`) that allows interaction with an ongoing signal-slot connection +and exposes the following features: + +- Status querying, that is testing whether a connection is valid, ongoing or facing destruction, +- Connection (un)blocking, which allows to temporarily disable the invocation of a slot when a signal is emitted, +- Disconnection of a slot, the destruction of a connection previously created via `signal::connect()`. + +A `sigslot::connection` does not tie a connection to a scope: this is not a RAII +object, which explains why it can be copied. It can be however implicitly converted +into a `sigslot::scoped_connection` which destroys the connection when going out +of scope. + +Here is an example illustrating some of those features: + +```cpp +#include +#include + +int i = 0; + +void f() { i += 1; } + +int main() { + sigslot::signal<> sig; + + // keep a sigslot::connection object + auto c1 = sig.connect(f); + + // disconnection + sig(); // i == 1 + c1.disconnect(); + sig(); // i == 1 + + // scope based disconnection + { + sigslot::scoped_connection sc = sig.connect(f); + sig(); // i == 2 + } + + sig(); // i == 2; + + + // connection blocking + auto c2 = sig.connect(f); + sig(); // i == 3 + c2.block(); + sig(); // i == 3 + c2.unblock(); + sig(); // i == 4 +} +``` + +#### Extended connection signature + +Sigslot supports an extended slot signature with an additional `sigslot::connection` +reference as first argument, which permits connection management from inside the +slot. This extended signature is accessible using the `connect_extended()` method. + +```cpp +#include + +int main() { + int i = 0; + sigslot::signal<> sig; + + // extended connection + auto f = [](auto &con) { + i += 1; // do work + con.disconnect(); // then disconnects + }; + + sig.connect_extended(f); + sig(); // i == 1 + sig(); // i == 1 because f was disconnected +} +``` + +#### Automatic slot lifetime tracking + +The user must make sure that the lifetime of a slot exceeds the one of a signal, +which may get tedious in complex software. To simplify this task, Sigslot can +automatically disconnect slot object whose lifetime it is able to track. In order +to do that, the slot must be convertible to a weak pointer of some form. + +`std::shared_ptr` and `std::weak_ptr` are supported out of the box, and adapters +are provided to support `boost::shared_ptr`, `boost::weak_ptr` and Qt `QSharedPointer`, +`QWeakPointer` and any class deriving from `QObject`. + +Other trackable objects can be added by declaring a `to_weak()` adapter function. + +```cpp +#include +#include + +int sum = 0; + +struct s { + void f(int i) { sum += i; } +}; + +class MyObject : public QObject { + Q_OBJECT +public: + void add(int i) const { sum += i; } +}; + +int main() { + sum = 0; + signal sig; + + // track lifetime of object and also connect to a member function + auto p = std::make_shared(); + sig.connect(&s::f, p); + + sig(1); // sum == 1 + p.reset(); + sig(1); // sum == 1 + + // track an unrelated object lifetime + struct dummy; + auto l = [&](int i) { sum += i; }; + + auto d = std::make_shared(); + sig.connect(l, d); + sig(1); // sum == 2 + d.reset(); + sig(1); // sum == 2 + + // track a QObject + { + MyObject o; + sig.connect(&MyObject::add, &o); + + sig(1); // sum == 3 + } + + sig(1); // sum == 3 +} +``` + +#### Intrusive slot lifetime tracking + +Another way of ensuring automatic disconnection of pointer over member functions +slots is by explicitly inheriting from `sigslot::observer` or `sigslot::observer_st`. +The former is thread-safe, contrary to the later. + +Here is an example usage. + +```cpp +#include + +int sum = 0; + +struct s : sigslot::observer_st { + void f(int i) { sum += i; } +}; + +struct s_mt : sigslot::observer { + ~s_mt() { + // Needed to ensure proper disconnection prior to object destruction + // in multithreaded contexts. + this->disconnect_all(); + } + + void f(int i) { sum += i; } +}; + +int main() { + sum = 0; + signal sig; + + { + // Lifetime of object instance p is tracked + s p; + s_mt pm; + sig.connect(&s::f, &p); + sig.connect(&s_mt::f, &pm); + sig(1); // sum == 2 + } + + // The slots got disconnected at instance destruction + sig(1); // sum == 2 +} +``` + +The objects that use this intrusive approach may be connected to any number of +unrelated signals. + +### Disconnection without a connection object + +Support for slot disconnection by supplying an appropriate function signature, +object pointer or tracker has been introduced in version 1.2.0. + +One can disconnect any number of slots using the `signal::disconnect()` method, +which proposes 4 overloads to specify the disconnection criterion: + +- The first takes a reference to a callable. Any kind of callable can be passed, + even pointers to member functions, function objects and lambdas, +- The second takes a pointer to an object, for slots bound to a pointer to member + function, or a tracking object, +- The third overload takes both kinds of arguments at the same time and can be + used to pinpoint a specific pair of object + callable. +- The last overload takes a group id and disconnects all the slots in this group. + +Disconnection of lambdas is only possible for lambdas bound to a variable, due +to their uniqueness. + +The second overload currently needs RTTI to disconnect from pointers to member +functions, function objects and lambdas. This limitation does not apply to free +and static member functions. The reasons stems from the fact that in C++, pointers +to member functions of unrelated types are not comparable, contrary to pointers to +free and static member functions. For instance, the pointer to member functions of +virtual methods of different classes can have the same address (they kind of store +the offset of the method into the vtable). + +However, Sigslot can be compiled with RTTI disabled and the overload will be +deactivated for problematic cases. + +As a side node, this feature admittedly added more code than anticipated at first +because it is a tricky and easy to get wrong. It has been designed carefully, with +correctness in mind, and does not have any hidden costs unless you actually use it. + +Here is an example demonstrating the feature. + +```cpp +#include +#include + +static int i = 0; + +void f1() { i += 1; } +void f2() { i += 1; } + +struct s { + void m1() { i += 1; } + void m2() { i += 1; } + void m3() { i += 1; } +}; + +struct o { + void operator()() { i += 1; } +}; + +int main() { + sigslot::signal<> sig; + s s1; + auto s2 = std::make_shared(); + + auto lbd = [&] { i += 1; }; + + sig.connect(f1); // #1 + sig.connect(f2); // #2 + sig.connect(&s::m1, &s1); // #3 + sig.connect(&s::m2, &s1); // #4 + sig.connect(&s::m3, &s1); // #5 + sig.connect(&s::m1, s2); // #6 + sig.connect(&s::m2, s2); // #7 + sig.connect(o{}); // #8 + sig.connect(lbd); // #9 + + sig(); // i == 9 + + sig.disconnect(f2); // #2 is removed + sig.disconnect(&s::m1); // #3 and #6 are removed + sig.disconnect(o{}); // #8 and is removed + // sig.disconnect(&o::operator()); // same as the above, more efficient + sig.disconnect(lbd); // #9 and is removed + sig.disconnect(s2); // #7 is removed + sig.disconnect(&s::m3, &s1); // #5 is removed, not #4 + + sig(); // i == 11 + + sig.disconnect_all(); // remove all remaining slots + return 0; +} +``` + +### Enforcing slot invocation order with slot groups + +From version 1.2.0, slots can be assigned a group id in order to control the +relative order of invocation of slots. + +The order of invocation of slots in a same group is unspecified and should not be +relied upon, however slot groups are invoked in ascending group id order. +When the group id of a slot is not set, it is assigned to the group 0. +Group ids can have any value in the range of signed 32 bit integers. + +```cpp +#include +#include +#include + +int main() { + sigslot::signal<> sig; + + // simply assigning a group id as last argument to connect + sig.connect([] { std::puts("Second"); }, 1); + sig.connect([] { std::puts("Last"); }, std::numeric_limits::max()); + sig.connect([] { std::puts("First"); }, -10); + sig(); + + return 0; +} +``` + +### Thread safety + +Thread safety is unit-tested. In particular, cross-signal emission and recursive +emission run fine in a multiple threads scenario. + +`sigslot::signal` is a typedef to the more general `sigslot::signal_base` template +class, whose first template argument must be a Lockable type. This type will dictate +the locking policy of the class. + +Sigslot offers 2 typedefs, + +- `sigslot::signal` usable from multiple threads and uses std::mutex as a lockable. + In particular, connection, disconnection, emission and slot execution are thread + safe. It is also safe with recursive signal emission. +- `sigslot::signal_st` is a non thread-safe alternative, it trades safety for slightly + faster operation. + + +## Implementation details + +### Using function pointers to disconnect slots + +Comparing function pointers is a nightmare in C++. Here is a table demonstrating +the size and address of a variety of cases as a showcase: + +```cpp +void fun() {} + +struct b1 { + virtual ~b1() = default; + static void sm() {} + void m() {} + virtual void vm() {} +}; + +struct b2 { + virtual ~b2() = default; + static void sm() {} + void m() {} + virtual void vm() {} +}; + +struct c { + virtual ~c() = default; + virtual void w() {} +}; + +struct d : b1 { + static void sm() {} + void m() {} + void vm() override {} +}; + +struct e : b1, c { + static void sm() {} + void m() {} + void vm() override{} +}; +``` + +| Symbol | GCC 9 Linux 64
Sizeof | GCC 9 Linux 64
Address | MSVC 16.6 32
Sizeof | MSVC 16.6 32
Address | GCC 8 Mingw 32
Sizeof | GCC 8 Mingw 32
Address | Clang-cl 9 32
Sizeof | Clang-cl 9 32
Address | +|---------|--------------------------|---------------------------|------------------------|-------------------------|--------------------------|---------------------------|-------------------------|--------------------------| +| fun | 8 | 0x802340 | 4 | 0x1311A6 | 4 | 0xF41540 | 4 | 0x0010AE | +| &b1::sm | 8 | 0xE03140 | 4 | 0x7612A5 | 4 | 0x308D40 | 4 | 0x0010AE | +| &b1::m | 16 | 0xF03240 | 4 | 0x1514A5 | 8 | 0x248D40 | 4 | 0x0010AE | +| &b1::vm | 16 | 0x11 | 4 | 0x9F11A5 | 8 | 0x09 | 4 | 0x8023AE | +| &b2::sm | 8 | 0x003340 | 4 | 0xA515A5 | 4 | 0x408D40 | 4 | 0x0010AE | +| &b2::m | 16 | 0x103440 | 4 | 0xEB10A5 | 8 | 0x348D40 | 4 | 0x0010AE | +| &b2::vm | 16 | 0x11 | 4 | 0x6A14A5 | 8 | 0x09 | 4 | 0x8023AE | +| &d::sm | 8 | 0x203440 | 4 | 0x2612A5 | 4 | 0x108D40 | 4 | 0x0010AE | +| &d::m | 16 | 0x303540 | 4 | 0x9D13A5 | 8 | 0x048D40 | 4 | 0x0010AE | +| &d::vm | 16 | 0x11 | 4 | 0x4412A5 | 8 | 0x09 | 4 | 0x8023AE | +| &e::sm | 8 | 0x403540 | 4 | 0xF911A5 | 4 | 0x208D40 | 4 | 0x0010AE | +| &e::m | 16 | 0x503640 | 8 | 0x8111A5 | 8 | 0x148D40 | 8 | 0x0010AE | +| &e::vm | 16 | 0x11 | 8 | 0xA911A5 | 8 | 0x09 | 8 | 0x8023AE | + +MSVC and Clang-cl in Release mode optimize functions with the same definition by +merging them. This is a behaviour that can be deactivated with the `/OPT:NOICF` +linker option. +Sigslot tests and examples rely on a lot a identical callables which trigger this +behaviour, which is why it deactivates this particular optimization on the affected +compilers. + +### Known bugs + +Using generic lambdas with GCC less than version 7.4 can trigger [Bug #68071](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=68071). + diff --git a/ui_QtGPIOMain.h b/ui_QtGPIOMain.h new file mode 100644 index 0000000..a22f4c5 --- /dev/null +++ b/ui_QtGPIOMain.h @@ -0,0 +1,105 @@ +/******************************************************************************** +** Form generated from reading UI file 'QtGPIOMain.ui' +** +** Created by: Qt User Interface Compiler version 5.15.2 +** +** WARNING! All changes made in this file will be lost when recompiling UI file! +********************************************************************************/ + +#ifndef UI_QTGPIOMAIN_H +#define UI_QTGPIOMAIN_H + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE + +class Ui_QtGPIOMain +{ +public: + QWidget *centralwidget; + QHBoxLayout *horizontalLayout; + QFrame *_frame; + QPushButton *_LED; + QDial *_dial; + QLCDNumber *_display; + QMenuBar *menubar; + QStatusBar *statusbar; + + void setupUi(QMainWindow *QtGPIOMain) + { + if (QtGPIOMain->objectName().isEmpty()) + QtGPIOMain->setObjectName(QString::fromUtf8("QtGPIOMain")); + QtGPIOMain->resize(473, 342); + centralwidget = new QWidget(QtGPIOMain); + centralwidget->setObjectName(QString::fromUtf8("centralwidget")); + centralwidget->setStyleSheet(QString::fromUtf8("")); + horizontalLayout = new QHBoxLayout(centralwidget); + horizontalLayout->setObjectName(QString::fromUtf8("horizontalLayout")); + _frame = new QFrame(centralwidget); + _frame->setObjectName(QString::fromUtf8("_frame")); + _frame->setStyleSheet(QString::fromUtf8("background: grey")); + _frame->setFrameShape(QFrame::NoFrame); + _frame->setFrameShadow(QFrame::Sunken); + _frame->setLineWidth(10); + _frame->setMidLineWidth(10); + _LED = new QPushButton(_frame); + _LED->setObjectName(QString::fromUtf8("_LED")); + _LED->setGeometry(QRect(50, 60, 91, 81)); + _LED->setStyleSheet(QString::fromUtf8("background: grey")); + QIcon icon; + icon.addFile(QString::fromUtf8(":/images/Green.png"), QSize(), QIcon::Normal, QIcon::Off); + icon.addFile(QString::fromUtf8(":/images/Red.png"), QSize(), QIcon::Normal, QIcon::On); + _LED->setIcon(icon); + _LED->setIconSize(QSize(64, 64)); + _LED->setCheckable(false); + _LED->setFlat(true); + _dial = new QDial(_frame); + _dial->setObjectName(QString::fromUtf8("_dial")); + _dial->setGeometry(QRect(130, 60, 80, 80)); + _display = new QLCDNumber(_frame); + _display->setObjectName(QString::fromUtf8("_display")); + _display->setGeometry(QRect(250, 90, 131, 41)); + _display->setStyleSheet(QString::fromUtf8("background:lightgrey")); + + horizontalLayout->addWidget(_frame); + + QtGPIOMain->setCentralWidget(centralwidget); + menubar = new QMenuBar(QtGPIOMain); + menubar->setObjectName(QString::fromUtf8("menubar")); + menubar->setGeometry(QRect(0, 0, 473, 26)); + QtGPIOMain->setMenuBar(menubar); + statusbar = new QStatusBar(QtGPIOMain); + statusbar->setObjectName(QString::fromUtf8("statusbar")); + QtGPIOMain->setStatusBar(statusbar); + + retranslateUi(QtGPIOMain); + + QMetaObject::connectSlotsByName(QtGPIOMain); + } // setupUi + + void retranslateUi(QMainWindow *QtGPIOMain) + { + QtGPIOMain->setWindowTitle(QCoreApplication::translate("QtGPIOMain", "libPiGPio Widget Demo", nullptr)); + _LED->setText(QString()); + } // retranslateUi + +}; + +namespace Ui { + class QtGPIOMain: public Ui_QtGPIOMain {}; +} // namespace Ui + +QT_END_NAMESPACE + +#endif // UI_QTGPIOMAIN_H