/********************************************** * CONFIDENTIAL AND PROPRIETARY * * The information contained herein is the confidential and the exclusive property of * ZIH Corp. This document, and the information contained herein, shall not be copied, reproduced, published, * displayed or distributed, in whole or in part, in any medium, by any means, for any purpose without the express * written consent of ZIH Corp. * * Copyright ZIH Corp. 2012 * * ALL RIGHTS RESERVED ***********************************************/ /** * A connection to a Zebra printer. */ @protocol ZebraPrinterConnection /** * See the classes which implement this method for the format of the description string. * * @return The connection description string. */ - (NSString *)toString; /** * Returns the maximum time, in milliseconds, to wait for any data to be received. * * @return The maximum time, in milliseconds, to wait for any data to be received. */ - (NSInteger) getMaxTimeoutForRead; /** * Returns the maximum time, in milliseconds, to wait between reads after the initial read. * * @return The maximum time, in milliseconds, to wait between reads after the initial read. */ - (NSInteger) getTimeToWaitForMoreData; /** * Returns YES if the connection is open. * * @return YES if this connection is open. */ - (BOOL) isConnected; /** * Opens the connection to a device. If the ZebraPrinterConnection::open method is called on an open connection * this call is ignored. When a handle to the connection is no longer needed, call ZebraPrinterConnection::close * to free up system resources. * * @return NO if the connection cannot be established. */ - (BOOL) open; /** * Closes this connection and releases any system resources associated with the connection. If the connection is * already closed then invoking this method has no effect. */ - (void) close; /** * Writes the number of bytes from data to the connection. The connection must be * open before this method is called. If ZebraPrinterConnection::write:error: is called when a connection is closed, -1 is returned. * * @param data The data. * @param error Will be set to the error that occured. * @return The number of bytes written or -1 if an error occurred. */ - (NSInteger) write:(NSData *)data error:(NSError **)error; /** * Reads all the available data from the connection. This call is non-blocking. * * @param error Will be set to the error that occured. * @return The bytes read from the connection or nil if an error occurred. */ - (NSData *)read: (NSError**)error; /** * Returns YES if at least one byte is available for reading from this connection. * * @return YES if there is data avaiilable. */ - (BOOL) hasBytesAvailable; /** * Causes the currently executing thread to sleep until hasBytesAvailable equals YES, or for a maximum of * maxTimeout milliseconds. * * @param maxTimeout Maximum time in milliseconds to wait for an initial response from the printer. */ - (void) waitForData: (NSInteger)maxTimeout; @end /*! \mainpage Zebra API * Provides classes for interfacing with Zebra printers from an Apple® mobile digital device.

* I want to... * \li Add ZSDK_API.a to my development environment project * \li \link TcpPrinterConnection Print over TCP/IP\endlink * \li \link MfiBtPrinterConnection Print over Bluetooth\endlink * \li \link FormatUtil Create and print formats\endlink * \li \link FileUtil Send files to the printer\endlink * \li \link PrinterStatus Query printer status\endlink * \li \link GraphicsUtil Print graphics\endlink * \li \link MagCardReader Read a magnetic stripe\endlink * \li \link SmartCardReader Read a smart card\endlink * \li Find more information * * Tips for developing with this API... *
    *
  1. As a best pracitce, Zebra recommends not making calls to our API from the GUI thread. Use Grand Central Dispatch to accomplish this.
    2. *
  2. Only Mobile printers are available with built-in magnetic card readers
    3. *
  3. Each ZebraPrinterConnection object should only be used on a single thread
    4. *
  4. In iOS 9, a new Build Variant “Enable Bitcode” was introduced. This variant is initially set to “Yes” which may cause any project using the ZSDK_API to not build properly.
    5. *
* * Project Settings and Configuration * */