developer and user guide 1.0 (pdf)

88
!"#

Transcript of developer and user guide 1.0 (pdf)

Page 1: developer and user guide 1.0 (pdf)

��

���������������� ���������������������

�������������� ��������������������������������� ����������������������������� ���������������������

��������������� ����������������������������������������������������

������� !"� #�

Page 2: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

�� ����

� �!"#$%&'��!("���������������������������������������������������������������������������������������������������� ��

) �%��*#!+%�������������������������������������������������������������������������������������������������������������� ��

, �#*�"%-%�./�'#!-!0/&/��������������������������������������������������������������������������� ���

� , ���-'*#%%#1���������������������������������������������������������������������������������������������������� ���

� , )������������������������������������������������������������������������������������������������������������������������ ���

� , ,��$23) �������������������������������������������������������������������������������������������������������������� � �

� ��, , ���/$#*�/4�&*�'�$!�!*"#%������������������������������������������������������������ ���

� ��, , )��/$#*��4�/&�!"!#$/�!("�&*�&!�%!#!+%���������������������� !��

�� ��, , ,��/$#*��4��%�'"!�/�!("���������������������������������������������������������������� ���

5 �$*/-!0/�!("�&*-��$%6*�#%���������������������������������������������������������������������� �"�

� 5 ���� ��� ��������������������������������������������������������������������������������������������������������� �"�

� ��5 � �� ��� 7 ��� �������/�!�������������������������������������������������������������������������� �"�

� ��5 � )�*���8������ ������������������ ���������������������������������������������� ���

� ��5 � ,�9��:������������ � ���������;���������������������������������������������� �#�

� ��5 � 5���<����� ���� ��������������� ������������������������������������������������ �#�

� ��5 � =�������� ��������� ������������������������������������������������������������������������� ��

� 5 )�&!*>%������������������������������������������������������������������������������������������������������������ ��

� ��5 ) ��9%$�/#%�&*�-%��/?'*#* ���������������������������������������������������������� ��

� ��5 ) )�/$?'!#*�#'$/������������������������������������������������������������������������������������� �

� ��5 ) ,�&!*>%�*"��/�/ ������������������������������������������������������������������������������� "��

� ����5 ) , /@��/�/�'-9/$A������������������������������������������������������������������������������ ""�

� ����5 ) , �@��/�/�'-9/$A�1/#������������������������������������������������������������������� ���

� ����5 ) , �@��/�/��1/#�)�*�6��)* ������������������������������������������������������������ ���

= ��%"�-'!%"* �������������������������������������������������������������������������������������������������� ���

B ��!�-!%�$/9./����������������������������������������������������������������������������������������������������� ���

Page 3: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !�

��� ����!��"��#��

*�� ���� � ��� ���� �� ����� ���� ��� ��� ����� ������C� ���

���� ��� ����������������� �6���������������� ��������C�����

;��������������� �������� �

?��������<�������C�����������C������������7������������

* # � ��� !�<�� ������ ��� !�7���� ��� �� #������� ��� ��C� ���

���������������<� �����D �<�� E�������� ����������D �<�� ��E ��

*���� �������� ;������� ���� ���� <��� ��� �� ����� ��� ��� ������

������������������ ������� ��� ���C������� ���������7�� ��������

�������������<� ���������������F������������;���������� � �

9 ��������C������� F��� <� ����������� � ��C�<��� ��������������

7�� � ��� �� �� <�C� ��� ������ � ������ ��� ��� ���� ��� ��� ���������

������������������ �� �

&�������� ����� �� �

Page 4: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

$%������ �������

*�� �������� ���<��������������� ��������� �����<������ �����

�������������� ���� �/������������������� ���������7������� ����

���������������� � � ��������7������������ � ����������C�� ��;�������

��������� ���� ������ ���� ;��� ��� �G�� �� ������� �����<���� �� ���

���� �����C� ��� �������� ��� 7��C� ������������ ��� ��,� ��

�����<��� �������� �������� ����� ���� �� ���� <���� � /��� � ��C� ���

���� ����� ������� ��� ������� ��� ���������� ����� ���C� �&/�� �� ���

��<�������������<��� ������� ������������������������ ������;������

�� ����� ;� ���� ������ ��� ��� ��� � ��� ������< �� �� ����� �� ��

��������������������� ��� ���� �� ���� ��

*:�������������������� ������� ����������������������+ ������

!������� �� ��� ��� '� ���� ���� ��� �������� ������ ��� �����<��� �##�

H�����#�#��I@��J���� ���������C����������������<�����������K 2

9 ������������������<������������ � �������9%"C����� � � �� ���

����������� ������������������������������ ������� ����� ������ �-��

�����<�������7����C� � � ���������� ���������������7 � � ��C�������

��� �������� ��� ��� ���� ��� ��� ����� ������ ��� ��� ����C� ���

����;� �����<������������;� �������� �

'���������������<����;����������� � ������������ ����������

�����<��� �������C� ;��� ���� ��� ��� ���� ��� ��� � �� ������� ������

� ��� � ��� ��� ���C� ���;��� ��� � ����� ��� �� ����� ���� �� �LL�

����� � ����� ���� ���� ����� �����<��� ��� ����� ���������� ��� ���

���������� �����C������� ����� ��������� ��� �����������������C�

���� � �� �����<� ��� ��� �� ����� � ���� ���������� ���� �� �

����� ������������� � ��� ����������������������� ����� ����������

�������� � ��� ���� ��� ��� ���� � ��� � ��C� � �� ���<��� ��

Page 5: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �

������������������ ��� ���D ������� ��EC������� �-��7 ��� �������

������������������������� ������;������� ���������� ��� ���������

� ��� � ����������C�����������������7�� ����������;������� ���

��� ����� ��� �����:��� ������ ��� �� � ��� � ��� ���� � ���� ����

���� ��� ���7�� ���� ���������<�� ��

-��������:��������������������C�����:����4�

$ '�� ��� ����� �4� ��� �:����C� ����� ;��� ��� ��

����� ���������� � ������������� <������C����������������������

����:��� � ������� �����������<J���������:��� � �/������

��� ��7���� ������ �������� ��� �� ����� �� ��� ��� ������C�

���� �������� ������C��������J�;�����M�

$ ���� ��� ��� ��� ���� �������4� &�� �� �� ;��� ��� ��� ���

����������<������<���� �C������������������������ ������

������ ��� ������ ����;� ��� ������ ��� ��� �������� � �� ������

����� �� �

$ %� 4���������������������G�������������������������

������� �� ������� ��� ��� ���C� ���� ��� � ��:��<�� ���� 2

:�<����

*����������������:�����������;������������� ��������������

����� �1���;������ ��;������ �����<�������������������� ����

����� ���� ���� �� ;��� ����� �������� ���� ��� ����� �� ��� ����7����

��� �������������������������� ��� � �������;��������������G� ��

*������������������������C�'�7���IC�� <� 7 ���D� ���&��-�EC�

������ ;��� ��� ����� � ���� � �� ��� <�������� ���� ��C� ��� ���

�����:���������������������C�������������������<������F��;���

�� 7 ��������� �����������C��������������<�� �

'�7���I����������������������;������� ����������� ��� ���7�� ��

������� ��� � �����������H���������C����F7������ ���C��&/�M@�

Page 6: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "�

;�������������� �1������� � ���� � ������������<��:����� �������

������ 7�� � ���� ;��� �������� ��� �� � ��� ��� �� ;��� ���� � ��� ���

����� ���������� ��7 �������� ��� ��������������������������� �

*������������� ������;���������������������� ��� � ������ ����

;��� ������� ����� �� �������� ��� /�!� �$23)C� ������� � ����� ���

����� ��� �� �� � ��� ��� ��� ��� ��� ���� ����� ;��� ��;� ����� ��� ��� ���

�������C���� ���������� ���������� �� � �������<C�����J�������

� ��� � ���;�������� � ������������������� �

-�� 7 ��� ���� ��� ����� ������� ��� ��� ����� ��� ��� ��� ������

������ ��� ����C� ;��� ���� ��� ��� ����� ��� ��� ��� ��� ���� ���

���� ��� ���������� ��� � ��� �������C���������� ����C����������

� ��:��<C� ������� ��� ����� ��� �� � ��� �� ���� ������

����������� � ��� �:����� ��������� ��� ����� ;��� ���� ��� ���

���� ��� ���������������� �������� ���� ������;����������������F� �

Page 7: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

&%���'�������

"������� ����� ��� ��� ������ ���� ��� ��� ��� ;��� �� � ��� ��������

����F���������� ��� ���������� ��� � ������ ��� �

/����������������������������������<�����������4�

$ N?�F�� �������� ��� �������� ����O�

$ N���������7��� ���O�

$ N?�F������ ����8����P������������7����O�

�������� ��� ��� ����� ������ � ��� � ��� ������� � -��

� ��� � ��������������;������������������<������������F7���

��� ���C������;������������������������� ��� �������������������

������� � �� �����<C� ���������� ;��� <������ ���� ��� ����� ;���

���� F��� �������������� ��� � ��C���������C�����:���� �

��(�� ��)"��

'�� ����� ������ � ��� � ��� ������� � '�� � ��� � �� ����� ���

���� ��� �� ���� � ��� ;��� ��� �� �� ������ ��� �������� �� F� � '��� ����

���� ����� ��� ���Q ��C� ��� ���� ��� ��� ��� ���� ����� �������� ����

�����:��������Q� �

�#��#���*�#��

*���� ������<����������;������<������� ��� � �����������

;����� � ������ �*Q ����� �7 � �������� ��� � ���;���������������

�����<��C����������F7������ ����������� ��������C�����������

���������������� � �������<��� �������� ��� � �����������

Page 8: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

��� ��<��������C� �� ������ ��� ;��� �� ��C� �� ��� ��<������ ��� ���

� ���������� �

1���� ������� ��� ��<������ ���F7��� ��� ��� � �� ��������

;��� ��� <����� � ������ ������ ��� ��C� �� ��� ����� � ��� ��� ���

������� ��C����������������<������<��������7���� ���������������

������C� ������� ��<�������� ��� ������� 7�� � � /������ ���� ����

������ ��� ����� ��� ����;� ��� ����� � ���� ��� ;��� � ������� ���

���������C����� F����� �����������;���������� ;����������� �

��"�+ ,���

*Q �������� �����<��:����������<������������ ��� � �����;���

������������� ����������� �

�@ -��<��:��� ��� ���� �� ��� ����� �����4� *�� ����

�� ��� �� ����C� ��� ;��� ��� ������ ��<������ ����� � ��� � ��

��������� <�� �� ��C���F�����;�����������������7������

����J�� � �

)@ �RR4�*��������<��:�������Q���� ����;����������

<���� ���� ���� ��� ��� ��� � �� �����<� ��� � ���� ��� ��� ���

������ "I �� �� �������� ������ �� ��� ��� �� ��� ���F7���

���� <������H���������@�;��� � �������� ������ � ������

����� � �/�����C���� ����� <������7������ � ��P������<����

����������� ������;��������������7�� ����<������� ��� � ���

�������������������<��:� �

,@ ����4� *�� ������� ��� ���� � ��� � ��� ;��� �RR�

H ���������������������� ��� ��� � ������ ��@C��������

����� ��� � ���;����� ��� ���F7������ ����H���������C�

�&/�M@� �� �����<����� ��������������� ���� ��� �6������������

�����:��������������;���������� ���������� ��������������

�����7��� �

Page 9: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � #�

/����� ����;�����;�������� ���������������������������<��������

��� ���<��:�� ��� ��<����� �� � ��� ���� ������ ������ ���� �����

;���7��� ���������� �������� ��� � ���� ��������;����������������

���� �C� �� �� � ������������� <�����������<����� ���%� ������� ��

%�:���C� ��� ����� � ��� 7 ��� ��� �F��� ��� ��� �������� ��� ��� ���

������� ��� ���� �����<����� � /�����C� ����� ��� ��� � �� ��� �������

��� �������<����� �����������C������;��������������������� �

��������������� <�� �

#��� F������ ������������ �������� ��� � ���������������C�

� �������������7�� ������ ��������������� �

Page 10: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

-%�������.���������/� ����

-%$����������

�������� ��� ��� ����� ;��� ��7 ��� ��� ��������� <����� ���

���� ��� ��� ������� ���;����� � � ������������ � ����������������

������� 7���������;� ������ ��������������������� 7������� � �-��

�� �� �������:�� ���;�������������������<� �����������������4�

• 9�� � ������������ ��� �����������;� ������ ������7 :� �

• *� � ����������������������������F��� �

• %7������ ��� �� � � ���� ��� ������ ��;��G��� ������

������� ������7�� � �������� ���� ��� �������������������������

�;� ������������ �

���������

-������� 7 ��� ����������������7 ������������������� ��� ���

�����Q ��S)LA�8��������<���� ������L�������H�� ���������

�LL�@

-��7������� �������� �������;��������:����������������<����) 5�

��) 53����������� ��������������������7������� ������� � � ����

��������� � �����9����&����Q���������Q ������BLL������8��< �-��

������ ��� 7������� �� ��� ���� ������ ��� ����� ��� ST� 7������� ��� ���

����������������U��������� ���������<�� ������������� �

*����������������������H��������� ��������������@���� ���

�P ��� �<����� ��� �������;����� ���������<�����;��������;��������

���<����7������������C�����������������������������������;������

�������C���� ������ 7������������G�����������������������;���� �

Page 11: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

��� ��� ���C� ��� �P ��� �<� ��� � ��� ��� ������ ���� �������� �

������ �#����������������������������H��@C�������������������

������� �� ����������C�������� ���� �������������� ��� ����� �

���������������������������������� �������� �����7����� �����B5�

A�8�� ��� ����� ���� �C� ��� ����� ��� ��7 � ���������� ��������� ����� ���

������ � �������� �'���������������������������� � ����������

