Get Started

The documentation presented is for handling data stored on RFID / NFC contactless cards, key fobs, stickers,..

Data Format

Mcard data format contents is formated as follows: Data is delimited by ASCII code 254 (▪). Fields are delimited by ASCII code 13.
Card contents begin after the header data followed by ASCII code 13 (first line of data).
Each line of data represents a pair key, value of data as follows:
  key:values
when key has is an array of values the notation to follow is:
  key:[value 1, value 2, ...]

Field Short Description Default value
Header Fields
Expire Data Expire data for the Contact card
(0=false, other=YYYYMMDD)
0 or YYYYMMDD
Encrypted Contact card data is encrypted
(boolean 0/1, other= ecryption standard)
0/1 or AES256
Access password Contact card requires password
(0=false, other=password)
0 or string
update Contact card is updatable
(boolean 0/1)
1
metrics (default SI) contact card metrics units  
language (default EN) contact card two digit international language code  
Custom Fields
field key string▪font name 1,font name 2▪x coord , y coord  
Typical Card Fields
Card holder Photo / Logo (i key) i:binary data▪x coord, y coord  
Card background Layout (b key) b:binary data  
Card holder name (n key) n:string▪font name 1,font name 2▪x coord , y coord  
Card holder address (a key) a:string▪font name 1,font name 2▪x coord , y coord  
Card holder phone number (t key) t:string▪font name 1,font name 2▪x coord , y coord  
Card holder email (@ key) @:string▪font name 1,font name 2▪x coord , y coord  
Card holder website (w key) w:string▪font name 1,font name 2▪x coord , y coord  
Security Features
Access code (ac key)

ac:code▪begin timestamp▪end timestamp▪latitude▪longitude▪radius

code: string
begin,end: YYYYMMDDHHMM+-HHMM, YYYYMMDDHHMM+-HHMM
latitude, longitude: float number
radius: integer (meters)

for multiple locations use array notation [ location 1, location 2]

 
Custom Data Storage
data storage (ds key) ds:string
 

You can define your own custom data fields following the custom field format (key:value). where key can be any string (preferably 1 char) and value needs to be formated as "string▪font name 1,font name 2▪x coord , y coord".

You can also store binary data using the key "ds".


Basic Header Examples

date:2020/12/08, encrypted:true, access password: false, updatable:true

              
                    20201208▪1▪1▪1
              
            

date:2020/12/08, encrypted:true, access password: 12345, updatable:false

              
                    20201208▪1▪12345▪0
              
            

date:2020/12/08, encrypted:AES256, access password: 12345, updatable:false

              
                    20201208▪AES256▪12345▪0
              
            

date:2020/12/08, encrypted:AES256, access password: 12345, updatable:false, metrics: SI, language:dutch

              
                    20201208▪AES256▪12345▪0▪SI▪NL
              
            

Contact Card Examples

Expire date:20201208, encrypted: true, password:12345, updatable:true
photo: 97 f2 99 97 77 73 6c 25 85 9d at coordinates (x,y): 50,40
background image: 97 f2 99 97 77 73 6c 25 85 9d
name: Miguel Tomás Silva at coordinates (x,y): 50,40
email: dummy@mail.com at coordinates (x,y): 50,40
address: Road to nowhere,32 at coordinates (x,y): 50,40
telephone number: +32 475 981 123 at coordinates (x,y): 50,40
website: http://www.dummysite.com at coordinates (x,y): 50,40

              
                 20201208▪1▪12345▪0
                 i:97 f2 99 97 77 73 6c 25 85 9d▪50,40
                 b:97 f2 99 97 77 73 6c 25 85 9d
                 n:Miguel Tomás Silva▪Helvetica,sans-serif▪50,40
                 @:dummy@mail.com▪Helvetica,sans-serif▪50,40
                 a:Road to nowhere,32▪Helvetica,sans-serif▪50,40
                 t:+32 475 981 123▪Helvetica,sans-serif▪50,40
				 w:http://www.dummysite.com▪Helvetica,sans-serif▪50,40
              
            

with location aware security:
access code / password: 12345
validity: from 200704050930-0200 to 200704051130-0200
latitude,longitude: 0.34,104.23
radius: 400m

              
                 2020/12/08▪1▪12345▪0
                 i:97 f2 99 97 77 73 6c 25 85 9d▪50,40
                 b:97 f2 99 97 77 73 6c 25 85 9d
                 n:Miguel Tomás Silva▪Helvetica,sans-serif▪50,40
                 @:dummy@mail.com▪Helvetica,sans-serif▪50,40
                 a:Road to nowhere,32▪Helvetica,sans-serif▪50,40
                 t:+32 475 981 123▪Helvetica,sans-serif▪50,40
				 w:http://www.dummysite.com▪Helvetica,sans-serif▪50,40
             	 ac:12345▪200704050930-0200,200704051130-0200▪0.34,104.23▪400
              
            

Additional Notes

none.


Known Issues

none.