This page contains the following information about the QR code labels required for Afero products. You will need this information in the prototyping and manufacturing processes.
Each Afero smart product requires two QR code labels:
During product onboarding, customers scan the QR code label using the Afero mobile app. This adds the customer’s smart device to the customer’s Afero account, and the product icon and name appear on the Home screen of the mobile app as an entry point for device control.
This use requires the following of the label:
An example large QR code label is illustrated below:
The smaller label is attached to the product PCB that is running the Afero firmware:
An example small QR code label is illustrated below:
The Afero Factory Programmer (AFP2) prints both the large and small QR code labels.
The Afero Factory Test verifies that the QR code labels are printed correctly.
For more technical details of our QR codes, read the section below, Generating QR Codes for Afero Products.
The AFP2 package includes .json files that define the elements of the QR code plus text label. The reference code in these files is compatible with Zebra printers (ZPL format) and is commented for ease of use.
By default, the following configuration is defined in the reference code:
If the print job settings require customization, the operator can do that in the correct .json file, found in the Factory Programmer package,
targets\labels\ directory. An abbreviated file shown below:
Print Components description (select which components are to be printed here) True or False aId (association ID) TRUE (Mandatory) dId (device ID) TRUE (Mandatory) qr (QR code) TRUE (Mandatory) fcc (FCC ID) (Optional) pn (Part Number) (Optional) blobs (Optional Graphical elements such as lines or logos) Printer description (Printer and Printing Configuration) printer_dpi (600/300/200) v_align_dots (Used to fine tune vertical placement. Value from -120 to 120) h_align_dots (Used to fine tune vertical placement. Value from -120 to 120) print_darkness (Used to set print darkness. Value from 0-30) print_rate (Inches per minute. Value from 1-4) copies (Number of copies to print) Label description (Information on label loaded in the printer) inches width_inches (Width of label in inches) height_inches (Height of label in inches) QR code description (Code information) magnification (Size of printed QR code. Value from 1-10) x_coord (Coordinate of the left edge of the QR code in DOTS) y_coord (Coordinate of the bottom edge of the QR code in DOTS) Assn ID description (Association ID information) font_type (Zebra built in fonts: A,B,D E,F,G,H,O,P,Q,R,S,T,U,V) font_width (Printed width of the font in DOTS) font_height (Printed height of the font in DOTS) line_spacing (Spacing between the two lines of association ID) char_chunk_size (Number of characters in each printed chunk) chunks_per_line (Number of character chunks per line) hyphen_font_type (Zebra built in fonts: A,B,D E,F,G,H,O,P,Q,R,S,T,U,V) hyphen_font_width (Printed width of each font in DOTS) hyphen_font_height (Printed height of each font in DOTS) x_coord: (x coordinate of the left edge of the association ID in DOTS) y_coord: (y coordinate of the bottom edge of the association ID in DOTS)
This section contains instructions for generating the QR codes that will be printed on the labels, for:
Unless explicitly instructed otherwise, assume you will be generating the latest QR code version.
The current QR code for an Afero enabled device contains three pieces of information:
There is a colon delimiter character (:) between each piece of information. We will refer to these three pieces of information (including the delimiters) as the “Payload”.
|Data Size (bytes)||Data Encoding within Payload||Number of Alphanumeric Characters
|Payload Version Number||0.5
|HEXIDECIMAL||1||1||The only valid Payload Version Number is 1. Other values are reserved for future use and are not valid.|
When using the Payload to generate a QR code, the following QR code parameters should be used. (Additional information about QR codes can be found at https://en.wikipedia.org/wiki/QR_code.)
|QR Code Version||3||Version 3 QR codes are 29x29 modules in size.|
|Error Correction||Q||Quartile-level error correction allows for 25% of the codewords to be restored.|
|Input Mode||Alphanumeric||Supports all hex-encoded characters (0-9, A-F) as well as the colon (:) delimiter.|
|QR Code Minimum Print Dimensions (excluding border)||17.19 x 17.19mm||The minimum printed dimensions ensures high-reliability scanning by a variety of smartphone cameras in differing light conditions. The minimum dimensions of 17.19mm2 has a size of 0.593mm2 per module within the QR code.|
|Minimum QR Border Thickness||0.593mm||Best practice is to leave a border around the QR code that is at least one module thick. In the case of a QR code that is 17.19mm2, each module within the QR code is 0.593mm2; therefore, the minimum border thickness around the QR code should also be 0.593mm.|
In addition to a QR code (containing the Payload) each label is also required to contain a plain-text version of the Association ID. This can be used for manual-entry by a user in the case that the QR code is unusable (e.g., QR code is damaged, camera on phone is not working). The plain-text ID consists of the 24 characters of the hex-encoded Association ID broken up into six distinct four-character blocks. Each character block is separated by a hyphen.
|Example QR Payload||1:ABCDEF1234567890ABCDEF12:1234567890ABCDEF|
|Example QR Code|
|Example Plain Text Association ID||ABCD-EF12-3456-7890-ABCD-EF12|
Older ASR-1 modules use a QR code that encodes only one piece of information: the ASR-1 Association ID.
Here is an example of one Association ID in its various formats:
Every label must include the following two pieces of information: 1) the QR code, and 2) a plain-text version of the Association ID. The code can optionally include other information, such as an FCC ID.