S)�� A�8�� ��� ���� � ���� ��� �� =B� A�8�� ��� ��� � ���� ��� ������C� � ��

�����<C�������������Q ����������������� �����������5,)CB�A�8��

���������� ���� ����� ��������������� �F�� � �

-�� ��'� ���� � ��� � �� ��� �����<�� ��� �������� ���� ������� ����

����� ������ ��� �������� ���� � ��� � �� ��7 �� ��C� ����� ����

� ��� 7 ���� ��� ����� �� � ����� ���C� ����� ��� ��'� ��� �:������ ���

�7�P���� ���� ���� - �I� ����<��� ;��� � ���� ��� 7��� ��� ���

���� �������������� ��� � ��������� �����������-�� �

*�������������������� ������������-�������- �I�����<��C����������

����� <� �����4��

2�*������$����� ������&��� ��

2�*���< ��� ��������� � ��� ��

2�&����� ��� ���������Q ��� �

�2�/����� ��� �� ��

2�"�<� �� ����������� ��� ������� ������������ ��

2�&����� ��� �������� ���������������������;����� �2�'� ��� ���

����� ��� � ���������� 77����� �

��0��������� ����������

�"����+���)"� �( ���( �����������(�#�����(+�����1��

Page 12: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

-��� ����������������������������������� � � ������������������4����1���������������������������������H������������� ��������@ �-��!����7������������1���H1������������!����7���4�1�!@����������� ����7����������� �������������������������� �+��������� �<����������;����������� �������������������� �-��� ��������������������������������;������������7 �������������<��� ������� ����������C����-)�/����&��������������������������%�*V �-��� ���������� � � ���������������������������������������� ����������������� <� ����������4�

�.�+�������������(�#� �������(�#��"�( ���( �������������J������������ ����������C����������������

���*�����C�-)�/����&�����������$����������������� $9�%���������������������#���7���� #��� ��� ��������/������� ���C�'&�8#��8!�C�%�*VC�K/��

-������������������������������������������ 7������� ��7�� ��

������������ ����������������� �����������Q �� �*�����������

���������*������H- �I�����<��������4�-��@���������������������

� � �� ��� ��� ���� ������� ������ � ��� � ��� �������� �� ��� � �����

�������� ��� ��<�� ���� ��� ��� ���� ���� ��� �� ��� ������ 7 ��� �� �

-)�/�� ������� ������� ��� ��� ����� ����� �� �� ��� ������ ���� �

���� ���Q�� ������ ��� ��� ���Q ���� ��< ��� �� ���Q ���� �������� ���

���� ������ ����� ��� � -�� ����� ��� /�� � ��� �������� � �����������

������������������������������������ ��������-)�/� �*��&���������

�������������� �7���� �������� ��� � �C����� � �������������� ����

������� � � �$9�%���������������G�������������������������$2

),)� ����� ��� ������ ����� ��� �������C� 7��� ���� ����� ������ ���

���������� ����� ���� � �� ����� ���� ;��� ����� ��� ����� ��� ���

������������� ����� ����7������ � �#��� ��� ���7 ��������G�� ��� ���

������������������������������������ � ������������������������

������������ ��� � ���������� �

/������ ��� ��� ������C� ��� !�� �������� ��� ��7 � �� ���

���7 ���� ������� � '�� ���7 �� �������� ��7 ��� �������� ��������� ���

Page 13: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �!�

����� ������� �� ���� ����������� ���� ����� ��� ��� ��� ���� ����� � '��

� ��� � ����������������������������������7 ��� �

-�� ������ ���7 ���� D<��F� ��E� ��� ��� ���7 ���� ��� /�����

���F� ��H����� ��/��������7 ��C��/�@C�������7 ���������� ��H�� ���

������7 ��C���@C����7 �����/�� ��� ������������� ����������� � ��

H��� ��� & ������� /��� ��� �� ��7 ��C� &/�@C� �� ��� ���7 �� ���

!�������� ����%�:�������F� ���H����� ��%�:����*Q����<����7 ��C�

�%*�@ ��

��� ��������������������

������ ��������� ������������

2���#����"���((����"���3 ���4���5�

Page 14: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*���������������7�P����;��� �������� ��������������������

��� ���� H��� �:����C� ��� ��@� �� ��� ��������� H��� � ��� � ��

��������'�@ �&���������������������F������1�! �

2������ (���"6���"���(��"��� �� ���"��������(�4�&���5�

*�� ��� ����� �J���� ��� ��� � ��� ��� ��� ;��� ���� ��� ����� ������

����� � !������� ��<������ ��� ��� ��;������ �� �������� ��� ���

����C� ���� ��� ���� ���Q�� ��� ��� ������ � ���� ��� ��� ��

����� �������� ����� ��� &�� �� $9�%��C� ��� ������ ��� ���� �����

����� � ������������������C����� �

2����*���� �#��*�����������(�4� �5�

�� �� � ��� ����� ������� �� ���� � � � -� ����������� ����

�������� �

2��7�����

������������ �� ������� ����������������������������� ��

����������������������� �

2� ��(��1�"�� ��"���(� �������(� �����3�� ���"� 4���8� ����

��" ��8����2���5�

�������������� �����G����������������� ��� � ���;���;� �����

�� � ������������� ������������ ����������������� �

2�9���(�##�����##��������(�49��5�

*�� ��� ������ ������� ��� �������� ����� ���� �� ����

����� ����� �$�;� ����;������C�!����'&�����F������������������

� �� �

2��:,����;�1 "���4��<5�

*�� ��� ������ ��� ���� ��� ��� � � �������� ��7 � �� ��� ���

/�� �� ������&����!�7����:��H!�&/@�/�� <����;���K/�C�%�*V�

Page 15: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � � �

7��� ��7 � �� ��� ��� <���C� ���� 7��� ������� ��� ��� !��

������� � *�� J� �� ����� �����7�� �� �:���� ��� ���� ��� ������

� ��� � ��� ������� � %�*V� �� ��;� ���� ;��� #��� �� !�� ���F��

��������������������C��������7��� ���������� ������� �����������

%�*V������#��8!� �

2��(+�����1����=���"� �#+( ���"��������(�4���5�

*������������������ �����������;������� ����������������

������� ���� ������ � ��� ������������C�����:�����*������� �

*��������� ��;������ #��8!�� ��� ��;������ -)�/�� ������ ���

������ � ���������������-)�/� �

2��+! "��"���3 ��� �*�����������(�4�� 5�

*�� ��� ������ ������� �� ����� ����� ��� ��� ����� 7 ��� ���

'� �- ����������<������<���������������� � �� �7���� �����������

��� �� ����7�����������������������C�������C�����������

������ �

����� � �����'�� ��������� 4�������� ����

��9��>8����5�

������ ��� � ���� � ��� � ��� �������� ������ ��� ��� ���<�

����������� ���� ���Q ��C� ��� 7���� ���� ����� ��� �����:� ������� �

*����������������$������������������ ��

'��� � ����� � ���� ��� ��� ������� �� ������ � ���� ������� � *��

�������������� ��� � ��;��� � � ��������Q �� �*��� ��� � ��;������

������� ��� ���Q ��� ������ �������� ��� ��� ����� ��� ������ � -��

�����������8��������������������7 � �� �

Page 16: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �"�

���������"���

N?�F�������� ���������� ��� � ��;� ������ ���������� ����O�*��

��������� �� ������������ ���������� ����������;�����������

��� ��� ��� � ������ ��� <��� ��� �������� � ������ ��� ������

���� � � �� �����<C� � � ��� ��� ��� �������� ������ ���� �����

����������������� ��� � ��������������������������������������

����������������

Page 17: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

������� ����"��

Page 18: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

-%&�' * �

*����������� ������������� �������������������� ��������<��:��

�����<����� ��C�� �����������:������������<����;����������

������������ ���������������� �����������������������J�4�

W� *�� ��� <� 7������ ��� ���<��:�� ����� ��� ��� ���� �� ��� <�

������� � ����������� ��� ���� ����� + ������ ���� ��� H�+�@C� ��� ��

;��������� <������� ������� ������� ����������������7��� �

W� #���� ���� �����<���� ��������� ��� ��:���� ���� � �����

���� ����/�!����� �����������<��:�C��<���������� �� ���������������

��;������:��� ���<���:��� �

' * �&��( �3��!8�"������#�������"�4'&5�

*�������� �������� � ������������������������ �� � *�� �7�P����

�������� ��� � ���� ����� ����������� ���� ��� ��� ��������4� �����

������� �� ����� ���� �:������� ��� ��� �;� �C� � �� ����� �:���������

����� ���� ���� ��� ���������� ��� ������� � ��� �� ��� �� ������

��� �����*����H*������ �������������@ �

' * �&��( �3��!8��� "� ��������"�4'&�5��

*������ � �����������������;������� �����7�������<����� � � �� ���

� < �����������<��:������ �# ��������� <� ����������������� ���4�

$ !��� ���� � � ������������RRC���������������������

���� � ���C� ��� ������ ��� �� ��� ��� �<�� �� ��������� ���

������ �

$ ��� <� ������� ����� ��� ��� �����7���C� ������ ���� ��

��������� ������� � �� �:������� ��� ��� �� ����� ��� ���� �+��

H�����+ ���������� ��@ ��

Page 19: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �#�

$ ����� ��� ��<�� ���� � �����%�&������ ���� ��� ���

�+� �

$ /������� ��� ���� � ������ ����� �� ����������� ��� �����

���:��<�����������/�!�������<����� �� �

*�������� �������������� ���������:������� ����������� ������

����������������������������/������C�������������/�!��� ����������

�����<����� ��������� ��� ������������ �7 ���4�!����7���<��7 ������

����� C����� ��� �C�������������� ��� ��C���� �

' * ���

���������7��C�� ���*� � ���������*�H����� ���������� ��

��� ����� )� ����7��C� � ��� *� � �� � �)�*@C� ��� ���� ����� ��� ���

/�!�� ����� ��� ��������� ��� �7�P���� ����� � ��� � ��� ��� ����

�������C� ��� �&/�C� ���F7��� ��� ���� �� � � ����� � ����� �*� ���

7������������������� 7 ��� ��C����;�������F�� �����������������

����� ��7�� ���� �� ���� ���������� ���� ��� ����� ����� 7 ��� ��� ���

� ���� ��� �:���� �� � 9��� ����������� ��:� ��� ����� ����� ���

�����������$�B3 �

*������ � ���� ��������������������� ���;������� 7����� ���

��� ���� ����� ���� ���C� ��� ��� ��� ��� ���� ��;� ��� � ������

���� ����� A+�� HA �� + ������ ���� ��C� ��� �� �� ;��� ��;� ���� ����

��������A �������������� �������7��� ���@���������������������

�+������ ��C� ����� �����������;��G������ �����������������������

������ 7����� �� �

�)�*� ��� ���� ���� ��� ��� ������ ��� ���� /�!�� ��� ���� � *��� ���

��� ����;�������� � ���������������/�!���������������)L���C������

� ��� � �����;��G��� ����������������� ����������� �������

Page 20: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

��������� �� �*��������C��)�*�����,S�������������������7�����)*�

����� ��������������;������:��� ���<C�:��� C�:��� �� � �*����������

������/�!�;��� ������� ����7 :��7���������������;��� ������� ���

D��7 <���� ��E �

�������C��)�*�������������������� ���� ��� 7 ���������)* �

��� ������� ������ ��� ���� ���� ��� ;��� �)�*� ������� �������� �����

� ��� � ������� � ��� �������������������� ����<��7 �� �#��� F��

��������)*�����)**���;��������J�� ���Q <�������� ����������� ����

������������������ �� ���������*8C������:�������C���� ��������C�

����������������������������������7 � ��� � �1�C��)**�������

�������:��������)*��������� �����������7��� ��� �������F������

���� ����������� ���C� ���� ��� �)�*� ��� ��� �����:���� ��� �)*�

H�Q����� ��� ��� ��;����� :���Q � ���� � �@� ��� ;��C� ��� ��� ���

���� ���C���� ������� ���� � ��� ������������������)* �

*Q ������������������� �������� ������)�*����!�������C�����;���

� ���������� ������� ���� ��� �� ���� ������� ���� ���������� ;���

�� � ������� ��� ������� ������C� ���������� ������� ;��� �����

��� �������:�������������������: �

��������������������;�������������������7 ��� �'�����7 ��������

��:���� ��� /�!�� � ������ �� ��� ��� �� ��� ��� ��� ���

������ ��� �-�����7 ���� ���� 7 �������<�������� ��� � ���������

7��� ��� ���� ;��� ����� ���� H��������F�� ��C� ���F7���

%�&�� %���� %����

' � (����������

Page 21: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

��� ���C���� @������� �������� ��� ����;�������:���������������� �-���

� �������������� ����7���<��7 ���������������������� ������������

��� ��7 � � ��� ��� ��� ���7 � � /;��� ��� ������ ��������� <�������

� 7����� ��������� ����7����C�������������J� ��Q����������� ���F7���

��� ����������������� �����������&/� �

��"3��+� ���"�#�

-��� ��7 <���� ���� ��� ������� ��� ���� ��;� ��� � ������ �� ���

��:���� ��� �� ��� � �� ������ ��� 7��� �� � ����� ���� ���

7��� ��� ������� �������������:�������� ��� � ���;������������

����������� ���� � � �����C� ������ ��� <��� ��� ��� ���� �� �

����� � ������������ �

*����������� �����Q ����������7 <���� �����)�*4��

���������- � ����&�� �����7 <���� ��H�-&�@���

���������&�� �����7 <���� ��H�&�@�

��"3��+� ��)"��� ��

*���� ��7 <���� ��� ����� � ��G���� ����� � ��� � ��� ���

���Q ���� ��� ���� ����� ������C� ����������� ������ �� ���� ��

