![](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEARgBGAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAMDAlQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD3+iiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAoqnqUepS26rpd3aW0+8FnurZp1K4PAVZEIOcc57HjnjL+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqj7H4w/6Duh/+Cab/AOSqAOgorn/sfjD/AKDuh/8Agmm/+SqPsfjD/oO6H/4Jpv8A5KoA6Ciuf+x+MP8AoO6H/wCCab/5Ko+x+MP+g7of/gmm/wDkqgDoKK5/7H4w/wCg7of/AIJpv/kqrFjbeJI7yNr/AFXSp7UZ3xwaZJE7cHGGM7Ac4/hPpx1oA2KKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKAKepWU99brFb6nd6e4cMZbVYmYjB+U+YjjHOemeBz1zl/8I9qn/Q565/35sv8A5HroKKAOf/4R7VP+hz1z/vzZf/I9H/CPap/0Oeuf9+bL/wCR66CigDn/APhHtU/6HPXP+/Nl/wDI9H/CPap/0Oeuf9+bL/5HroKKAOf/AOEe1T/oc9c/782X/wAj0f8ACPap/wBDnrn/AH5sv/keugooA5//AIR7VP8Aoc9c/wC/Nl/8j0f8I9qn/Q565/35sv8A5HroKKAOf/4R7VP+hz1z/vzZf/I9H/CPap/0Oeuf9+bL/wCR66CigDn/APhHtU/6HPXP+/Nl/wDI9H/CPap/0Oeuf9+bL/5HroKKAOf/AOEe1T/oc9c/782X/wAj0f8ACPap/wBDnrn/AH5sv/keugooA5//AIR7VP8Aoc9c/wC/Nl/8j0f8I9qn/Q565/35sv8A5HroKKAOf/4R7VP+hz1z/vzZf/I9H/CPap/0Oeuf9+bL/wCR66CigDn/APhHtU/6HPXP+/Nl/wDI9H/CPap/0Oeuf9+bL/5HroKKAOf/AOEe1T/oc9c/782X/wAj0f8ACPap/wBDnrn/AH5sv/keugooA5//AIR7VP8Aoc9c/wC/Nl/8j0f8I9qn/Q565/35sv8A5HroKKAOf/4R7VP+hz1z/vzZf/I9H/CPap/0Oeuf9+bL/wCR66CigDn/APhHtU/6HPXP+/Nl/wDI9H/CPap/0Oeuf9+bL/5HroKKAOf/AOEe1T/oc9c/782X/wAj0f8ACPap/wBD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)
UG_12xxF_016 73S12xxF Software User Guide
R ev. 1.50 3
Table of Contents
1 Introduction ................................................................................................................................... 5
1.1 Acronyms ................................................................................................................................ 5
1.2 U se of t his D ocument............................................................................................................... 6
1.3 Statement of Compliance ......................................................................................................... 6
2 Design Guide ................................................................................................................................. 7
2.1 D evelopment E nvironment ...................................................................................................... 7
2.1.1 Hardware Requi r ements .............................................................................................. 7
2.1.2 Software Requir ements ............................................................................................... 7
2.2 Software B uil d Environment ..................................................................................................... 8
2.2.1 Software Architecture .................................................................................................. 8
2.2.2 AP I/ Libr ar y and Header Files ..................................................................................... 10
2.2.3 External Appl i cati on ................................................................................................... 11
2.2.4 Em bedded Application .............................................................................................. 11
2.2.5 Build Environment with the Seri al Boot Loader .......................................................... 11
2.2.6 Build Environm ent with the USB DF U Boot Loader .................................................... 14
3 Te sting E nvironme nt ................................................................................................................... 17
3.1 EM V Level I Compl iant Testing .............................................................................................. 17
3.2 CCI D Testin g ......................................................................................................................... 17
3.2.1 USB Testing: Microsoft HCT/DTM, and USB Command Verifier ................................ 17
3.2.2 Serial Testing ............................................................................................................ 18
4 Design Reference ........................................................................................................................ 19
4.1 Memory Map .......................................................................................................................... 19
4.1.1 Progr am Memory ....................................................................................................... 19
4.1.2 External D ata M emory ............................................................................................... 20
4.1.3 Internal Data Memory ................................................................................................ 20
4.2 Low-level A PI ......................................................................................................................... 20
4.2.1 Keyboar d Driver API – A vailable with all 73S12 xxF Devices ....................................... 21
4.2.2 LCD Driver API – Availabl e with all 73S12xxF Devices .............................................. 23
4.2.3 LED Driver AP I – A vailable with all 73S12 xxF Devices............................................... 24
4.2.4 Real Time Clock AP I - Available with the 68-pin 73S12xxF ....................................... 26
4.2.5 Smar t Card Interface Dri ver API – Available with all 73S1 2xxF Devices ..................... 30
4.2.6 SERIAL (RS232) Dri ver API – Available with all 73S12 xxF Devices ........................... 39
4.2.7 USB API – Available with 64K Flash version of the 73S12xxF ................................... 42
4.2.8 Clock Gener ator Cir cuit API – Available with all 73S12 xxF Devices ........................... 51
4.2.9 Power Man agement API – Available wit h all 7 3S12 xxF Devices ................................ 52
4.2.10 Analog Threshold M anagement D r i ver API – Available with all 73S12 xxF Devices ..... 53
4.2.11 Event Management API – Available with all 73 S12xxF Devices ................................. 55
4.2.12 Timers API – A vailable with all 73S12 xxF Devices ..................................................... 57
4.2.13 User IO API – Available with all 73S12 xxF Devices ................................................... 58
4.2.14 External Interrupts API – Available with all 73S12 xxF Devices ................................... 60
4.2.15 Special Function R egister API – A vailable with all 73S12 xxF Devices ........................ 61
4.2.16 Flash/M emory API – Available with all 73 S12xxF Devices.......................................... 63
4.2.17 Boot Loader and Passcode M anagement – Available with the LAPI-*BL. lib Only ....... 67
4.2.18 Secur ity Mode Management - Available with the LAPI -*BL.lib Only ........................... 69
4.2.19 Other Mi scell aneous API Calls – Available with all 7 3S12xxF Devices ....................... 71
4.3 High-L evel AP I ....................................................................................................................... 72
4.3.1 Smar t Card Contr ol ................................................................................................... 72
4.4 F lash Pr ogrammi ng ............................................................................................................... 85