User Tools

Site Tools


digispark:tutorials:hm10ancs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

digispark:tutorials:hm10ancs [2016/06/09 12:03] (current)
Line 1: Line 1:
 +====== ANCS with HM-10 Module (adapted from HMSoft instructions)====== 
 +1. How to open ANCS function 
 +  1.1 Please read apple notification document first: {{:​digispark:​tutorials:​applenotificationcenterservicespecification.pdf|}} and HM-10 datasheet for commands referenced below: {{:​digispark:​tutorials:​bluetooth40_en.pdf|}} 
 +  1.2 Send AT+TYPE3 command change to AUTH and BOND mode. 
 +  1.3 Send AT+ANCS1 command to open ANCS. 
 +  1.4 Send AT+PASS[para1] command to set passcode. Default passcode is "​000000"​ 
 +  1.5 Send AT+RESET to restart module. 
 +  Scan and connect with module. 
 +  iOS will ask you input passcode. please input your passcode value. 
 +  If all is okay,  you should receive AT+ANCS[para1] command from module UART. 
 +2. About AT+ANCS[para1] command 
 +  AT+ANCSN: module open Notification Source SUCCESSED. 
 +  AT+ANCSC: module open Control Point SUCCESSED. 
 +  AT+ANCSD: module open Data Source SUCCESSED. 
 +3. Get ANCS notification information 
 +  When iOS notification center has an change (such as call, email, shortmessage) 
 +  Module will output AT+ANCS8[para2] command through UART. 
 +4. About AT+ANCS8[para2] command. 
 +   ​Format such as : AT+ANCS801012345 
 +       8: The length of the para1. 
 +       0: EventID. 
 +          EventIDNotificationAdded = 0, 
 +          EventIDNotificationModified = 1, 
 +          EventIDNotificationRemoved = 2, 
 +          Reserved EventID values = 3¨C255 
 +       1: CategoryID. 
 +          CategoryIDOther = 0, 
 +          CategoryIDIncomingCall = 1, 
 +          CategoryIDMissedCall = 2, 
 +          CategoryIDVoicemail = 3, 
 +          CategoryIDSocial = 4, 
 +          CategoryIDSchedule = 5, 
 +          CategoryIDEmail = 6, 
 +          CategoryIDNews = 7, 
 +          CategoryIDHealthAndFitness = 8, 
 +          CategoryIDBusinessAndFinance = 9, 
 +          CategoryIDLocation = 10, 
 +          CategoryIDEntertainment = 11, 
 +          Reserved CategoryID values = 12¨C255 
 +      01: CategoryCount 
 +          The current number of active iOS notifications in the given category.  
 +          For example, if two unread emails are sitting in a user¡¯s email inbox,  
 +          and a new email is pushed to the user¡¯s iOS device, the value of CategoryCount is 3. 
 +    2345: NotificationUID 
 +          A 32-bit numerical value that is the unique identifier (UID) for the iOS notification.  
 +          This value can be used as a handle in commands sent to the Control Point characteristic  
 +          to retrieve more information about the iOS notification. 
 +5. Get Notification Attributes 
 +   ​AT+ANCS[para1][para2][para3] 
 +   ​Format such as: AT+ANCS2345100 
 +   ​para1:​ NotificationUID. 
 +   ​Para2:​ NotificationAttributeID 
 +          NotificationAttributeIDAppIdentifier = 0, 
 +          NotificationAttributeIDTitle = 1, (Needs to be followed by a 2-bytes max length parameter) 
 +          NotificationAttributeIDSubtitle = 2, (Needs to be followed by a 2-bytes max length parameter) 
 +          NotificationAttributeIDMessage = 3, (Needs to be followed by a 2-bytes max length parameter) 
 +          NotificationAttributeIDMessageSize = 4, 
 +          NotificationAttributeIDDate = 5, 
 +          Reserved NotificationAttributeID values = 6¨C255 
 +   ​Para3:​ max length parameter 
 +          If para2 value is 0, 4, 5, para3 must set to "​00"​ 
 +          if para2 value is 1, 2, 3, you need setup a number. 
 +6. Aoubt Get Notification Attributes Response 
 +   ​AT+ANCSW:​ Send request SUCCESSED. 
 +   ​AT+ANCS[para1]:​  
 +   para1 value is 0x00 ~ 0x14. 
 +   Mean the next package length you need to receive. 
 +   ​[........]:​ The byte array you need to receive. 
 +               Show in apple Notification document Figure 2-6. (page 9) 
 +   After you receive AT+ANCSW, you may receive AT+ANCS[para1] many times. until the Fingure 2-6 package is completed. 
 +7. How to remove ANCS. 
 +   7.1 Remove connection information from iOS. 
 +   7.2 Execute AT+ERASE to remove module connection information. 
 +   7.3 Execute AT+ANCS0 close module ANCS function. 
 +   7.4 Execute AT+RESET to restart module.
digispark/tutorials/hm10ancs.txt · Last modified: 2016/06/09 12:03 (external edit)