� � ����� ��� ��� ���F7��� ��� ���C� �� �������� ���������� H�&/�@C�

��� � *���� � ������ �� � ��� � ��� ;��� �������� ���� � <� ������

����������� ���4��

�����# ���4�B�� �8�B��1�������

��!��� 4� �BL2=�)� A�� ��� ���� �� ����� � ��� ���� ����� ���

�����7���������

�(�!�"� ��)"4� /� ������ ��� � � ����C� �� ������ ������� ���

��������

�� : ,���"����4������ � ��������<J��� ��������C������������

������� � ������� ����������

-�� ����� 7 ��� ��� �-&�� ��� ��� ����������� ������ ���� �����

����� ��� ������X��Y� H���X��Y@� :���� ��� =LL� ��������� ;���

Page 22: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

������������ �� ���� ������ ��� ��� 7��� ������� ��� � ��� � ��� P ������C�

����������������� � �������� �������������� ��

�������� ������ ���������� ��������7����� ������-&��H�-&��

$�7������� ���������� �C��-&��$!@�;��� ������������;� ���� ������A�

HA� + ������ ���� ��C� A+�@ � ��� ���� F�� ����� ��� ���

���������� ��� ���� �-&�� 1���#�C� � ��� ���� ����� ����

����� �������:�� ���� � ��

*���� ��;� ��� � ������ ����� � ������� �� ��� ������ <������ ��� ���

� ��� � �������������� ����������� ��� ��� �������� �-���-&��

$!� ��� ��������� ����� � ��� � ��� ;��� �������� ���� � <� ������

����������� ���4��

�����# ���4,)�� ���

��!��� 4� =�)� A�8�� ��� ��� ���� �� ����� � ��� ���� ����� ���

�����7���������

�(�!�"� ��)"4� /� ������ ��� � � ����C� �� ������ ������� ���

��������

�� : ,���"����4������ � ��������<J��� ��������C������������

������� � ������� ����������

-����;� ���� ������A��������A����A �����C���� ������7����� ��

����������G�;����������������7���C������� �����SL�A���

*Q �������������� ��������-&�4��

�� �� $%$� H�$� �,T@4� �-&�� � �� ��� ���� ��� � ��� ��� ���

����� 7 ��� ��� �-&�� � L� �� ������� ������� ����������� ���� ��� ���

�����7������������������7����� ����F� �C�:��������������:��� �

�-&��� ���������� ����������� ��������� ������� <�����������

� ��� � �����;��G��������������� � ���� ��

*Q ����� ���������� ���������7����� � ��

�� ��$%?�H�$�,L@�

�� �� �������� �!�(�!�"� ���"��4� *�� ���� ��;� ��� � ������

������ � �����;����������������� 7����� ��������� � �������������

7�����������A+� �!������� ����������� ����;��� ������������:���� ���

Page 23: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �!�

������� ��������� ��� ����������<��� �������������������7 � �����C�

������ ���������;� � �������������������7��������:���� ���

��"3��+� ��)"�� ��

*������7 <���� �������������������������� ��� � ������)����

������������ ��� ��� �����������������7���C� ���������$/����

���� �� 7����� � $%� � *���� � ��� � ��� ��;� ����� ����� ����

����������� ���� �� 7��� ��� ������ ��� ��� �+�� �� �������� ���F7���

��� ���� ��� J�� ��� <������ ��C� �� �������� ���������� H�&/�@C�

���� �����������������������H#�+�@C����������� ������������������

���Q ��� ����� ������ � ��� ����� ���� ���C� � �� �������� HP ������@� �

��������� �-���&�� �������������7 ��9����� ��H9����� ����7 ��@C�

���;���������� ��� �����������7 ������������������������� �������

��� ��� ���;�����;� ��������� ����7���<��7 ����������� � �����:���

K�� �-�������7�����&��������)�*� ������4��

$ '��� ��;� ��� � ������ ����� H����� + ������ ���� ��C� �+�@�

������������� ��������)*�� , ��

$ -���� �� �����������������/�!����� ���������;������� ������

7��� ���

$ ����� ������� ����� ���<�� ��� ������C� <��� ��� ���

����������H�������@�������� ���������<�� ����

��7����

-�� ���7 ���� ����� ���� ��� � ��G���� ��� ��� ��������

7��Q � � ���� ����� ������� � �� ���� � ��� ��� � ��� � ��� ��� ����

�������������������������� ��� �������������� ���� �&���;���

���� ����� ������ ��� ���� 7�� � ��� ��� � ��� � ��� ��� ���� � 7�������C�

������ ��� �)�*� ��� ���� ��7 � �� � �� ���� ���7 ���� ����� ����� ����

�� �������7��� ��������������� �������Q �������4�

Page 24: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

7�+"� ���"����3�(���*�������7 ����7 ���������� �����/�!����������

�&��� ����������� ��� � ���;�������������� ����7���<��7 �����C�

����:����C����� 7 ��������������� � ���� < ��� �

���#�" (����3�(��� *��'�������'���������� ��� �����:���� ��� ���

�����7���� �)*� �� ,C� �� ����� ��� ��� ������ ��� ��� �������

������<��7 ��/K# �

*���:�� �����������������������7 <���� ����&��������� ����7���

<��7 ����������C��������� ������P���������������$$��������� �

���� ���3�(��� *���� ���7 �� ��;� ���� ���� ���������� ��� ����

(��������

'������� ��� ��������� ��� ��� ��� F� � *�� ���7 �� $�!� ������ ���

�����:���� ��� ���� /�!�� �)*� �� ,� $�! � /�<����� ����������� ���� ���

������/�!����������� � �����������7 ��$�!���� ��������� � ��� �������

������������� ��������� ��� � �� �

� �� ���3�(��� *�� �&/� ��7 ��� ����� ������ �� ����� �-&� �

������������������&/�����<������:�C�� ������C�������������������

��<J�� � ������������H���������� �@� �� ���������� ��������������

)LLLL� � Q���� H��� ����� )LLQ�LL� � Q���@� ��� ��� 7����� )4� � "� ���

�� ���� ���� ������ ���� �7���� ��� ��;��� ��� ����� ������ �����

���7 ������������������7���������7 � � �� �

��:�(���"3��! ���"� �*�������3�(��4�� �5�� *���� ���7 �� �����

������ �� ����� ��� ��7 <���� ��� �-&� � /�� <���� ;��� �-&�� 7��� ���

�� �������7 <���� �����7 � ���������)�*C��!&��7�������� �������7 ��

��7 � �� ����� ����� �����7��� � *���� ���7 �� ����� � ������ �����

� ��� � ����������� <� ����������������� ���4�

2�$���� �������� ����������� ������������� � �

2������ � ����� � �����H���������TBLL����@ �

2������ ����<��7 ������������ ����

Page 25: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � � �

2�*�����������������7����F� �������� �� �

2��)3�A��������� �������� ������������������!&� �

2� 3� A�� ��� ���� �� �� ���� �� ����� ����� ���� �������� ���

��� ��� ��� �

2�,)�A��������� ������ ������ ��������:���� ������������ ���

���� �

-�� � ������� ��� � ���;���������������������� ����������� ����

��4����F7������ ���C��������������H��<���@���&/�����<������:��

�������� � ��� �

*�� ���7 �� �!&�� ���������� ���� ����� ������ ���� � ��� � �C� ��� ��

����C������ 7 �������/�!������� ��������4�

2�-����� ��� ���H������ �������������������� ��� ����!&�@ �

2�!����7����������� �

2�/�������� �������� ������ �

2�#����:������� �

2�#���� ������ �

-��� ��� ��� ���� ;��� ���� ����� �� � ����� �!&�� ��� ���� ���

���������)�������H���� ������� ���*''����@ �&�� �������;������

�!&���� ��� ���� ��� ��� ��� ����� ���� ����� ��� ��� ���7 �� �!&�� ����� ���

��7 <���� ����-&� �

-%-�'��2@&�

����� ������

&�� ����;����������� 7 ��� ���������������������������������

�����7 ���C����/�!��$23)��������������������������� <� �����������4�

�@ �������� � � ����������C�������� �

)@ -��� <� ������������4�

� -)�/��H����� �����������Q ��@�

Page 26: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �"�

� $9�%���

� &��

� %�*V�H���������!�������� ����%�:���@�

,@ -��� <� ���������7 ���4�

� ���7 �� ��� /����� ���F� �� H����� �� /������

��7 ��4��/�@�

� ���7 ��&���������� ��H�� ���������7 ��4���@�

� ���7 �� ���F� �� ��� !�������� � ��� %�:����

H����� ��%�:����*Q����<����7 ��4��%*�@�

-��/�!� ����������� ������� <� ����������������� ���4�

� �$�< ���������� � ��

) �&������ ��� ��� � ��������� � ��

, �*�������������Q ����$9�%��C�-)�/����%�*V �

5 ������ ���������� � �������������7������<��� �

Page 27: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

-%-%$��������� ������������

&�� �� �� ;��� ��� � ��� � ��� �������� ��� ��� ���C� ����� ����

���������������������������� ��� � ���������������������������

;��� ������� ������ ���� � ��� � �� � -�� /�!� ;��� ����� �� �� � ����

������� ��� 7���� ��� ������� �� � ��� � ��C� ��������� ���� � �� ��

����� ������� � ��������� ��� � �� ��

�5� ������������ � �����������%�

'������ ��� ��������������������� �������� ��� � ������������

7��� ��� �����!�;� ��H@� H�� ��;������@� � ���� ���&�� ���H@�

H��;������@ � -�� �� ����� ��;� ���� ;��� ��� ��� ��� ��� ����� 7 ;��� ���

� ������U� ����� � ������� ��� �� ���� ������ ��� ����������� ������

� ��� � ���������� ����� <�� �� � �������� ��� ����� � ������;�F�

�������� �� ;��� ��� ����� <�� ��� ��� ���C� ��� /�!� ������� ��� �F���

���� ���&�� ���H@C�;���������������� �������� ��� � ���;�������� ��

����������������� ����� <�� �������� ���� ��� � ���;����������

���� 7 ���� ��� ���2��� �� � -�� � ��� � ��� ���2��� ��� ���

�;������ � ��� � ��� ;��� ������ ��7 � ��� ��� ��� ������ ��� ������

������������ ��� � ���������;������� ��� � ���������������

7������������� �/���������F��������� ������� ����� <�� ��C�����

����� ��� ���� ������� ��� ��� ��� ������� ���� � ���� ��� ��� ���

� ��� � ���;�������������������������� �'�������;������� ��� � ��

��� ��������� ��� ������ � � ��� ���� �J�;����� ��� ���� � �C� ���

������������������� �

��������������������� ������ ����! �

�"���3 A�, * ;%:(+�����1% �#��*�����#��"���

Page 28: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*���� ����7������� ������������ ��� �������� 7 �������� ����������

�������;��������������������������� ����������� ����� <�� �� �

*���� ����7������� F������������������J�;������������ � � �*���F���

��� ��& �������H@�������������������;������� ��� � ���������������

�������� ���� ����� <�� �� � ������ ��� ����� <�� ��� ��� ���� ��� �

�������C��������������F��� �;� ����������H@ �*�����F������ ���

��� ��<������ !"?'!$6Z�%��-*#*&C� !"?'!$6Z*$$%$� �

!"?'!$6Z#*$�!"/#*& �

�( #��, * ;%:(+�����1% �#��*������"��

*��������������� ����F��������������� � ����������� � ��

��� ��� � �� �����������<��������������F��������!�;� ��H@������

� � ��� ��� � ��� � �� ����� ��� ��� ����� <�� ��� �� ��� �F���

���� ���&�� ���H@� ��������� �7���� ��� ����� ��� � ��� � ���

���������� ;��� 7����� ���������� �� ���� �� ��� ��� ����� <�� ���

���� �� ���� ����� ��� ��� � ��� � �� ���� � #��� F�� ����� ��� ����

������� ��� ��������� ���� ����� <�� ��� �� ����F�� ���� �F���

������!�;� ��H@ �

�5� ������������ ����������

��������������������� �����!��� �

-���� <� ���������� ��������� ����������������������������

������� ������������������������ � ����������� � � �

�( #��, * ;%:(+�����1%��� �

*���������������������������� ��� <������BC�,)���)3�� ������

���< �*��������������� � ����������������������� ���� 7 �����J� ����

�� ��������� � ���� ������������������� �������������� � ����

��� ��� ����� ������������� ��� ''!&�� ������� ���� �������� ��� ���

&��������� ��

Page 29: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �#�

