This is a 'front pack' with a 16 way touch pad (with 32 key buffer) for use with standard 16x2 HD44780 type displays. It also has three PWM back light outputs so it can be used with RGB type displays. The user interface is I2C.
- Data sheet
- Overlay samples (png & Inkscape )
- Raspberry Pi
- FAQ & Tips
- EEPROM utility (python for the RPi)
- Purchase <Byvac Shop> <eBay shop>
- User comments, feedback
- BV4243 Library and samples - version 1.05
The above zip file has a selection of examples and the library itself:
void clrBuf(); Clears / resets the keypad buffer, the buffer is 79 bytes big
uint8_t keysBuf(); Returns the number of keys in the buffer
uint8_t key(); removes and returns the key in the buffer, if no key, returns a 0
uint8_t keyIn(uint8_t k); See if 'k' is in the buffer, 0 if not or a number representing its position in the buffer
uint8_t scan(); Returns the scan code if a pad is being touched, if no pad being touched then returns 0
void avg(uint16_t *b); Supply a buffer 8 integers big and this will return the 8 averages from each channel
void delta(uint16_t *b); Supply a buffer 8 integers big and this will return the delta value for each channel. The delta value is the difference between an average value and the touched value, if no pad is thouched the delaa value will therefore be 0
void EEreset(); Resets all EEPROM values back to their defaults
void sleep(); Shuts down device to save power, can only be awakened with a reset or I2C activity. NOTE the keypad will not respond when in sleep mode.
void beep(uint8 beepMs); Beeps the beeper for number of mS, max 255
NOTE: Values written to the EEPROM will not take effect until the device is reset. For what the values mean consult the data sheet in the Device Parameters section.
void trigger(uint16_t value); Write a new trigger value to the EEPROM
void hyst(uint8_t value); Writes a new hysteresis value to EEPROM
void keyPtr(uint8_t value); Writes a new key pointer value to EEPROM
void keySize(uint8_t value); Writes a new key table size value to EEPROM
void debounce(uint8_t value); Writes a new debounce value to EEPROM
void repeat(uint16_t value); Writes a new repeat key value to EEPROM
void timebase(uint8_t value); Writes a new timebase value to EEPROM
void defaultBL(uint8_t value); Writes a new default back light value to EEPROM
void EEwrite(uint8_t adr, uint8_t value); Writes a value to the specified EEPROM address
uint8_t EEread(uint8_t adr); Reads an EEPROM value at the specified address
uint16_t ID(); Gets the device id number as an integer, in this case 4242
void Version(uint8_t *b); Gets the firmware version as two bytes
The LCD secion uses exactly** the same function names as used in the LiquidCrystal library and so will not be repeated here. There are however a few extra functions listed
void lcd_reset(); Sends a reset to the LCD display
void bl(uint8_t m r, uint8_t m, g,uint8_t m, b); The back light has 3 values, RGB, the range is 0 to 10
void lcd_startMsg(); This simply displays the message stored in EEPROM
** the current LiquidCrystal setCursor() starts row and column numbers from 0 whereas the BV4243 setCursor() starts them from 1.
Use the device exactly as any other I2C device, wiring:
|3.3V or 5V (depends on LCD display)||V+|
Unzip the library file or use the include Library>>add .zip and try one of the examples.
This should not really be necessary but it is there is a utility that will display all of the channel average and delta values. Tuning details are covered in the data sheet.
Most LCD displays require 5V and so connect the 5V Rpi supply to the device. This will not effect the I2C data and clock lines that will be still at 3.3V doe to the pull up resistors incorporated into the RPi
|3.3V or 5V (depends on LCD display)||V+|
You will needs to install the basic RPI I2C. This can now also be partly done via the config tool (sudo raspi-config).
This is a normal I2C device that can easily be used with Python. Connect and use i2cdetect to make sure it is connected okay.
pi@raspberrypi ~ $ i2cdetect -y 1
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
pi@raspberrypi ~ $
The address is 0x3c as shown. Just to get a feel of how it works i2ctools can be used:
- i2cset -y 1 0x3c 31 1 // clears the LCD screen by sending command 1
- i2cset -y 1 0x3c 32 65 // prints 'A' to the display
- i2cget -y 1 0x3c 3 // gets a key from the keypad buffer
On the last command "i2cget -y 1 0x3c 3" if it returns 0, touch a key and send the command again, you will see that the key value will now be fetched.
There is a python class that can be incorporated into Python programs.
The program does use notSMB and so that will also be required. As an example the following is a Python interactive session at the command line.
Python 2.7.3 (default, Mar 18 2014, 05:13:23)
[GCC 4.6.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import bv4243 as b
>>> ui = b.BV4243(0x3c,1)
The files here are by no means complete but will give a good start.
Load and save the above first
The keypad is designed as a front panel and comes with just a bare PCB, the front of which has the touch pads on. The idea is to create your own design to suit a particular project.
- Overlay - zip file, this included DXF and SVG
The layouts file contains an svg file. This can be opened and edited in inkscape which is free and rather good. The file contains an accurate representation of the layout. This can be used to print an overlay for the device.
Tips: (*** This is for the BV4242 but the techniques still apply ***)
Sticky backed glossy photo paper was used to produce the layouts that were made a bit oversized. When printed the rectangle hole for the LCD display was cut out so as to position the overlay.
This covered the PCB. The excess was cut off from the back.
Another good material is Vinyl but it is a bit thinner and so the PCB shows through. Clear sticky back material could also be used. The LCD rectangle could be left unprinted and stuck over the whole PCB, thus making it weather resistant.
There is also the dimension, dxf drawing in the overlay zip file above. The depth of the device will of course be determined by the LCD display fitted but using a standard display it is about 10mm.
The device will fit exactly onto this box: http://www.ebay.co.uk/itm/PLASTIC-BOX-ENCLOSURE-CASE-HOBBY-ELECTRONIC-PROJECT-ABS-E76-/130738084288
- I2C Swamp
The device is constantly monitoring the keypad but the I2C has priority over this and will always be acknowledged. If the host is constantly reading or writing to the device then it will have less time to do its job. If it is necessary to respond quickly to a key pad touch then use one of the interrupt pins rather than poling the I2C.
- My display has too few pins and won't fit?
The device is designed to take BOTH the newer RGB back light type displays and the ordinary single back light displays. The RGB displays have 18 pins and the normal displays have 16 pins so to fit a normal display 2 pins need cutting off. This is explained in the data sheet, display fitting section.
Some displays have a very tall glass area, in this case the pins will not go all the way through the holes on the display. For this instance, solder the pins on the underside of the display, it is a little more tricky but works well.
I received the item with the LCD already soldered to the display, although the notes on eBay said they would be separate. This was presumably because the display is a “deep” one and the pins had to be soldered from the side.
The pins are now supplied unsoldered to cater for the variang types of display and to facilitate accurate centering.
I purchased the recommended box from eBay and it DID fit exactly, as promised. Unfortunately the box is not big enough to hold a raspberry pi, Arduino Leonardo or UNO as well (!) and after I substituted a Teensy and added a 3v coin cell for real time clock there was not enough depth behind the lcd without shaving off the bottom spacers, and no free space for placing the connectors for my probes. The box is just too small! I suggest a note on your web page pointing out that you can’t get much else in with the BV4243 in this box.
The supplied Arduino library proved useless to me. My project monitors an IR transmitter via an interrupt service routine, and the static delays built into the library code, particularly for “home” and “clear” meant that the ISR missed several rising edges. At the same time, the Arduino code uses the old “blocking” I2C routines, even for functions such as getting key counts, which involve waiting while I2C is stopped and started again. This latter problem was helped by using the INT pin on the BV4243, but still caused me some timing problems.
The code supplied is anexample only and may requre modifiying for a particular purpose. There is on this device two hardware pins, 'int' to indicate keys in buffer and 'key' which is activated each time a key is pressed.
I found that sometimes after a reboot of the teensy there were still keys in the key buffer, sometimes unprocessed from or during the reboot, sometimes spurious.
The BV4243 has a hardware reset key, also 'clear key buffer' command can be send during that start up.