Mini Thermal Receipt Printer
Contents
1. Adafruit Industries Last Updated 2012 09 06 01 45 19 PM EDT Page 19 of 192. of black on white inverseOff turns this off Double height this makes text thats extra tall call doubleHeightOn likewise turn off with do ubleHeightOff Left Center Right justified this aligns text to the left or right edge of the page or centered You can set the alignment by calling justify R for right justified justify C for centered orjustify L for left justified Left justified is the default state Bold text makes it stand out a bit more enable with boldOn and turn off with boldOff Underlined text makes it stand out a bit more enable with underlineOn and turn off with underlineOff Large Medium Small text by default we use small medium is twice as tall large is twice as wide tall Set the size with setSize L setSize M or setSize S Line spacing you can change the space between lines of text by calling setLineHeight lt numpix gt where numpix is the number of pixels The minimum is 24 no extra space between lines the default spacing is 32 and double spaced text would be 64 Look through the source of the printertest sketch to see these used in context Adafruit Industries http learn adafruit com mini thermal receipt printer Page 13 of 19 ve adafruit learning system Bitmap Printing This printer can print out bitmaps which can add a touch of class to a receipt with your logo or similar The first step is to get the logo prepared The printer can only do monochrome 1
3. to the nearest smaller 8 pixel boundary For example with the 75 pixel wide image above the output will be cropped to only 72 pixels wide losing some data from the right edge To avoid this increase this number to the next multiple of 8 that would be 80 for the example above and the output will be padded with blank pixels to cover the gap Remember the number you use here you ll need it later The image height does not need to be adjusted this way only width Set the table name to something short but descriptive e g adalogo above then select Save Output from the File menu Give the file a similarly brief but descriptive name ending in h e g adalogo h To get this file into your Arduino sketch select Add File from the Sketch menu This will add a new tab to your code Your original code is still there under the leftmost tab A couple of small changes are now needed in both tabs First at the top of the file containing the new table data change const unsigned char to static PROGMEM prog uchar as shown below s File Edit Sketch Tools Help adalogo h 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x03 OxFO 0x00 0x00 0x03 OxF8 0x00 0x00 0x00 0x00 0x00 0x00 0x00 C 0x00 C C C 0x00 0x00 0x00 0x00 0x00 OxOF OxF8 0x00 0x00 0x00 C C C 4 0x00 0x00 0x00 0x00 0x00 0x00 OxFC 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 OxlF 0x00 0x
4. 00 0x00 Ox3F OxFC 0x00 0x00 0x00 0x00 0x00 nxnn nxnn nxan nxan nxan AXAN nxnn nx n nx7F NFE xf Next in the tab containing the main body of your code add an include statement to reference the new file include adalogo h Check the printertest example sketch if you re not sure how to include the code properly You can now output the image by calling printBitmap width height tablename where width and height are the dimensions of the image in pixels if you changed the image width to a multiple of 8 as previously described use that number not the original image size and tablename is the name of the array in the new tab e g adalogo above Adafruit Industries http learn adafruit com mini thermal receipt printer Page 15 of 19 Having a graphical user interface is nice but some of these extra steps can be confusing and error prone If you prefer the technique below for Mac and Linux works in Windows as well Mac and Linux The conversion tool for Mac and Linux doesn t include a fancy GUI but it works well and avoids several steps and potential mis steps The source image doesn t need to be in BMP format most image formats can be read natively and the output can be added to a sketch with no further editing It works for Windows as well if you d rather use this method First if you don t already have the Processing language installed download it from processing org http adafru it
5. aPt Processing looks almost exactly like the Arduino IDE but it s for writing code for your normal computer not a microcontroller This can be a little confusing to first timers so if something doesn t seem to compile make sure you re running code in the right environment Arduino for for the Arduino board Processing for your computer This code runs in Processing 1 5 1 the last stable release but not 2 0 currently in beta Be sure to download version 1 5 1 even though they ve made 2 0 the most prominent download option The Adafruit Thermal library folder that you previously downloaded contains a sub folder called processing Inside that is a sketch called bitmaplmageCo nvert pde Load this into Processing and press RUN the triangle button You ll be prompted to select an image using the system s standard file selection dialog The program runs for just a brief instant and will create a new file alongside the original image file For example if you selected an image called adalogo png there will be a new file called adalogo h in the same location This file contains code to add to your Arduino sketch You shouldn t need to edit this file unless you want to change the variable names within Adafruit Industries http learn adafruit com mini thermal receipt printer Page 16 of 19 To get this file into your Arduino sketch select Add File from the Sketch menu This will add a new tab to your code Your original cod
6. any of the GND pins You can change the digital pins later but to match the example code stick to this for now Adafruit Industries http learn adafruit com mini thermal receipt printer Page 10 of 19 Now its time to download the Arduino library code Visit the Adafruit Thermal Printer Library http adafru it aHt on GitHub To download click the ZIP button near the top left uncompress the ZIP file and rename the resulting uncompressed folder to Adafruit Thermal Confirm that this folder contains the files Adafruit Thermal cpp and Adafruit Thermal h along with examples and other items Place the Adafruit Thermal library inside your Arduino libraries folder We have a tutorial on library installation http adafru it aHr to guide you through this If running an older pre 1 0 version of the Arduino software you ll also need to install the NewSoftSerial library Download it by clicking this link http adafru it aM7 and install it as you did the Thermal library This is not necessary if running the latest Arduino software After installing the libraries restart the Arduino IDE You should now be able to access the sample code by navigating through menus in this order File2Sketchbook Libraries 5Adafruit Thermal printertest If your printer test page shows BAUDRATE 9600 you ll need to make a small change to the library source code Using a text editor Notepad etc open the file Adafruit Thermal cpp and change this line
7. bit images and the maximum width is 384 pixels We suggest starting with a small bitmap 100 pixels or less on each side and then experimenting to get the size and look you want A few steps are required to prepare an image for printing For Windows users there s a nice graphical user interface for this For Mac and Linux different tools are used not as visually slick but they do the job well Windows Use an image editing program to save your image as a 1 bit BMP in Windows the built in Paint program will suffice Download install and run LCD Assistant http adafru it aPs This program is for Windows only but does a really fantastic job Load the BMP file you previously generated in Paint etc The file must be in BMP format the software won t read PNG GIF etc Then a couple of settings need to be adjusted Settings Picture preview Byte orientation C Vertical A Size ven B Height 75 Other Indude size Pixels byte B el En Table name adalogo First in the Byte orientation section of the settings select Horizontal item A in the image Adafruit Industries http learn adafruit com mini thermal receipt printer Page 14 of 19 above Second item B above you may need to change the Width setting Because this software and the thermal printer handle images in horizontal groups of eight pixels if the image width is not a multiple of 8 it will be truncated cropped
8. define BAUDRATE 19200 to this define BAUDRATE 9600 Most printers arrive from the factory set for 19200 baud but a few may be set to 9600 This Adafruit Industries http learn adafruit com mini thermal receipt printer Page 11 of 19 will not negatively impact the performance of your unit The speed of the paper through the printer is already much less than this and you will not see any difference it s strictly a data protocol issue of getting the microcontroller and printer communicating OK now you re finally ready to run the printer demo Open up the Arduino IDE and select File Sketchbook Libraries 5Adafruit Thermal printertest and upload the sketch to the Arduino You should see the printer print out the example receipt which includes all the capabilities of the library line spac in wawadi t ADAFRUIT UM If this does not work first check that the printer and Arduino are both powered and that the yellow green and black wires are properly connected to the Arduino Adafruit Industries http learn adafruit com mini thermal receipt printer Page 12 of 19 Ye adafruit learning system Printing Text eral ADAFRUIT UM The thermal printer has a few handy things it can do most of which are in the printertest sketch These are shown in the image above In order starting from the top Inverted text this is invoked by calling inverseOn you will get text that s white on black instead
9. e is still there under the leftmost tab Next in the tab containing the main body of your code add an include statement to reference the new file include adalogo h Check the printertest example sketch if you re not sure how to include the code properly If the source image was called adalogo png then the resulting h file adalogo h will contain three values called adalogo width adalogo height and adalogo data which can be passed directly and in order to the printBitmap function like this printBitmap adalogo width adalogo height adalogo data Adafruit Industries http learn adafruit com mini thermal receipt printer Page 17 of 19 Ye adafruit learning system Barcode Printing Thermal printers are really good at printing barcodes This printer supports 11 different codes UPC A UPC E EAN13 EAN8 CODE39 125 CODEBAR CODE93 CODE128 CODE11 and MSI It only supports linear 1 D barcodes and can t generate 2 D barcodes like QR codes although there is a hack you can do see below Barcodes are generated on the fly which is nice you can customize the height and data included quite easily You can make a barcode by calling printBarcode barcodedata BARCODETYPE where the first string is the data to encode e g a UPC code and BARCODETYPE can be UPC A UPC E EAN13 EAN8 CODE39 125 CODEBAR CODE93 CODE128 CODE11 or MSI Some barcodes are very restricted you can only put in 12 numbers no cha
10. en try again holding down the top button when connecting power Note the baud rate on the test page This may be 19200 or 9600 We ll need this number later Adafruit Industries http learn adafruit com mini thermal receipt printer Page 8 of 19 Ke GORR Mov U s eat OO m Y PEER goo V ceret a ct de ete DAN GC Gh GON Mia e DUM rf ur Adafruit Industries http learn adafruit com mini thermal receipt printer Page 9 of 19 Ye adafruit learning system Microcontroller To send data to the printer we will use a 5V TTL serial connection This is not the same as the 10V RS232 serial from a computer s 9 pin serial port don t connect the printer directly to a standard PC port or you may damage it It s possible to use something like an FTDI cable to talk to the printer but we re going to assume that nearly everyone will want to use it with a microcontroller This tutorial shows how to wire it up to an Arduino and our example code is Arduino compatible Any microcontroller that can output TTL serial will work with suitable adaptation to the code To start we ll connect to the data cable of the printer which has three wires black yellow and green An easy way to connect is to simply press 22AWG or so wires of matching colors into the plug then use those to extend the connection to an Arduino O At the Arduino end the green wire connects to digital pin 5 yellow goes to digital pin 6 and black to
11. ing Arduino library demonstrate the following Printing with small medium and large text Bold underline and inverted text Variable line spacing Left center and right justification Barcodes in the following standard formats UPC A UPC E EAN13 EAN8 CODE39 125 CODEBAR CODE93 CODE128 CODE11 and MSI with adjustable barcode height e Custom monochrome bitmap graphics Adafruit Industries http learn adafruit com mini thermal receipt printer Page 3 of 19 e Howto print a QR code Adafruit Industries http learn adafruit com mini thermal receipt printer Page 4 of 19 Ye adafruit learning system Power These printers use a thermal head to heat the special receipt paper and draw images and text That makes the printer very small there s no moving ink head but it means they require a lot of power This printer in particular requires 5 to 9 Volts 1 5 Amps current That means you will need a fairly beefy supply and you cannot run it off of USB power An external adapter is required We suggest using the 5V 2A power supply in our shop http adafru it 276 It s got plenty of power to keep the printer happy and you can also use it to run some microcontrollers or sensors off of the remaining 500 mA current that is not required by the printer A quick way to power the printer is by just using a 2 1mm jack adapter http adafru it 368 which you can attach to the printer s red black wires Adafruit Industries h
12. racters Others are very flexible and take nearly any character input Please check out the wikipedia list detailing kinds of barcodes http adafru it aPq to pick the right one for your application It s also possible to print QR codes if you re willing to pre generate them This might be handy if you want to let s say include a URL on the receipt and the URL doesn t change You can generate QR codes at many sites including this one http adafru it aPr Use the smallest QR code size The image will be in PNG format so if you re using the Windows LCD Assistant tool you ll need to convert it to BMP first Windows Paint works for this Then you can convert and embed this in your Arduino sketch as previously described n 47 u TI d u Adafruit Adafruit Industries http learn adafruit com mini thermal receipt printer Page 18 of 19 Ye adafruit learning system Downloads e Adafruit Thermal library for Arduino http adafru it aHt e NewSoftSerial library http adafru it aM7 needed ONLY if you re using Arduino 0023 or earlier not 1 0 or later e LCD Assistant http adafru it aPs optional bitmap conversion utility for Windows e Processing http adafru it aMI language needed for bitmap conversion for Mac or Linux and optionally Windows DOWNLOAD VERSION 1 5 1 not the 2 0 beta e Thermal Printer User Manual http adafru it aPu e Thermal Printer Product Sheet http adafru it aPv
13. ttp learn adafruit com mini thermal receipt printer Page 5 of 19 Adafruit Industries http learn adafruit com mini thermal receipt printer Page 6 of 19 Ye adafruit learning system First Test The first test you should do is to just make sure that the printer is running and you have the power wired up right First up pull the little plastic tab up top to open up the paper holder Then insert a roll of 57 5mm 2 1 4 inches thermal paper into the bay as shown below The optimal length of the paper will be 50 feet about 15 meters so try to pick up that size Sometimes if you buy paper from an office supply shop its a little longer around 80 or 85 feet in which case you ll need to remove paper from the roll until its 1 5 40mm in diameter and fits easily Make sure that the paper doesn t bind or stick in the bay it should rotate freely As previously described power the printer using a 5V to 9V 1 5A or higher power supply such as wiring up a 2 1mm DC power jack Adafruit Industries http learn adafruit com mini thermal receipt printer Page 7 of 19 Hold down the button on the top of the printer while plugging in the power You should see a receipt print out showing the font table and some diagnostics Qo z OA o oo c JU REEL eft EEE cepe T cot Fo f If you don t get a printout check that the paper is inserted correctly and not binding that the power is correctly wired power supply is plugged in etc Th
14. ve adafruit learning system Mini Thermal Receipt Printer Guide Contents Guide Contents Overview Power First Test Microcontroller Printing Text Bitmap Printing Windows Mac and Linux Barcode Printing Downloads Adafruit Industries http learn adafruit com mini thermal receipt printer AW N 13 14 14 16 18 19 Page 2 of 19 Ye adafruit learning system Overview Add a mini printer to any microcontroller project with this very cute thermal printer Also known as receipt printers they re what you see at the ATM or grocery store Now you can embed a little printer of your own into an enclosure This printer is ideal for interfacing with a microcontroller you simply need a 3 3V to 5V TTL serial output from your microcontroller to print text barcodes bitmap graphics even a QR code This printer uses very common 2 25 wide thermal paper available in the Adafruit shop http adafru it 599 or any office or stationery supply store Up to 50 feet of paper can fit in the bay You will also need a 5 Voltto 9 Volt regulated DC power supply that can provide 1 5 Amps or more during high current printing our 5V 2A power supply will work very nicely http adafru it 276 You can pick up a thermal printer pack including printer paper power supply and terminal block adapter in the Adafruit shop http adafru it 600 Of course we wouldn t leave you with a datasheet and a good luck this tutorial and match
Download Pdf Manuals
Related Search