�( #��, * ;%:(+�����1% � (�!�"��

*���� ������ ��� ����� ��� �� � ��� ��� ���� ;��� ��� ��� ���� ���

���� � ����������� �

����������4�

2� *������ ���� � ��� <��;��� � �������C����C������C�����

� �� �F �������������< ��� �

2��� �<�

2�������

2�''!&�

2�������� ����������;� ���������<����������� ������������ �

-������������ F��������������� ����7�������������� ��������������

����������������� ����������� � �

�"���3 A�, * ;%:(+�����1%���*����������

*���� ����7�����7 ����������!&C���� ����������������� ��� <�����

�B�� �����������������&���*������ �'��&���*������C���������������

���2����� �� �� ��� ��� ��� ��� � ��� ��������� ����� ������ �

/�����C����������� �������� ��� � ������ ��������������������

��� ��� ��$����� ��� � �� ���� �C� ����� ����7��� � ���� ��� �F���

�������$����H@������������������� ������������ � �������� �

�( #��, * ;%:(+�����1% �#��*������"��

����� ��� ������ ����� ��� ������� � ���� ��� ���� � �� ��

� ��� � � � � ����� ������� � ���� ��� ���� � �� ��� ��� �2

��;�������������� �������������������������������������� ������

�J�;������������ � �������<��� �

�"���3 A�, * ;%:(+�����1% �#��*�����#��"����

*���� ����7��� ���� ��� �� ���� ��� ��� ��� ����� 7 ���� ��� *+*"#�

-!#*"*$�;������������������������������ � ����������� � ����

� ��� � �� �*���F������� ���& �������H@����������K1*"*+*$����

Page 30: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

���� � �� ��� ��������� � *�� �F��� ���� ���������������H@� ���

������� ������ ��� �J�;����� ��� ���� � �� ��� ���� ���� � ��� ���

�������� �

�5��.������ ����������

1���� � ��� ;��� ���� ��� ��� ��� �������� � ���� ���� � <� ������

�������� � �����4�

�@ �����������< ����������� � �;�������� ���������� � �

7��� ����������� ��� �� �

)@ /G�� �� ��� ��< ���� ��� ���� � � ;��� ����� ��� ���

���� � �7��� ����������� ��� �� �

,@ $�< ������ ���� ��� ���� ��� ��<�� ���� ��� ��������

��� ����� ��� ��� ���� � � ;��� �������� ���� ��7������ ����� ����

���Q ������������ ����� �

5@ /������� ���Q ���� ������ �� ������ ;��� �� � ���� ���

���� � �7��� ����������� ��� �� �

=@ /����� ���� ��� ��< ���� ��� ���� � � ��� ��� &&�� ����

���� ���� ���������������� ������������ ������� �� �

B@ *� � ����������� � ���������< ������� ���� � �������

&&���������� ���������������� � ������������ ��� ��� �

/�� ��:���� ��� ��� ��������� �C)C=� �� B� ;��� ��������� ����

�������� � ������;���������� ���� ����;�������� ������������ ������

���� � �������� ������������� �����< ����������� � �

����������� � �� ���.������ ����������

-� ����� �� ����� ��7����� �� ��� ��< ���� ��� ���� � �� ������ ���

�������� ���<����������������� �*��������� �������/�!���������;���

�������������������< ����������� � ����������7������������ ��

������ ��� ��� ��� ��� ���� ���C� ��� ���������� ��� ��� ��� /�!� �� ��� � ���

������� �

Page 31: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

-��7 <����� <� �������������������������������������� �

�����" ����#����$������������� ����%�����

������ ���� ��� ����� ��<��� ;��� ������ ��� ��� ��� ��� ����

���� ��������������������$�+,���������� �<�������Q ���'$-����

��<������ ����� ��� ���� ��C� ��� ���������� ��� ���� ��� �����

�������-����� � '�� ��< ���� ��� ���� � � ��� �G���� �� ��� &&�� ��� ���

���������� ��� ������ ��� ��� ��� ��� ���� ���� ��� ������

����$�*�.$�+, � -�� ��� ��� ��� ���� ���� ������ �������� �� ���

�������-������������������-�����+,/����������������� 7 ��� ����

�������������-����� �*������� 7 ��� �������� F��������� ���������

�������� ������ ��< ����� ��� ���� � � ��� ��� &&�� ������ ���

��� ��� ������� �������������$����-�����+,��9 ��������C������< ����

������� � ���������� ��� �����������������&&�������������� ��� ���

���� ������������������:��������������������������������� � �

Page 32: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

�����������&���� �����!��� �

�"���3 A�, * ;%:(+�����1%���*����������

'�� ��< ���� ��� ���� � � ����� ��� ��� ���� � � �������� �� ���

�� ����� �-����< ������������ � ������������������������:�����

������ ������������ � C����������������������������������� �������

���!&������� �������������������� ��� �

�����%� ���������������������� ����%����'�����"������

�����������������

'�� ���� ��� &�� ��� ��� � ��� �������� ���� ���� ���� D����� ���

����E������< ������������ � �;�������� ���������� � ������� ��� ��

���� �� � '�� ���� � � �:������2�����2��2�������� �G���� ���

��� ��$����������&&������������������/��%���H@ �-�� �� ������

Page 33: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !!�

�� � ����&����������������������� ���&�����������;� �������� ����

��� ����F� �'����� ��$���������� �����7 � ����� �7���� ��������

���� � �� �� ��� �� ����� &�� �������� ��� ���� � � �������� ��� ���

� ��� � ������ �� �

-�� ��� ��� ��� ���� ���� ���� F�� ������ ����� ��� �F���

���&�� ����� ���������H@� ��� ��� ������ ��� ��$����� ����� ��� ����

��<���� ��� ��� � ��� ���� � ��� � �� ����� ��7��:��� ��� ����� ���� � �

7��� � �

�( #��, * ;%:(+�����1%��� ( �*����

*��������������� �������F���<��$����H@�;���������� ��� ���

���� ������������������������������� ��$���� �*������ ���������

�� 7 ��������:������ ��$*�����G�� ������� 7 �������� ���� �

*�� ���� � � ������ ���� ������ ���� ������ ��� ��� &&�� ���� �����

�� 7 �� ������/��%���H@� � ������ ��� �F��� ������$����H@� ���

-���&�� �� �

�( #�� , * ;%:(+�����1%���*�������#�� ���";������"�

�;��"�#�, * %��%��;������"�

'������ ��$�< ����� �*Q���� �������������������� ���������

�G�� ����� 7 ���������< ����������� � �������&&��7���� �

-��7����������< ����������� � ������������ �4�

$ &������� ��� �:���� ��� ��� ������� ���H@C� ������ ���

���������� ��� ����� ��� ����� ��< ���� ��� ���� � � ����� ���

���� � ������ 7 �������������� ���H@ �

$ ������ ��� ���� � � �:������2�����2��2�������� ����� ���

�F���������/��%���H@������ ���������� ��� ��������G�� �����

��< ����������� � ���� ����������� 7 ��������&&� �

$ &����F�� ��� ��� ����� ��� � � ��� ���� ��< ���� ��� ���� � C�

������������ ��� ������� ���� ��������� 7 ���������< �������

���� � �������&&������������F���������$����H@ �

Page 34: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

-%-%&���������� ������������ � ������������

*��������������� ��������� � � ������������� �������������������

;������� ��� � ������������������� ��� � ������ �+����������

������� ;��� ������������ ��� �:���� �������� ����� ����� H���

-���&�� ��� �� $����&�� ��@C� ��� �F���� ����� �������� �� ����

��� ������� ��� ���� �:���C� ��� ���� ������� �� ���� � ���� ����

��������������F������������ � �������������������-���&�� ��C�

����������������� ��� � ��� � ��� �

-��� ��� � ���K ���������������� ��������������������������

����������������7 �<�H7��� 7 ��� �������� <��������������:��@�;���

��� � ��� � ��� �������� � -�� �����<��� �������� ������� ��� ���

�F�� ����������� ������������������ � ����� �/�<���������������F�� ���C�

��������������7������� ��C������� ������ �������������� ���������

���� ��� ����������� �%���������������� ���C�������� ���� �����

������ 7 ��� ��� ������� ��� ������ � ������ ������ ��� 7��� ��� ��� ����

����� ��������������� ��� �� �

�5�.��������������7���

-��� �������-���&�� �����$����&�� ������������������ �:����

����� ����� ��� ������� � *����� ������� ����� ���� ����������� ����

�������� � ����� ������� ��� � ���;�������������������7 �����/�����

���F� �� H����� �� /������ ��7 ��C� �/�@ � -�� �F���� ��� ������

������������������ ��� � �������������������������-���&�� �� �-���

������� &�� �������� �� �����������*Q���� �� ����� ���� ������

��������������-���&�� �� �&�� ��������� ������F�������������������

��� ������� ����� ���� ������� ��� ���� � � ����� ���� �� ���� �������

�7�� ���� �� ����� ���� ;��� ����� ���� ���� ��� ������� ��� ���

� ��� � � � ����� ���� ���C� ��� ������ $����&�� ��� ����������� ���

� ��� � �������������� ����F������������������� �7���� ���

���������� ��� � ������ �

Page 35: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ! �

������&��

�( #��, * ;%:(+�����1%��� ( �*�����

*���� ������ ����� ��� ������ �� ������ ����� ��� � ��� � ��

�������� ���� � *���� � ��G���� ����� ����� �� ������������� ���

��;� � ��������/������������7 � ������������� 7 ��� ���������� ��

�( #��, * ;%:(+�����1%��!��� �*����

*���� ������ ����������� ��� � ��� � �� �������� ����� ��

����� ��� �7���� ��� ��� ��� ����� ��� � ��� � �� ����C�

��������� ��� � ���� ��� �������� ���� � ��� � �� �� ��� ������

�� <�����H���������������������� ��� � �@ �

�( #�� , * ;%:(+�����%�(+�����1�� ��;������"� �;��"�#�

, * %��%��;������"�

*���� �Q���� ��� ��� ������ ������ ��� � ��� � �� �� ������ ���� ��

������ � ����;����������������������� �������������������� �

��� �:����C� ��<���� � ��� � ��� �� ���� ���� !"?'!$6� ������ ���

� ��� � ��������������������� ��� � � ��

�( #��, * ;%:(+�����1% �*����( ##�

*������������7 ������������������� ������ ��� � �������� ������

���� � �������� ��� � � �

�5��.��� � �

*����������������� �������F����� ��� �������������� ��� ����

����� �� � ����� ���� ��� ���� �������� ��<���� � -��� ��� ��� ����

�� ����� �� ���� ��� �� ��������� ������� �G�� �� ���������� �� ���

������� ��� ���Q ��� ;��� ��� ����� ��� ��<������ �� ��

������� ���H@� ����� ����� 7 ���� ��� ��<�� ���� ��;��� ��� �����

Page 36: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !"�

���Q ��� �/����������� ���������� 7�����������Q ����;����������

������� 7������������ � �������������� 7��������� �����������<�� ��� �

-�� ���������� ��� ��� ������� ��� ���Q ��� ������� ���� ������ �����

�������������� ���������<�� �������� ���� ����;�������������������

���Q �� �-���F����������������$����&�� �������������������

��� ����;� ��� ������ ��� ���� ��� ��� ���� �� ����� �� ���� ��� �����

�� � ����������� ���������<�� ����������������Q ������� ����� ��

�������� �� � �.��� � � �� ��� �� ��� �

���<���

-��� ��� ��� ���� ���� ����� ������� ����� ��� ��� ��� �F����

����������������:���Q � ���� � � �������������-&�������������

����:����� 7 �����;�������������������������������������� �����

;��� ������ � ����� ��� ���� ��C� ��� ���������� ��� ��� ������� ���

���Q ��� ���� ��<������ ���� �F��� ���� ����� ���� ��7 � �����

�7���� ������������������:������������������� ��������� 7 ����C�

�� ����� ������ ��� ��< ���� ��� ���� � � ���� �� � �� �����<C�

���������� �� ������ ������� �G�� ���� ��� ��� �<� H������@� ���

���Q ������������� 7 ���������;� � ����������� �����������Q ����

����� ����� �*���������������������������� 7 ��� ��C����� ���� ���

�� �������� �������8������ �

�������� � ��������������������������

/����� ��� ��� �������� � <� 7 ��� ��� ��� 7 ��� ��� ��� ��� ���� ����

����� ��� � ������ �-�������� 7 ��� ������ ������������;��������

����������������������� ��� � ���;�����;� ������������������)3�� ���

<�������������� ��������� <��!"������� ����������� ��� � �� �

������� <���!"������������� ��� � ��������������C����������

��������� ��� ���7���� �

Page 37: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

*�� ��������� ���0�������� � ���� ��� � <� ����� ���������� ���

��������������������������������Q ������������� ��� ������� ��� �

$ ����0�������1����C���� ���������� ��� ���������� 7 ����

��� ���� ������������� ��� � ���� �����

$ � �����0�����1�����C� ��� ���������� ��� �� �������

��� 7 ���� ��� ���� ���� ��� ��� � ��� � ��� �� ������ ;��� ��������

��������������� � �

����������������0����������������������������������������

���Q ��C������������ ���������� ����� ���������� 7 ������� ���� ����

�������� �������������;����������������������������������������

��;� �������������;������ ���� ��� �

"��������� ���������������������������� ��� �� �!������

� � ��� ������ ��� ��� ��� ������ ��� �� ���� ����� ���0�������1�����

������������7� ��� ��������� ���������<�� ����;����������� ����

�������� �� ������ ��� ��� � '��� 2�������0��������&��$���� ���

������ ��� ��� �F��� ���������$�+,� � � ���0�������1����� �� ���

������ ��� �������������C��� ������������ ��� ��������������7� ���

��� ���� �� ���� ��� ��<�� ���� ���� � ��� � � � � ���� ��� ��7� ���

��������������� �����������<�� �������������� ��� ����������� ����

��� ��<�� ���� ���� � ��� � �C� ��<����� ���������� ���� ���� ����

������� ���������� � ���������7� ����� � ������������� ����� �������

�� ��������� ��� � � �

�������� �� ����� �������������������

-������ ���� ���������������� ��������������� ��� ������������

������� ��� ����� ������ ��� � ��� � ��� ������� � ������ �����

��� ����C�������� ���� ��������� �����������������7����� �������������

������� ���� ���� ���������������� � *����������� ����$�� � �������

� <� ����� ���������� �����������������������������������Q ������

������� ��� ������� ���4�

$ � ����$�1����� ��� ���������� ��� ���� ���� ����

���� ��� ������������������������� � �

Page 38: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !��

$ � ����$�1�����C� �� ��� ��;� ���� ���� ���� ��� ��� ���

��� ��� ������� ���C������������������� ����� ��� � ���� �����

����������Q �����Q ����������������������������������������

���� ��� � �����;� ��������� ���� �� �

$ �����������������$����������������������������������

���Q ��C�����;� ��������������$�1����� �

&�� �� �� ;��� ��� ���� ���� ��� �������� ��;� ���� ���� ������ ���

������������� ���������� ���� �����;� ���������� ��� �� �*���;� ����

��� �� ;��� ��� ��� ��� ������0�������1������ �� ����$�1����� �� ���

��� �����<������������2�������0�������&��$��� �

/�� <����;��������������� ��� ��C����������� ���������������

������� ���� ���� �� � !������ � � ��� �����C� ��� ���� ����$�1�����

������������������7� ������������ ���������<�� ������������ ����

�� ����F��������� �'���2�������0��������&��$���� ���������������

�F��� ���������$�+,� � � ����$�1����� �� ��� ���� ���� ��� �� ���

������������������7� ������������ ���������<�� ����������� �

�������� �� ����� ��������������/�����

-������ ��� �������������� � ����������������������� �������

� ��� � �� ���� ��� ������� ������ �� ��� ���� � � ������7 �� ��� ���

� ��� � �� �� ����� ������7 � � -�� ���������� ��� ��� ��� ���� ��� ���

������ ���������;���������<������������� ������ ��� � ������ ���� �

���� ��� � ���� ����������������� � ������������������� � �#��� F��

������ ��������� ��� �������� ��� ���� � ���� ��� � ��� � ��� ;��� ���

D��7 �����E���������������������� ������������������������� � � �

*�� ������������0���3�� � ���� ��� � <� ����� ���������� ��� ������

��������������������������Q ������������� ��� ������� ���4�

Page 39: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !#�

$ ����0���3�1����C���� ���������� ���������������������

����� ������ ���� � � ��� � ��� � �� �� ����� ;��� �� � ��� ����

���Q ��������������� � ������������������������ � �

$ � ���0���3�1�����C� ��� ��� ���� ��� �� ���� ��� �� ������

������������������� � �

$ � �� �Q ���� ��� ��������� ���0���3�� ��� ������ ;��� ���

���0���3�1����� �

/�� <����������� ���� ��C�������� ��� ��� ��� ���;������ ���� ����

������ ������������������ 7 ������� ����F�������������� ��� ��C������

;��������� ��� ������0�������1�����������0���3�1������������� ���

��<������������2�������0�������&��$��� �

6� ��� <���� ;��� ��� ������ ��� ��� �� ��� ���� ���� ��C� �� ���� ���

� ����������������������������� ��� ��C������������ <����;���

������ ����������� ���� ��� ����� �������� ����� �������� ��

������������� ������Q���� ��� �

��(����+��#� ��� #��*����� � � � � ��(� ! �#���� 4���*���

��B+�#�#�3���� #������(�5�

-�� � ��� � ��� �������� 7����� ������ ���� ����� � ����� ����

��������� �������� ��� � ����������������:���7������� ����������

������ ���� ����������S�� ��� � ���������� �'��� ��� � ��������

������������������������� �*��� ��� � ��;��� � � �����7���� ���

��������������������������� ��� � ��<������������������ ��������

������� ��� ��� ���� ������ ���� ��� � ��� � �� � �� �����<C� ���

�����<��� �������� ����� ��� ��� ����� � ���� ����� ���

� ��� � ����������� � ������� �������� �������8����������������

�����������������������������������Q �� �

��� �����������1����� ������� ;��� ��� ���������� ��� �� � ���

;��� ��� �� ����� �� ��� ���� ��� �������� ��� ���� �������� ����� ;��� ���

Page 40: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

���� ��������� ��������������������������� ����������1�����������

7���������� �

"��������� ��� � ���������������7��� ��� ���C�����;������

������ ���� �Q���� ��� 2�������0��������&��$���� ��� ��� �F���

���������$�+,��

��(����+��#��"�( �� ��" ������"�;�)"�� � ��(��(��"���

-��� ��� ��� ���� �� ����� ���� F�� ������� ����� ��� ����������

���0�������/� ����$�� �� ������� ��� ��� ������� ��� ���Q ��� ���

��<��������������������$�+,�������������������� �����������

����������� ���������� <� ������ ���������� ���4�

$ ������ ���0�������1����� ��� ���������� ��� �������

��� 7 ������� ���� ��������� ��� � ������ �� �

$ ������ ����$�1����� ��� ���������� ��� ���� ���� �����

�������� ��� ��������������� ����������� � �/�� <����;������

������� ��C�����$�1����� ��� ������0�������1���� �

$ ������������1����� ��� �� ����� ����� ���� �� ��� ������ ���

������� ��� ��� ���� ��� ��� ��� ��� ���� ��C� ���� ;��� ���

���������� ��� ����� ��������� �������� ���� ���� ��� ��� � � ���

��� �������� ����������� ��

��������/�!C����J� ��� ��� � ��;�������� ��������������� ��

����������������� � �������� ��� � ��;���7������������� � ������

����� ��� ��������� ���0���3�� �� ��� ���� ��� ��� ���� ���Q ���� ����

�� ��������������������Q���� �������� ����������������� ������������

��<���������0���3�� ��� ��� ������� ��� ���Q �� � ������ ��� �� �����

������� ���������� ��� ���� � � 7��� �� ��� ��� ���� ��C� �����

� ��� � ��� � ����� ���� ��� ��� �� ���� ����� ��� ���������� ��� ���

���������� ���Q �� � *����� �� ���� �� ���������;� � ���;��� �����

���� � � � ���� ����� ���� ���Q �� � ��� � ����� ���� �� �����

��� ��� �����������������������������������<������������Q ���

�Q ��� � *�� J� �� �������� ��� ��� ;��� ����� ���<���������1����C�

�����;������ ������������Q ���7���� �*��������������� ��������������

Page 41: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

��� �Q���� ��� 2�������0��������&��$���� ��� ��� �F���

���������$�+,/������������ ���� ������������������������Q �� �

-�� ��� ��� ��� ���� ���� ��� �J�� ��������� ��� ���� ��������

��;������� ��� ����$�*�.$�H@� ������ ;��� ����� ���� ���Q ���

��<��� �

-����<�� ��������������������������� � ���������������-&��

4���&������������������������4���&�%�������0�-����������� �

Page 42: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

-%-%-���������������������

����� ����� ��� ���� � � ��� ��� � ��� � �� �������� ����C� ���

� ��� � ���������������� ���������������� ���������;������

���� ������� ����������� ��� ����������������������������� ��

<���� ��� ���� � �� �������C� ��� ����� ���� /�!�� ����� ���� � ��

���Q ����;���� ���������������$9�%��C�-)�/����%�*V �

���������� �����������

*��������$9�%�������� ��������� �������J�� ������������

��� �� $2),)� ������ ��� � ��� � ��� ������� � -��� � ���� ����

�����������������������7 ������ ���� 7 ����������� ���$9�%�� �

��� ���� ��� ��� $9�%��� ������ �Q �� �� ������ ����;� ��� ���� ���

� ��� � ��� �� ��� ���C� ���� ���� ��� ��� ������ ������ ���� ��� ����

���Q �� �*���J����������Q ����;��������������������������������

��� ��� � ��� � �� �������� �������� ��� F��� � '�� � ��� � �� ������

������ ���� ��� ���� ��� ��� $9�%��C� ������� ��� ����� ��� ��� ���F�

�������������� ��� � ��� 7������ �*��������������� ���������������

��� /�!� :��23)C� ���� ��<J�� ��� ����� 7 ��� ��� ��� �� ���C� ��� �� ;���

��<������ ����������������������� �

'��� ��� ��� ��� ;��� 7����� ��� ���� � � ������ ��� ��� ���7 �� ���

������ �� �� H�� ��� ���� ��7 ��C� ��@� ��� ��� ���� ��� �� � '���

��� ��� ���;��� � � �������� � ����������Q ������������ ���������

����� ������� �'����< ����������� ���������������� � �������&&� �

��� ������ ���� ������ ��� ��< ���� ��� ���� � C� ��� ���� 7 ����� ���

������������� � �����G���������< ����������� � �H���� ��������@ �'��

�� ����� ���� ��� ��� ���� � � ������ ��� /�!� ��� ������� � ���� ���

���� � � ������ �������� ��� ���� � � ����� 7 ����� ��� � ���� ��� ����

���� �������� ���� 7 ���������������������� � �&����F����������������

������Q ���������������������������� � ������������� ���� ����

Page 43: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �!�

������ ��� �� ����� �� ���� �� � -�� ��<� �� ��� ��� ��� ���������� ���

���Q ��� �� ������ ��� ����:��� ������ �������� ��� ���

���������� ���������������Q �� �

���#�� � �#��*��������(��"���

-��� '$-�� ��� ���Q ��� ����� ��� ���� ��� �� ��� �� ����� ��� ��� ���

� <� �����7���4�

��������#��*����4�

%��$$5""�����0���5����67'*-*)��-.����8���-9��.-:�

������������������� ���������,)��J����������Q���� ����

�/$/�*#$%�&*-�*$+!&%$�����������4�

�������

����

����$��

�����0������

���0���3��

#�������� � ����[������[7����C������������� ��C������

����C�;������������7��������[#�Q��

���������(��"�������������������Q ������������7����

%��$$5""��������5����67'*-*)��-.����8��8��;��:�

���������������������������)���< ��������Q���� ���������������

�J�������������,L �

Page 44: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*�� ������ �� '*-*)��-.�� ��8� �8��;��� ������� ������C�

�������� �� ������� ����C� �������� ��� ��� � ���� 7���� ;��� ��� ���

���� �� �

�.������ ��������� �����������

'������ ���������������:������� ������������� �"� 7 ���

������� <� �����7���4�

$ '�������� ����������� ������������ ���� ������ ���

��<���������������� ���H@U���

$ $��� ����� ��� ���� �<� ���� ��������� ���� �� ���

������� ���H@������ ����7�������������� ��"� 7 �� �

*:����4�

�������������;�������� ����������������������;��������

��������1�

+�������������;�������,����������$�+�

<%��$$5""�����0���5= � > ? ! # @ A B *=2=�=�=�=�= 7��

�1�''�&C,7�

�����������������1�

+�������������,�������������$�*�.$�+,7�

*������ �����������F�������$�*�.$�H@������ �� ����;��������

� �����������������������Q ����������� ���� �*�����F�����;����

������;�������� ����������� ��

*������ � �������������������J�� ��������Q �������� 7��������

�� ��������������������$�*�.$�H@���� �������� �'��������:���

�����������������������������������Q ����������� �������� �����

����������� �����< ����������� � ����������������� � ����������

Page 45: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � � �

� ��� ������ $9�%��� ���� ���� �� � � ��� � ��� � �� �� �������

�J�� ��������Q ���C����������������������2�������0������&��$����

����������$�*�.$�H@ �

������������� ����<�������������

/��������;�������� ��������������������������������Q ������

��� ���� � � ��C� ����� ������� �� ��� ���� � � '��� ���Q ��� �� �����

������� ��� � ���� ��� ������� ���� � ��� � �� ���� ���� ��� �� ���

���� 7 ����� ���� ������ ���� ���� ��� ����� ���� ���� � � *�� �F���

<�������� �'$-H@������� ����7������ ��$�����������������������

�����'$- �

!������� ��� �F��� ������� ���H@� ��� ���� ���Q ��� ���

�� ����� ��� �� ���� ��� �:��� ����������� C� ;��� ����������� ���

���Q ������������������������� ���� �

+������������� ����������������������Q ������������� � �

���� 7 ���� ��� ��� ���� 7 ����� ���� ������ ���� ���� ��[=� ��� ���

� ��� � ������ ���� ���\LL=L�LLL,)��]�

����������� �����[�

H����������� �@�

������� ���HD�����488LL=L�LLL,)��4=E@U�

Page 46: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �"�

C%�����/����� �����D�����

'�7���I� ���� ����� ��� 7����P�I� ����� ��� ��������� ���

��� ��� ����;����� � ���������<���������������������� ��� ��� �

*�� �� �� ���� �:�� �� ��� ��������� ��������� ���� /�!� ����� 7 ���� ��� ���

�������� :��23)C� �� 7������ ��� ��<������� ���� � <� ������

����������� ���4�

� !����7��� ���� ���4� ��� ��������� ��� ��� ��<�����

� ����������������� � ��������� �

) *���8������ ��������������������

, 9��:������������ � ���������;������

5 ��<����� ���� ����������������

= ������� ����2���� ���

C%$�����* ��)"�

C%$%$���!�(�3�� ��)"���(�����

� �

� ������;������7�� � �� ����������������<�������#�C�����������

���� ��� 7 ��� ���������/�!����������������������C����;���������������

��� ���<��:�� ��������� �� <����C� �� ���� ��� ��� � ���Q �� ���� ��� �

���<��:��� ������ F����������� �����������<�������� �

"� �������C� ���;��� �� ����������� ����� �� ��� ����� ���

�����������<���������������������������������������� ��� ���C�

��� ������ ��������� J� �� ����� <����� �� �Q��� ������� � /��� ����C� ���

�� � ������������� ��� 7 ��� ��������������� ���������������������

���� ����������C�����7�� ��� ��

Page 47: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*�� ����;� ��� ���C� ���� ��� ����� ���� � ����� ������ ��� ��� ���

7��� ��� ���4� ��� ����� <���� ��� �������� ��� ��� ��� ��� �����

<������������ ������������;������� �������'�7���I���<�� �������� �

����������������������;�����:���Q ������� �

��������G���������� ������������ <����������� ��� ���;����� � ���

�����<��� �������� ��� ����������� ����� �������� � �� �������

�Q��� ���7��� ��� ���C�����:�� �������� �����������<� � �

C%$%&�"*E�F�������)"����� ��#� #E"���"��

� *�� ���� ��� ��� ��� ;��� �� � ��� ��� /�!� ��� �������� H:��23)@C� ���

�������� � ��� ����� ��� ���� ��� ��� 7���� ��� ����� ��� �����

����� �����������D���� �'��������������� ���������Q ��C������ ����

����:������� ��-)�/������� �������������� � �

*�� ��� �� ���� ���C� ��� �:��� 7����� ��� 7��� ���� �����

�����7����� ���������4�

� ���H����XY��@���� ��������� ���������� �

� $��� ��H����XY��@������������ ���������� �

*�������<�������C���;���7���������F������������ ��7��:��

����������������� ����4��

� ���!���������H@� �� ���%����������H@� ���������C�

������� �������C� 7��:�� ��� �������� �� ���� ����� ��� ������ �����

����;� �������� � �

� ���&���!���������H@� �� ���&���%����������H@�

���������C� ������� �������C� 7��:�� ��� �������� �� ���� ����� ���

�����C������ ��������������8������ ��������Q� �

Page 48: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

�������C����������������� ���������Q ��C������<������������

����������� ��� ��� ������ ��� �������8���� ����� ��� �� � *�� �:���

����������� �� ���� ��� ���� ���� ���� ����� ���� ��� �������� ��

���� �����������F������F�������� �� �����:��� �"��������C����

���������C��������� ��������������� ��� ���������;�����������

��<����C�;�������������;�F���������� � ��������������F��������

���Q ��C� �� �������� ��� ���� ���� �� ��� � � � /�����C� ��<J�� �����

��;����C� ��� ��<������ ������ ���� ������ ��� ��� ������C�

����� �������7��Q � � ��� �

� + ������C�����7�� � ������;������������7������'�7���I��������

� <� �����4�

� 2�*���8������ �������������������

� 2�9��:������������ � ���������;������

� 2���<����� ���� ����������������

'��� �� ����� ��:��� ��� ���� �Q�� ���� ��� ����� � ���C� ��� ���

������� ������������������������� ������������� �����������������

���� ���� �&���������C����������;������� ���<������������� ���

������������ ��C��������������� �������������������������������� ��

Page 49: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �#�

-�� ���� ��������������'�7���I���������� ��������������C����

��� ;��� ��� �������� ��� � � �C� ��� ���� ������ ��������C� ��� ������ ���

���Q �� ��

C%$%-�7(+,������ ��#���(�!�� ����"�� B+���#�

� �

� ��� ���� ��� ��� ������ ��� ��� � ��� � ��� ����� ������� ���

������H������������� �����;�������������;��� ��� ���� �7���� ���

��7 � ����@C������������������ ����� ������������������ ���������� ����

������ � ����������� �-���J�����;������������4������<���������

���� ���� ��� ����� ��;������ ��� ����G� ����� ;��� �� ��

�������������� ���� ��������C��������;��� ���������������������

������ ����������������;������� <� �������������������� ����;���

� �������D��������E�����������Q���������7�P���������� ��� ��

� %������������ � ������ <��������'�7���I������������ ���������

������� <��F� �� ����� ��� ��;������ ��� �����C� ;��� � ���� ��� �����

������������ ��� ������� �� ��������Q�� ��

C%$%C������ ! ��)"�����"� � � ��*�"��#�

Page 50: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

*�� �:�� �� ��� �� � ���� ��� ����� ���� ��� ��<������ ������� ���

�������8���� ���� � #��� �� ��� ��� ����� � �� ����� ������C� ���� ����

�������������� ��� ��C��������������������� ���������7���������� ���

��������������������� � ��������G�� �������F��������� � ��� ���

�����;�����C������<������������ ��� 7 ����������� <� �������4�

� �� ��������������F������ �������������� ���

��������;����4�$�E����-���%���+,�

) /��������������Q ��C���� � � �������� ������������

������;�����������<��������������������7��:����������� �-��

������ �� �� ���� ������ �����<����� ��� ����� ������� � �������

���� ��

, ���������;������ ��������;�����������C����������

������������:����������F���$�E����-���%�����

*������� <��������<����� ������������������ ���������������

C�������� F������������ �����������������C�������� ��������

��<����� ��� �������� ��� �� ������ ��C� ��� ;��� ��� ��<��� ���

��<�������������� ���������� �� ����������<����C������<������

����F������� ������� 7���������������;�������������< �C�� ����

������ <� ���������������F�������������� ������ ��H������� ��

��� ������� ���@ �

C%$%G�����(���(��"��2#��*�����

� /�� �� � ���� '�7���I� ��� ����� ����� ��� �������� ��� ��� ����

��� ��� ����������;����

����� ��� ����� ��� ��� ���� ��� ��� ��� � <� ����� ��� ����� �� ����2

���� ��C����� ����������������������� ������� <� �����4�

Page 51: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

� ��� ��4��������� ����������������������� � ��������#��

��� ���� 7 ����� �� ��� ����� ��� ���� � � '��� ���� ������ ���

���� � C� ��� ��� ��� ��� ��� ��� ������ �� ������ ;��� �������

���������C������� ������ �������� ���� �7���� �� �

� �� ����4� ����� ��� ���� ������ ���������� �� ��� ���� ���

'�7���I��� �������� ��� �7���� ���

� �������� ��� ���� � �4� ������ ���� � �� �������� ���

���� 7 �������� ���� �*������������������������� ���� �

Page 52: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

C%&� ��H��

�C%&%$�7������� �������0����

/�������������7 � �����7���������������;�������� � �����������

������ � ����������C��������������������� ��7������4�

� *������G������������� ���� �

� *�� ����G� ��Q �� ����� ���� ��� ������������� <�����C�

������� � � ��������������������:����������G�������� ������

��������;���� �

� -�� ��������� ����� �������� ��<���� �7���� ��� �� � ����

�����7�� � ������������ ����������������������������� �����

��;���� �

<� ����������� �� � �C���7 � ����������������H'�7���I�

�����< �<������@���������������� ��������� ��� �������

���;�����������������������7���������<����������7��:������������

��;������� <� ���������7����4�

� -������� ����������� �� �����������G����������� ������

���� ��

� *�� ������� ����� ��� ��� ��� <� ;��� ����������� �7���� ���

������������ �������;���� ��

� *�������������������� ������������� �

Page 53: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � !�

1���;����������������� <� ����������������� ���4�

� � "������ � ! I�4� ,2B==,3� ������ H��� ���������

���� ��@�

) �(�!�� ��)"�: # � ��"�� ! I������ B+����

-������� ����������� �� �������������������J�������������

;��� ����� �Q������ ���� 7��:� ��� �������� ����� ������� ��� ��;�����

������ ��

*���� �F��� ��� ��� � ��� ��� � ���� ���� �����:�� �� �4� ���

� ������� ��� � � � �����;� ������� ����� ������)���������� �����

��;���� � -�� ��������:�� ������ ���� ��7 � ���������� ���� � ���

��� ����� ���������4� ��� ����� ��� ��� ���� ��� ��� H��� � ������

����� ��� ��� ��� �C� � ���<��� ����� ��������@� ��������

��������� ��� ��������7 ��� � -�� ��;������ ��� � ���� �������

����������� ������ ���� �����C� ����� ��� ������ ������������

��� ��������� �� ������� ��� ��� ���� ��� ���� ����� �C� �� ���

��� <� ����� ��� �Q��������� ������� ��� ����G� ������ � -� ����

<�����������;��C������������� ������������� �������;�����C�����

������������������������������� ��� �/�����C�� ��� ����������

� ������ ��� ������ ��� ������C� ��� ��<����� ������ �� ������ ;���

�������� � ������;������������� �

�� ���� ���� N?�F� ������ ���� ����� �� � ���� ����� �F��� ���

��� � ��� ��� ��� ������O� *�� ������ -)�/�� 7����� ��� ������ ���

������ � ���� ������������� ��������C����J� ��������� ����������

������ � ��� ����� ��� �F�� ��� ��� ��� ���Q ��C� �� ����� 7�� �������

��������������;������������ ��������H@�������������������2�����

����������� �

Page 54: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

-% �( #�3�� ��)"����(�#�� B+���#�

*�� ��<���� ��������� ��� ��� ��������� ��� ��� �����

���� ��������� � ��� ����� ����� ��� <C� ��� ������� � �� �<� ��

� �� ���� � ��� ��� ��;�����C� �������� ���� ����� ��<����� ���

��� ��������������������� ����������������;����� ����

�:����C���������������������C�������������������4�

� �����:���

� �����:���� ����

� ���� ����� �I�

� ��� �

-���������������������������� ������������� <� �����7���4�

� -������;���������7��:������������

) &����� �������� �������;�����H��� <@�

, *Q������ ����� ���� ��;���� � �̂��� ������ ������ ����

����������� ������� ������ ���� � ��� �:����C� ��� ���� ���

���� ���� ����C� ��� ��� �����:�� �� ���� ����� �� ������ ���

�����������������:������������ � �

5 $��� ������� ����������� ��C����7��� �������� �����

��;�����

Page 55: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �

C%&%&���0���������

#����������� �� ����������:�� ��C�'�7���I�������������� �� ��

���� ����� ������� �� ������ ��� /�!� ��� �������� �� ���� ��� ��� ���

����;� ��� � #��� F�� ��� �� ��� ;��� ��� ��� ��� �:�� ��� ����

������ ���� ��� �������� ��� �������� ��� ��� ��;������ ��� � ��C� �� ���

<������ ��� ��� ������ � *�� � <� ����� � �<����� ��;����� ��� ��� ������

���'�7���I����������� ��� ���;����� � ���������� ��

Page 56: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "�

*�� ����� �������C� ��7 � ����� ��� ���� � �� ;��� 7�������� ����

� �� ����� ��� ������ ;��� ������� ��� � ������� H���� ��C� �� ����� ��

�������@������������������;���<������ ��

1���;��������������������������������� ��������4����� �������

������ �����������������7�����)�* �*������ <� 7 ���;�����������

���� �� � ����� ��� ����� H�)*C� �� �� ��������@C� � �� ;��� ��� ���

��������� ��� F���� ������� ��� ������ � ������ ����������� ����

� �<���������������<����� ��������� ��� � ������ ����;�������� ����

����������������� � ��� �

'��� ��� ���� ����������� ���� ��� ��� �����<��� ����� ��� ��� ������

��<��� ��� ��� ;��� ��� �:������� ��� ��<�����C� ���� � ���� ���

����� �� ��8����� �������� � ��< ����������� ��� ����;�������:�������

��������;� ���� ����� �&���������C������<���������������������

���������������� ������������� ���� ������ ���Q�������������� C�

���;���������������������� �������7 ������������� �� �

��� ��� ��� �������C� ����� �� �� � � ���� F�� ��� �������� ��� ���

�����7�����)�* � �������<������������������������ � � ����

��� ������ ���� ��� ����� ��8����� �� ��� ��� ��� ���� � �C� ��� ;���

���������� ��� � ������ ����� �� ����� ��� ;��� ��� �:������ ��� ���

��;� ���� ����� �-������ ���;������������������� <� ����4���������

����� �H���� <��C�� �����������@������������ ����������� � �����

��������������� � ��������������������� ��� ��C����������������

;���F��������� � �� �'������������ ��������� �C���������������

��������������������� �����:���� �� ��

���<��������!&���C�;�������������:�������������� ��� � ��

��� � �/�� � � ��������� ��� ��C�������������������;�����������<��������

������� ����� ����� ��� ��� ����7�� � ������ ��� �������� ���

������ ������ ��� ������� ���� ���F7�� H��� �:����C� ������ �����

���������������������J��������������%A@C����������� ������:��������

Page 57: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

��� ����� � ���� ��� ��� �� ���� ����� � � ������ ��� �����

����� � ��������� � �������������������������Q�����H� ���������

���� ��C����C���� @C������������������������������������������� �

� ����������� � ���������� ��� ��������������� ��������� ��

/;������<������������4�

� -�������������;������������������������ �������

����� �

� -�� ���������� ��� � ��� �� ��� ��������C� ����� ���

������������ ����7����������;�����

*���������� ������;��C������;������ ����7������������ ��� ���

;������� ����� ��� ���������������� ��4�����F����;�����;� �����

���� ����������� C������������:�������������������� �*��������

��� � ��� ��7 � ����4� ��� ������ ��� ��� ����7��� ����� ��� ����� ���

�:���� ��� ������� ���������C� ����� ����� �������� ��� ������

������ ��������C����� ��������� ������ ���� ����������:���� ���

���������7��� ���C����������� � � ������������������;������� ��� �

*�� ��������� ��������� ;��� ����� �������� ���� ������� ��� ��� <�

�:������� ��� ��� ������ ��� ��� ����7��� <��7 �� � "� �������C� ������

�F����7������������� ��� � � ������������� ��������� ����������

����7�� ��

/�������C���������������������� �������������;�������:���� ���

��� ��� ����� � ����� �� ������ ����� �� ������;��� � � ��� ������

�� � ��� ��� ��� ������ ��� ��� ����7�� � ����� ����<� �� ���C� ��� �F����

���� �����������:���������������� <� �����7���4��

� ���<������������ � ���� �C�;��� ��� ��������

�������� �� ���� 7��� ��� ���� ��� H;��� �� � ��� ���� �� ���

����� @��

Page 58: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ��

� ���<���� ;��� ��� ��� ������ 1�� ��� �:������ ���

����� � �������

� -��������������������������������1)C�������������

���������:���������������� � �������� ������

� -������������������ ��� ������� �������������;���

��� �� �� ����� ����H��� ��� ������ 1)@C� �� 1�� ��� ���� ���

������ ������������������������FQ ���7�������������

� *�� 1)C� ������ ��� ���� ��C� ��� <������ ��� ������

��Z�������� � �̂��� ������ �� 7 ����� ��� ������ ��� ���

�������C�� ��������� ����C������� ����7���<��7 �� �#��� F��

������������ �������������Z����C�����������;����������

��<� �������������� �

*���� 7 ��7��� ��� ��� ;��� ��<� ����� ��� ��� �F���� ���

���� ��� ���H�������@� � � ����C������� �C��;���������� ����������

��� ���� ����� ���� ��� ���� ��� �� � *�� ��� ���� ���� ���� ��C� ���

����� ��� 7����������� ��� ��� ����� ��� ���� ���� � � ������� � *�� ���

�� ����C�������Q ������������ � �'��������:�������C�� ��������� �

������� ��� ���� �� ������� C� F���� �� ������� �� ���� ��;��� � � -��

�J�;����� ��� ���� � �� ���� F�� ��� ���� ��� ��� ���� ������ �����C� ��

<������ ������� ��� ���� �� F���C� ���;��� ��� �� �� � � �� ��;� ����

���� ����������� ��

*�� ���� � ����� ����� ���C� ��� ��������� ��� ��� ����� ��� ���

�F����� ����C��������������������� ��� �

��� ���

Page 59: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � #�

� ��� � �4�

� !� � ��� ���� � _4� ��� � ����� �� ������ ��� ���� � �

������� � -�� 7 ��� ��� ��� ��� ����� ����� ��� �����

��������C��������������� ��������������� �

� 9 ��� �������� � 4������������������ ���������� � ���

������� � �����&&� �

� *�� ��������:������ �����

� &������������ �����

� �������������������������� ��4����� ���������� ����

���� � ��������� � �

) -�� ������� <�������� ��� ��� ���� ��� ������ ���

� <� �����4�

� ��� � � � � ��_4� ��� ����� ��� ���� ���� � � ��� ���

������������FQ � �/����� ���������������C������ �����

����������������� �������� �

� �� �������������

� �� ����������������

� �����:����� � ���������� �����

�� �����

� ��� � ��

� !� � ������Q ��������� ��_�

� &����������

� *�� ��������:��

) *������

� ���Q ���������� ������������_�

� *�������������Q ���H��������<�����������@_�

� �����:����� � ��

Page 60: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

� ���Q ������� ���

��������

� ��� � ��

� !� � ����J�;�����

� &��������J�;�����

� ���������������������������

) *������

� ��� � ����������

� �J�;�����7 ��� �����

&�������7���C�;�������7 � ��������;� ���������Q���������'�7���I ��

Page 61: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

Page 62: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

C%&%-� ��H����������

�"����+���)"� (� �#�I���"�� � #�

-����<����� ������ ������ ��� ������ �������<����� ���������

;�������:�� ���� ��� ���������������� �����������< ��������<� �����

�����< ������� ��GC�����:�������� �������������������������������

���������������������������� ����������� �

-�������:���� �� ��������������� �C����;������������������������

������� �� ���� ��� ��� �� � ������ �� ��� ���� ��� ��<J�� ���� � ���� ���

���������� ������;��� ��� ��������;������ ������������� <�������� ��

/������ ���� ��� � ��� �� �� ��� �����:� ��� ����� ��� ��� ����

��� ��� ��� ��� � �����C� ��� ����� ��C� ����� <���� ��� �����:� �����

�������������������������������� �����C�� �������������������� �

���������/�!�;����Q ����������� ����� �

*�� ��� � ��G� ��� � ������� �7���� ��� ������� ��� ������ ����� ����

��;� ��������� ���� � ���� � ��<����� ��� ��� ����� � *�� � �����

��;� ��������� �� ����� � ���� ��� ��� ��7��� ���� � � ��� � ����C� �� ;���

���� ������� ��G������;� ��������������������H;�������������� �����

���7�� � ��������������;������������ ��������������@ �

*��� ��G���������<��������������������� ��G���������� ������

H��������������@4�

� 2�� � �������#�"� ��)"��������;�������������� C�������������

� ������ ��� ����� C� ��� ���� ��� ��� �7���� ��� �� �������� ���

�7���� ��� ���� ����� � ����� ��� ��� �� ��� ������ H���� ��� ���

7 ���������� ��������������;�������������������7����@ �*����

������������ ���J� ������������������������<� �

Page 63: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "!�

) 2�� � ����"������������������� ���������<������;��� ���

�:������C� ��� � ���� ���� ��� � ���� ���� ����� � �� ��� ���� ����

������������������������ ������� �������������<� �H�� ������

��� ��< ��� ���� ��<� @� ����� ��� �;��� ����� ��� ����������� ����� ����

��<����;�������������� ��� �*���� �������� ���� �����������������

��������� ��C��������� � �������� � ������������������������������C���

������������������C�������� � �������<��������������������������

�����������������������������F� �

, 2�� � ����� ��#�� ��� ����� ��� ���� ��� ���� � *���� 7������

��� ��� � ���� <����� ��� ������ ��� ����� ;��� ���� ��� ��� ���

��������� ���� ��� ����C� ��� ���� �� � ������ ��� ��������� ���� �

��������� ������ �7���� ����������������������<� �

1���� �������� ��� ��� ��� �� <�������� ;��� ��� ����� ���

������ ��� ������� ���7���������� �� ��� ������ ��� ���� ��� ���

H���#��8!�@ �

*�������������������������:� �#������;��������������������

7�� ��� H��� �����������@� �� ���� ����� ;��� ���� ��� ��� ���� ��� ���

���������� ��� � �� �1����7������������7 � �������;����������������

������ ��������C�������� ���������� ���� �*���:�� ���������������

������������������������;� ������ ��� ���H�������C����:��<M@C������

;���������� ��C������ ����C��������;���������������������������������

�� ��� �

-����<��������������������������� ��� �� �*���� ����������� ������

����� ����� �� � ������ ��� �F���� ��� ���� ������ �7�� ���� � ��

����������������������� ����������� ���������;���� 7����� ������

� �� ��� � ��� � �� ��� ��� ;��� ��� �:�������� ��� ��� ��� ��C� ��� �� ;���

�����7���������J�� ������� �

Page 64: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

-�� J�� ��� ����� ��� ��� ;��� � �� �<��� ������ ����7����� ��� ���

��� ��� �� � &�� ����� ������� ������ �� � ���� ��� ��� ��� ��� ���

� ���� ���� �� ���C�����&/�C���� ������������������������ �

1������� � �������� �:�� ������� �����������C������;������

��<����� ����� H��� ��� ��� ��@� ������� ������������ ����� ����� �� ���

���� � �� ��� ��� ����� H������� ��� ���� ����C� ���� ��� ��� � �IC� ��� ���

�����:����� ����M@ �*������������������������� ����C������;������

���� ������� ��������������� � ����������7��� ��������������� �7�� ��

����� ���� ��� ���� ��� �� �� ����� ��� F���� J�� �� � 9 ��������� ��� �����

����� �� ���������� ���� � ��� � �� ;��� ;������� ����C� ��� ;��� ���

����7������F��������������������������� �� ����7��� �

+����� ��� ��;����� ��� ��� ��;� �������� ��� ������ ;���

�������������4�

Page 65: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � " �

��

� �� ! ����� � #�

�#�I������ � �� � �

Page 66: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ""�

*�� ����� ������ ����� �� �������� ���� ������� ;��� ����� �����

����� ��7 � �� ��� ��;� �������� ����� �C� �� ��� ��� ��� � �� ����

����� ���C��������������C������������� ��� ������ ���� ��� �� �

C%&%-%�5��������7���>�

������������ ��C�����������������������7 � ������� �������

���� ���;����������������������������� ��� �

����� �������������

*���� ������ 7�� � ��� ��� ��� ��� ���� �������

& ������/<���8& ������- ������C��������������������� ���, , � �

*��������������� ������J� ��''!&������ ���� 7 ����������� � ����

��������& ������- ������������������������������������ �� �*����

�����������������4�

��� � � ��������4� ����� ��� � ����������� ��� ���� ���

���Q ��C� ��� ����� ��� ���������� ��� �7���� ��C� ���� �� ���

������� �������������� �

�J�;�����7 ��� �����H���� ��� � ������������ � �@�

2"� 7 ��� ��4��������� ��������:������������������ ���� �7�����

��������� �

-���J�;�����7��� ���������� <� �����7���4�

�@� �� � � �� ��� �J�;����� ��� � ��� � ��� H��� ��� �F���

������2��E����@�

)@� ����� ���� ;��� ��� ���������� ��� � ��� � �� H������

����������������@� ��� �������� ��� ��� ������ ��� � ��� � �� � /��

7 ��� ��������J�;�������������������������E�������$����� �

,@������������ ��� � ���������������� ��� � ��4�

�@����Q������������������� ��� � �� �

�@� �� � � �� ��� �J�;����� ��� ���� � �� ��� ���� � ��� � � � /��

��� � �� ��� ������ ������������������� ��� ������ ��� ������

�������������������������������� � �

Page 67: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

�@�/����� � ��������������0���$��������������������, �

5@� � ��� ������ ��� � ��� � ��� ����� ����� ��� ������ ��� ������

���2��E����(����3��� �

���� �����

'������ ���� ������������������������������< ������� ��������

�� ���������� �

*��������������������������� �������������������''!&������

��� ����������������������7����H�����4!���<��C�/�� ���4�� �<@ �

*���F��� � � ����� � H@������������������;��� � � ����������� � ��������F������������������������� ���������� <� �����7��� ��

�while(servicioActivo){

acepta conexion entrante crea un registroCliente para el cliente inicia una hebra de lectura (Servidor.HebraLectora)

} �

*������������� �� ��������������;����� ���������������������� ����

����������� ������������� � ���� �������������������������������� ��

� � �� ! ���(�#��*����

-��!J����#��������� ���������� <� �����4�

• �����)��������*���%���+�����/�����������,�

Page 68: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "��

o �� 7 ��� ��� ��� ����� ���� ��< ���� ��� ���� � �

H��� ��$����@�

• �������������������+,�

o � ���������� 7 �����������Q ����

o &�������������������� ������

• ���������������������+-���������������,�

o 9 ��� ���������������������� ������������ �����

o *� � ������$�< ����� ����������������� �

o *� � ������������������������� ���� �

• ������F����8������+,�

o /G���� ��� � ������� ;��� ��� � ��� ��� ������� ����

���� ���

• ������%��������+,�

o ����������� ���� 7 ������������� � �

• %����������*�����+,�

o &�������������� �������������������� ������

-���������;���<��������4�

• ������������������+,5���<�������������������� �� ����H���

;��� � � ��������� � ��������F����������������Q ���@�

• ���������*F�����+-���������������,5���<���������� F��

�������������� �� ����

• ���)���4�-���%���+�)'$��G�����/�-���������������,5�

�� <������ ��� ��� ������ ������� �������� ����� �� ����

�� ���� �

• ��������������������+-���������������,5���<���������

��� ������ ������� �������� ����� ��� �� ����� � ;���

��������� �

�������

Page 69: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � "#�

*���� ������������������������������������;� ������� � C������

;��� ��� ��������� ����� ;� ��� ��� ��<��� ��� ''!&� ���� ���� � � ��� ;���

;� ������������� �

�J����#���(��(��"����

• �������+������-8,�

o ���������������H�%�����&���

o *�������������� ���������Q ���������� ��������������

�����������������H�%��8�������

o ����������������������&��H@�������� ����

• �F����8�������

• ��������

• �����������

• ���-8�

*�"��#�.�"�� ��#��

• ���)���4�-���%���+�)'$��G�������4�,5�*������������������

• ���������&��+�������,�

• ������&��+,�

• �����������&��+,�

Page 70: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

Page 71: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

C%&%-%�5��������7���>�����

*�� ����� ����� ��� ������������ ��� ����� ��� �:����� ���

��� ��� ����������������'�7���I �*�������� ��������� � ����������

;�������������������C������� ���������� ��������������������

��������� ����� ������ � ��� ���� ����<� ��� �������� ���

�������� ��������� H��� �:����C� ��� ���� ��@� ��� ��� ��������

������7 �� ����� ���� ��� ��� ��� H��� ���� ��� ����@ � *�� ����� ������

��7 � ����������������������;����������������������������

�������� �������� �

+���� �� ��������� ���� ������� ����� ������� ���������� :����

�������� 7����� ���;����� 7 �������������� ����H����������7 �@�

��� ����� ���� � *�� �������C� ��� ���� ��� �� ��� �� ����� ������� ��������

���� ����������� ��������������������� �

�+#� ���� ( #�1 ��

/�� 7����� ���������������� � ���������������� ��������� � �

������7 �C������������C��������C������;���� �����������<�������

������������������ ��������� � ������ ����������7���I���� ��

������ ������ ���� � �C� ��� ��� � �� ��� ��������������������

��� ���� ��� ������ ���������������H�������C� ����@� �� ��� �����

����� ��H����������� ����7��@ �

*����������������� <����;������������� � � �

� ( �1 ��

*���������� ������� �7���� �������������������������:�����

���'$-C���������C����������������� ���� �� ��

���*�����

Page 72: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*�� ���� ��� ��� ������� ��� ��� ���� ������ ���� � *���;� ����

��� ��;������ 7����� ������;����������������������������� �7�� �����

J� ������ � �;��������������������� ����������''!&��������� �����

������7 :�4�

public static UUID UUID_Ulfsark_Chat = new UUID("102030405060708090A0B0C0D0F0F010", false); public static final Integer ID_nombre_sala = new Integer(59169); public static final Integer ID_creador = new Integer(59170); public static final Integer ID_nclientes = new Integer(59171);

/������ ������� ��� ��� <�� ��� ��� � �� ���� ��;������ ;��� ���

�����������������4�

public static final byte MSG_GLOBAL = 0x0; public static final byte MSG_PRIVADO = 0x1; public static final byte MSG_LISTA_USR = 0x2; public static final byte MSG_NUEVO_USR = 0x4; public static final byte MSG_ERROR = 0x5; public static final byte MSG_AVISO = 0x6; public static final byte MSG_NICK = 0x7; public static final byte MSG_LOGOUT = 0x8; public static final byte MSG_WHOIS = 0x9; public static final byte MSG_LOGIN_OK = 0xA; public static final byte MSG_USR_DESC = 0xB; //Usuario desconocido public static final byte MSG_NICK_USO = 0xC; //Nick ya en uso

*������ ���� ������������������ �����C�������������� �� ������

� �I�� ��� ��� �� ������ H����� ���� ������� ��� $�< ����� ����@� �� ���

���������� ������� �*������ ��� ���� F����������������� ���������C�

�����;������� F��� �������� �I��������� �

-��!J����#�:K#���#���(�#��*������������ <� �����4�

• ���" �IH�� �<� � �I@4� ��������� ;��� ��� ����� � �I�

H�������������� @�����������F������ � ������������ ��

��� � �I� �� �7���� �� ��� �� ������ ��� ����� ��� �����:��

��Z"!�A �

Page 73: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �!�

• ���"�������H�� �<� �����@4� �� 7 ��� ��� ��� ����

������ ��� ��� ���� � /�� �� 7 ���� ��� ��� ���� ��� ������

�� ���������������������������������������������� �

• ���������H�� �<� �����@4� �� 7 ��� ��� ��� ���� ������

��������������������� ��

-��!J����#���( ��*�#� (��1 ����4�

• ������+,5� !� � �� ��� ���� � � "� ����� ����� ������ ��� � �� ���

��������������������

• �����+,5� &��������� �� ����� ��� ��� ��� �� �����C� ����� ���

� �I������� ����������� � �

• �����)���4����%��+�������G.���/��������,5�*�����

�����;�������Z"%$�/-��� ������� �� �������Q��������

�� ���������� �I����� �I%� <�� �

• �����)���4�'������+����� ��G������/� ����� ��,5�

������ ��� �����:�� ��Z�$!+/&%� ��� �� ����� ���� � �I� ���

� �I&��� � �

• 9������ �%����8��������������+,5� ��������� ��� +����� ���

�:����$�< ����� ���� �

-������������ � �������������������� <� �����������4�

������*F�����5�

�����������������5���������������;�������Z-%�%'#�������

��� ������ �� ��� ������ ��� � ������� ���� ���� ��� ��� ������

���'���� &����������H��������������;�������� ������< ���������

� �I@ �

���������������4� �7��������� ������ �

)���4�-���%���4� *���� ������ ��� ��� ���� �������� � -�

�Q�� ���������� ���� ��4�

.�#��)"����(�#�!�"# ,�#�����:���#C����7��� ���������� <4�

� ��.L����L����

Page 74: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

o ����� �I�����������C�����������������;�����

��Z"!�AZ'%�

o ��C� �7�������� �������H������������������@C�

��< ���������� �����H<���������� �I@C���������������

��;�������Z-%�!"Z%A���������������������� ������

�����;�������Z"'*+%Z'$�

o !�7�������� ������4��������������������

� ��.L.�����4��

o �����������������;�������Z�-%�/-�������� ���

��Q��

o �7�������� ������4���������:�$�� � ��

� ��.L����� �4��

o ����� �I�������� ����� ��������������� ��C� �7�������

� �������H���)���4�'������-���%���@�

o ���������C������������;�������Z�$!+/&%����

�� �����;������<������� �IC�������� �����Q��

o � �������� �<����� ������������� �IC���������������

��;�������Z'$Z&*��

Page 75: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � � �

� ��.L�����L����

o ����������;�������Z-!#/Z'$�������� �I��������

����� ������������������ ����� �

� ��.L���>�

o ����� �I�����������C��������������������:��

��Z"!�AZ'% �

o *��������C���< �������������� �I������ �����������

�� �����������;�������Z"!�AC�������� �I������ ����

������� �

o !�7�������� ������4����;����;��G �

Page 76: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �"�

� ��.L��.����

o !�7�������� ������4�����������������������

o &�������������� �����������������< ���������� �I�

�(��"���

9 ��������� ��� �� ����C� ��� <���� ;��� ��� ���� ��� �� � ��� ��� �� �����

<��F� ������������ �� ���������������� ��������� � �

������������������������ �������:����������F����������H@ �/��

��� � ��������&��H@�������Q ������7 ��� �������FQ �C������;���

��� ������ ��� ��;����� ��Z"'*+%Z'$� ��� ���� ��� ;��� ��� ���� ���

� �I ������������ �������� �����Z-%�!"Z%A����������7 ��� �������

��< ���������� ���� �

Page 77: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

�J����#������� ����4�

• ���%���;��G+�������G,�

• ������������%��;��G+����� ����;��G,5������ ��� ��;�����

��Z"!�A�������� �� �*������ ����������7��� ��������

������ ��������;�������Z"!�A��������� ��C���7 ������

��������� �I �

• ��������8�������������5���� �������;�������Z-!#/Z'$�

������� �� �

• �����)���4�+����� ��,5��� �� ��� �����:��

��Z"%$�/-�������� ��C���������Q������

• �����)���4�'������+����� ��G/� ����� ��,4� ��� �� ���

���� �����������:����Z�$!+/&%C� ������������� �I�����

���� ����� �����������:��

• �����+,5���� ����������:����Z-%�%'#�������������

• ���8�������

-���������;�������������� ��������� <� ������

o ������&���H����������� ��@�o �����������&��4������������������������������&��������������� �������

o ���������&��5������� ������ ����������������������&��'�������

Page 78: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

o ���)���4�-���%���C����7��� ���������� <�<��������������4�

� ��Z"'*+%Z'$�2 �̀������������������+���������+,,�

� ��Z-%�!"Z%A�2 �̀���8�����$������+,�� ��Z"%$�/-�2 �̀���)���4�-���%���+I,�� ��Z�$!+/&%�2 �̀���)���4�'������-���%���+I,�� ��Z-!#/Z'$�2 �̀���8����-���%���+��G�,�� ��Z"!�A�

• ���;����;��G+��G*������/���G;����,7�• � �� �I/���� ��������� �I����������� ����C�

<���������� �I���������� �I��������� ��Z"!�AZ'%�2 �̀���;������������������+J;��G������J,�

� ��Z'$Z&*������;������������������+���������+,�K�J���

�������������J,�� ��Z-%�%'#�2 �̀���������������������+I,�

��

C%&%-%�5����������'&��D�'&���

9 ����������������������� ��� �����������������;���������������

�7���� ���������������� �7�� ���C���;���������������� ��� � ��;���

;����������� �������������� ���� ����������:�����������

����&/��������������� ��������������������7��� ���������������

������� � �H����@ �*����������'�7���I���������������C���� ����������

������� ��C��� ������������������������� ������� 7 ����� �<J���������

����� ���������������� ���������� � �̂�����������7��� ���������J�� ���

����C�������;������� ��G��������� ����7���������4�

�@ & ��� � ������ ������������7���������)�� ���� � ��

�@ & ��� � �����������7���������)���������*� � ��

!����7����)�*�

Page 79: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �#�

� *������:�� ���� �� ���C��������������������������������

�� �� ������������� ��� � ������ ��� �-��� ����;��������������

���������J�;�������������������������� �� �����7��� ��������

��<���� �

� ���J��� �� ���4�

� ��� ��# ( 4�������� �������������������7������ �� �����

������;�������� � ������������� �������������������� �&�����

�����7������ C������������������������7 ������������� ���

���������� �'���������7 ����C���������������3��!+( ����

�����"*��# ��)" �

) �"��#�� �# ( 4������� ������������ ��C���������������

� "� (( ����:M#B+�� ��

Page 80: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

, ��#�������!� ��:�(�� �4������������� �����������;���

�� ���������� ��� � � ����������/�!��;�������� ������

��<����������7��� ���������������� �����������

��� ��� ��C����/�!����;��� �����4�

� /�!��������4�������� ������;�����������7��� ���

� /�!�7 �������� �4�������� ������<��������<���������

�������� ���C������� ������ �� ����

� $�4����� ������ �������������� ��

5 �����"�#4������������������������������7������ �������

� <� ���������������4�

� " �I���������� ������������

� %�� ��������<< �<4��

� & ����� ���������<�������������<��

� 9�����

� %�� ���������<< �<4�

� "�����������<C�

� !���� 7 ������������� C�

Page 81: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

� �������G��

� '$-�

� &����������7������ C���������������������J�

�� �� ��������������������������������������� � �

���������C������������������� ���������<��� ������

��< ������������ ��H$�@������<�������������7����

���� �������� ������� ������������������ ����������

���� �� �

G% �"3��! ��)"����(�#� +����#�

N% � (���

� 9������ ������������ ��4�

� *����7������ ���������������������������Q�������

��� ��������:���������� �/������������C���� ��� � �������

�����:������ � ��������������� �����������H����������

��� �������:������������ �������@ �# ��������������������C�

���������� � ���������������������� ���������������� ���� ��

Page 82: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

� �������������J�;�����

� *����� �����H������- ��@���������������������������

�������������������������<��� ������� ��������������

���� 7 ������������� ����4�

� "����������������

� "���������������������������

������������� �������J�;����C���� �� ��������������� �

!����7����)*�

$% �"���3 A���(�#��*���������1 ��

� �

� � -��7��� ��� ����;�������������������������� �����������

������)*����� ������������������ ����������� � �������� �� ��� ���

�����������:��������� � �������������� � ��������C���� ����7���

��������������������������������������������4�

� ���������������������� � � ��8������������ � �

� - ������������ ���������������

� ����������������� ���

Page 83: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �!�

� �����������������:�������� ����� �

� ���������;��������� �����������:������������� �H���� �������

��� ����� ��C����������� ��������������@���������������

�������� �

&% �"���3 A���(��(��"�������1 ��

� *����������C������� ��� ������������ ������� �� �&�������� � �����

����� �����J�;���������������������������������C�������Q ��������

���� � ��� ������F�����H������������� �����������:��@ �

� -�������������������� ����7��������4�

� �����������������

� - �����������������������������������

Page 84: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

� ����������������� ���H������������ ���� ����������������Q��

�������� ��������:��@�

��������������:�������� ������

Page 85: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � � �

G%��������������

'�7���I��������������� <���������������������������� ��� ����

������� ��� ���������� ��� � ���������� �1����������� ��;���

��������������������������C������� <C������������� �����������

����� ����� � ���� �� 7������ �������������� ����� ���� ���� ��� ��� ����

������������ �

'������ ��� ���'�7���I�����������������������4�

$ -���� ����C������'�7���IC������������� ��C��� ���������������

������� � ��<��F� � �

$ -����<����C�������������� � C��� � �������������������� ����

������������������ � �������7 ��H�������������C��������@ �

$ -��J�� �������������� ����7����������� ��� ��� � ������� ������

������;������� ����������� ��� ����������� �

��� ����� ��;��G��� �� ���� �� �������� ��� 7�� �� ������

���� ��� ��� ������ � ��� � ��� ������� � /������ ��� ��� ��� �����

����� ;��� ��� �J���� ��� � ��� � ��� ����� ����� ���� ����� �� ��

����;� ������������� ����C���� ����������7���������� ��� ��� �

/�<���������������� ��� ����7�������;������������������4�

2���#��! ����*�� ��)"�

*������������������7�������� ���������< � �-������� �������

������������� ����������������C����������������������������������

���� ��������C���;������������� ���C����� ��������M�

2�'+���#�!+(��,+� ����

����:������������;����������� �7���� ����������� � ����������

����������:� �

Page 86: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � �"�

2��#���"�����"�� �

-�� ������� ������� �������� ����� ���� ������C� ��������� ��

���<������������7���C���� �������� �

2��1 ���"�(+� ��#���������

����:����C������������� ������C�������������� <�C�� <��M�

2���!�+� ��)"���#���:+�� �

����� ������������������ ��� ���������������� ����������� �*��

����� ���� ���������� ;��� �� � ���� ��� ������ '�����I��� ����� ������

��;���������� ���� ��� ��C����������������Q �� �

2�� "�,�����+"������#���+"���#��#���*��!)*�(�

*���� ��� ���� 7��� ��� ���� ���� ���������� � *Q ����� ������� ���

����� ;��� ���� ���� �:������� ������C� ��� �� ��<�����C� ����� ���

�����C� ���� ��� ����������� ��M� *�� � ��� � �� ��� �� ������ �������

����� �������� ��� �:���� ��� ��� ���������C� ����������� ��C�

����������������J� ��M�

2��!���#�)"�������+!�"��#�

*Q ����� ��������� �������� ;��� ���� ���� ��� � �� ���� ���

������� ��� � ���������;������� ���� ��

2�����#���#��#���*�#�

*Q ����� ������ ���� � ��� � ��� ������� ��� �&/�C� ��� ���� ��

���������� ���������� ;��� �� � ���� ��� �����<��� ������� �

+ ��������C� �������� ��� 7��C� ��,C� ��M� '�7���I� ������ ����

�� � ������������� ������������������� ��� � ������������ �7���

������ ��� ��� �

Page 87: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

*����������������:������;���������������C������ �����

����� ��������� ��� �������� ;��� ������ ���<��� �� ������ ����� �� '�7���I�

��� ���� � "������� ����� ��� ��C� ����C� ������ ���� ����� 7�� �� ���

�� � ������7����������� ������������������7�� �����������;� ��� ����

����� ���;������������������� � �

Page 88: developer and user guide 1.0 (pdf)

���� ��� ���������� ��� � �������������������������������������������� �����������

������������� ���������� �

������ ������ � � � � ���

N%�������.��7���

�$ �(+�����1�3���' * �2�����H�$G������-�4��0�*�0�� � *��

/����� �

$ ' * ������#�3����(+�����1���9���(�##����1"�(����4'��2

@&5��$�����������9������=� ��L����)���'�������/�)������������

$ '&�%������������3�-�4���8�����.���� �&����&�� ����

-��<��:������ ��� ���������������� �� �* # ����!�<�� �����

!�7���� ���'� ���� �����������<��

$ '��2@&���(+�����1���#���' * �*�%�����������2���%��

$ ����488:��� ��� ���

$ ����4887��� �I � ���

$ ����488�� P I ��� � �<�

$ ����488PPP ��2���� �� ���

$ ����488:�� �<8��������8����� ��������87 ���8:��LS=8