English dropdown-ico

Philips Bluetooth QuickStart Kit manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Philips Bluetooth QuickStart Kit, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Philips Bluetooth QuickStart Kit one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Philips Bluetooth QuickStart Kit. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Philips Bluetooth QuickStart Kit should contain:
- informations concerning technical data of Philips Bluetooth QuickStart Kit
- name of the manufacturer and a year of construction of the Philips Bluetooth QuickStart Kit item
- rules of operation, control and maintenance of the Philips Bluetooth QuickStart Kit item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Philips Bluetooth QuickStart Kit alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Philips Bluetooth QuickStart Kit, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Philips service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Philips Bluetooth QuickStart Kit.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Philips Bluetooth QuickStart Kit item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    Bluetooth QuickStart Kit Version 1.0 - User’s Guide Copyright 2004-20 05 © Embedded Ar tists AB EA2-USG-0402 Rev A Bluetooth QuickStart Kit User’s Guide A Quick Way to Start Using and Integrate Bluetooth in YOUR Application… Builds on InfraBed™ technology[...]

  • Page 2

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 2 Copyright 2004-20 05 © Embedded Ar tists AB Embedded Artists AB Friisgatan 33 SE-214 21 Malmö Sweden info@EmbeddedArtists.com http://www.EmbeddedArtists.com Copyright 2004-2005 © Embedded Artists AB. All rights reserved. No part of this publication may be reproduced, transmitted, tran[...]

  • Page 3

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 3 Copyright 2004-20 05 © Embedded Ar tists AB Table of Contents 1.1 Contents ......................................................................................... 4 1.2 Using Bluetooth QuickStart Kit in Products ................................ 4 1.2.1 Design and Produc tion Serv ices[...]

  • Page 4

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 4 Copyright 2004-20 05 © Embedded Ar tists AB 1 Introduction Thank you for buying Em bedded Artists’ Bluetooth QuickStart Kit based on the LPC2106 ARM7™ microcontroller from Philips and cb-OEMSPA-13i industrial Bluetooth m odule from connectBlue. The Bluetooth QuickStart Kit contains [...]

  • Page 5

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 5 Copyright 2004-20 05 © Embedded Ar tists AB Modifications to the design for OEM produc tion can easily be done. Contact Embedded Artists for further information about design and produ ction services. 1.2.1 Design and Production Services Embedded Artists provide design services for cu st[...]

  • Page 6

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 6 Copyright 2004-20 05 © Embedded Ar tists AB 2 Bluetooth QuickS t art Kit This chapter provides a description of the Bluetooth QuickStart Kit ; the platform (software and hardware aspects), features, and typical usage. 2.1 Software Platform The Bluetooth QuickStart Kit includes a pre-des[...]

  • Page 7

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 7 Copyright 2004-20 05 © Embedded Ar tists AB • Software platform code base is easily ported and extended to other hardware, including other processor families. • Many sample applications included in order to lower the threshold t o get you started. • Complete development environmen[...]

  • Page 8

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 8 Copyright 2004-20 05 © Embedded Ar tists AB PDA ANY Sy stem Applic ation Laptop WWW Stationar y Etherne t Bluetooth Qui ckStart Ki t Expo se Cont rol PDA Laptop WWW Stationar y Etherne t ANY System Appl icati on Bluetooth Qui ckStart Ki t internal parameters in the system. Communication[...]

  • Page 9

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 9 Copyright 2004-20 05 © Embedded Ar tists AB are many interesting business possibilities when integrating diagnostic functions in a system, like better maintenance and a profitable after market. Remote administration and rem ote control gives the prerequisites of lower worki ng expenses,[...]

  • Page 10

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 10 Copyright 2004-20 05 © Embedded Ar tists AB 3 Bluetooth Use-Cases This chapter provides a description of typical use-cases when using Bluetooth in industrial applications. 3.1 Typical Industrial Bluetooth Use-Cases There are basically two different use-cas es for industrial Bluetooth a[...]

  • Page 11

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 11 Copyright 2004-20 05 © Embedded Ar tists AB 3.3 Remote Control Remote control is almost the same as remote acces s. The only difference is the direction of the information. In remote access the informa tion mainly flows from the remote sy stem to (typically) a central place. In remote [...]

  • Page 12

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 12 Copyright 2004-20 05 © Embedded Ar tists AB decisions must be made quickly. Trends can be discovered when analyzing the data, for example that a bearing is about to break down bu t will hold for another two m onths. Maintenance can in such cases be planned in advance to minimize the op[...]

  • Page 13

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 13 Copyright 2004-20 05 © Embedded Ar tists AB A field engineer, or similar, can then easily access all relevant documents directly on site. The system becomes more self-contained since all relevant documents “follow” the sy stem. The benefits are also in this case numerous: • Easy [...]

  • Page 14

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 14 Copyright 2004-20 05 © Embedded Ar tists AB incoming connection requests to the LAN Access Profile, the LAP role must be enabled in that specific device. It is possible to enable several instances of the LAP role in order to allow several parallel connections through the LA P. A device[...]

  • Page 15

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 15 Copyright 2004-20 05 © Embedded Ar tists AB 4 Compiling and Running Application Programs This chapter provides a description of how to develop, com pile, and download applications into the Bluetooth QuickStart Board . 4.1 File Structure The pre-designed software platform is delivered a[...]

  • Page 16

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 16 Copyright 2004-20 05 © Embedded Ar tists AB application and a makefile. The makefile contains directives of how to com pile and link the complete application. A typical makefile is listed in Figure 11 below. /* * Example makefile that creates a program called ‘mySampleApp’ */ # nam[...]

  • Page 17

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 17 Copyright 2004-20 05 © Embedded Ar tists AB • Keil uVision (DKARM version) This is another complete development e nvironment, but from Keil. It includes an editor, project manager, a complete compiler build environment, and a debugge r. An evaluation version can be downloaded from Ke[...]

  • Page 18

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 18 Copyright 2004-20 05 © Embedded Ar tists AB The installation files for both programs can be found on the accompanying CD- ROM. • JTAG For specific information about program download (i. e., Flash programming) with a JTAG interface, consult the manual for the specific JTAG interface t[...]

  • Page 19

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 19 Copyright 2004-20 05 © Embedded Ar tists AB Figure 13 – LPC21ISP Portable Command Line ISP Screensh ot A typical program download sequence may look like in Figure 14 below. As seen, the first part is the actual program download phase. Then this is done, the program switches to being [...]

  • Page 20

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 20 Copyright 2004-20 05 © Embedded Ar tists AB 5 Schematic and Measurement s The chapter describes the Bluetooth QuickStart Kit board schematic and m easurements. 5.1 Schematic The Bluetooth QuickStart Kit board schematic is drawn in Figure 15 and Fi gure 16 below. Figure 15 – Bluetooth[...]

  • Page 21

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 21 Copyright 2004-20 05 © Embedded Ar tists AB Figure 16 – Bluetooth QuickStart Board Sche matic Drawing Page 2[...]

  • Page 22

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 22 Copyright 2004-20 05 © Embedded Ar tists AB 5.2 Board Interfaces The Bluetooth QuickStart Kit board has a number of external interfaces as illustrated in Figure 17 below. Figure 17 – Bluetooth QuickStart Board Interfa ce Description Table 1 below explains each board interface in more[...]

  • Page 23

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 23 Copyright 2004-20 05 © Embedded Ar tists AB Power jack 4-6 V DC, at least 150 mA. The power input is protected against reverse polarity, but the board may still be damaged if reverse polarity is applied. Also, never exceed +6V DC because the on-board voltage regulator will then be dama[...]

  • Page 24

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 24 Copyright 2004-20 05 © Embedded Ar tists AB OEMSPA-13i datasheet for details about functionality. This push-button should norm ally never be used, and it is only active during power-up of the Bluetooth module. RGB LED #1 This RGB LED is controlled from the Bluetooth module and indicate[...]

  • Page 25

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 25 Copyright 2004-20 05 © Embedded Ar tists AB 5.4 Board Jumpers There are six jumpers and one switch on the board. These are illustrated in Figure 18 and explained in Table 3 below. Figure 18 – Jumper Descripti on The table below explains the different jumpers. J3 – DBGSEL Enable or [...]

  • Page 26

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 26 Copyright 2004-20 05 © Embedded Ar tists AB J6 – CTS The application program has the option of controlling the RTS/CTS signals on the RS232 serial channel, if needed. If used, signal P0.22 is the CTS signal and P0.22 must be an output. Jumper shorted = Pin P0.22 act as RS232-CTS sign[...]

  • Page 27

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 27 Copyright 2004-20 05 © Embedded Ar tists AB 5.5 Board Measurements The board is 108 x 58 mm and Figure 19 below illustrates the mounting hole positions. The four mounting holes are 3.5 mm wide and 50 x 100 mm apart. Figure 19 – Mounting Hole Posi tions 100 m m 50 m m[...]

  • Page 28

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 28 Copyright 2004-20 05 © Embedded Ar tists AB 6 Further Information The Bluetooth module from connectBlue and the LPC2106 m icrocontroller from Philips are complex products and there exist a number of document with a lot o f information. The following documents are recommended as a compl[...]

  • Page 29

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 29 Copyright 2004-20 05 © Embedded Ar tists AB [17] Em bedded Artists’ Reference Document ation: TCP/IP Protocol Stack http://www.embeddedartists.com/download/pdf/refDoc_tcpip.pdf [18] Em bedded Artists’ Reference Docume ntation: Embedded Web Server http://www.embeddedartists.com/down[...]

  • Page 30

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 30 Copyright 2004-20 05 © Embedded Ar tists AB A connectBlue’s Serial Port Adapter Wizard The Bluetooth QuickStart Board is designed to work with connectBlue’s Serial Port Adapter Wizard program – a program that helps you to configure the Bluetooth m odule for your specific needs. N[...]

  • Page 31

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 31 Copyright 2004-20 05 © Embedded Ar tists AB B Application Program Interface (API) This appendix describes the QuickStart library API in detail. The description is divided into functional sections. Please refer to appendix C for sample applications that illustrate how the API can be use[...]

  • Page 32

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 32 Copyright 2004-20 05 © Embedded Ar tists AB Returns: TRUE if semaphore was taken and FALSE if timeout or error. Possible error situations (what can be identified in an error code): OS_OK - The function completed successfully. OS_ERROR_ISR - The function was called from an interrupt ser[...]

  • Page 33

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 33 Copyright 2004-20 05 © Embedded Ar tists AB B.1.7 osPid tU8 osPid( void ) This function returns the process identifi cation descriptor for the running process. Returns: The process identification descriptor of the currently running process. Possible error situations (what can be identi[...]

  • Page 34

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 34 Copyright 2004-20 05 © Embedded Ar tists AB [in] pProc - The process entry function. [in] pStk - A pointer to the stack area to use. The stack area must be allocated before the process is created. [in] stkSize - The size of the stack area in bytes. [out] pPid - The returned process id [...]

  • Page 35

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 35 Copyright 2004-20 05 © Embedded Ar tists AB void osSuspend( void ) This function suspends the currently runni ng process. Another process can resume it by a call to osResume. B.1.15 osResume void osResume( tU8 pid ) This function resumes a suspended process. It is valid to do resume on[...]

  • Page 36

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 36 Copyright 2004-20 05 © Embedded Ar tists AB Parameters: [in] pSem - A pointer to an initialized semaphore structure. [in] timeout - After timeout ticks the operation will timeout. If a timeout of zero is specified the function will never timeout. Returns: TRUE if semaphore was taken an[...]

  • Page 37

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 37 Copyright 2004-20 05 © Embedded Ar tists AB void m_os_ena_int( void ) This macro enables interrupts. B.1.22 m_os_dis_int void m_os_dis_int( void ) This macro disables interrupts.[...]

  • Page 38

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 38 Copyright 2004-20 05 © Embedded Ar tists AB B.2 TCP/IP API B.2.1 m_buf_get_data The macro m_buf_get_data is defined as: #define m_buf_get_data( pBuf ) func( pBuf ) Where func is a function with the following prototype: void* func( tBuf* pBuf ) This is a macro that retrieves a pointer t[...]

  • Page 39

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 39 Copyright 2004-20 05 © Embedded Ar tists AB B.2.4 tcpListen tS8 tcpListen( tTcpTcb* pTcb ) Set the control block in listen mode (i.e. server) Parameters: [in] pTcb - an allocated and bound TCB Returns: One of the error codes specified below. Possible error situations (what can be ident[...]

  • Page 40

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 40 Copyright 2004-20 05 © Embedded Ar tists AB Parameters to (*pRecv): [in] pTcb - control block for the connection. [in] pBuf - pointer to the buffer containing da ta. A pointer to the actual data can be retrieved by using the m _buf_get_data f unction. [in] len - length of data in bytes[...]

  • Page 41

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 41 Copyright 2004-20 05 © Embedded Ar tists AB Parameters: [in] pTcb - control block for an established connection. [in] pData - data to send [in] len - length of data Returns: One of the following error codes: Possible error situations (what can be identified in an error code): TCP_OK - [...]

  • Page 42

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 42 Copyright 2004-20 05 © Embedded Ar tists AB This function allocates a new control block. Returns NULL if there are no more control blocks available. Returns: An allocated TCB or NULL if none available. B.2.13 udpBind tS8 udpBind( tUdpTcb* pTcb, tIPAddr* pIPAddr, tU16 port ) Bind a TCB [...]

  • Page 43

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 43 Copyright 2004-20 05 © Embedded Ar tists AB This function must be called when received da ta has been processed. If this function is not called the received buffer will not be de-allocated. Parameters: [in] pTcb - control block for an established connection. [in] pBuf - processed buffe[...]

  • Page 44

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 44 Copyright 2004-20 05 © Embedded Ar tists AB B.3 Web Server API B.3.1 m_get_request_method The macro m_get_request_method is defined as: #define m_get_request_method( pConn ) func( pConn ) Where func is a function with the following prototype: tU8* func( tConnect* pConn ) Get the reques[...]

  • Page 45

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 45 Copyright 2004-20 05 © Embedded Ar tists AB #define m_get_query_string( pConn ) func( pConn ) Where func is a function with the following prototype: tU8* func( tConnect* pConn ) Get the query string (e.g. "x=10&y=34") for a specific connection and request. Parameters: [in[...]

  • Page 46

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 46 Copyright 2004-20 05 © Embedded Ar tists AB Parameters: [in] pConn - control block for the connection. Returns: The EGI state. B.3.8 m_set_egi_state The macro m_set_egi_state is defined as: #define m_set_egi_state( pConn ) func( pConn ) Where func is a function with the following proto[...]

  • Page 47

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 47 Copyright 2004-20 05 © Embedded Ar tists AB Parameters: [in] pConn - Control block for the conne ction. [in] intVal - Integer value to print. Returns: TRUE if the string version of the integer could be copied to the o utput buffer; otherwise FALSE. B.3.12 comPrintChar tBool comPrintCha[...]

  • Page 48

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 48 Copyright 2004-20 05 © Embedded Ar tists AB [in] value - An integer header value. This parameter is only used when pHeaderStr does not end with CRLF and pValue == NULL. Returns: TRUE if the headers was sent; otherwise FALSE B.3.15 comEndHeaders void comEndHeaders( tConnect* pConn ) End[...]

  • Page 49

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 49 Copyright 2004-20 05 © Embedded Ar tists AB Parameters: [in] pPath - The directory path to the command hook. [in] pHandler - The EGI function. Parameters to (*pHandler): [in] pConn - Control block for the conne ction. Return value of (*pHandler): EGI_DONE, EGI_ERROR or EGI_SUSPEND. Ret[...]

  • Page 50

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 50 Copyright 2004-20 05 © Embedded Ar tists AB Parameters to (*pFreeName): [in] pName - Memory to release. Parameters to (*pFreeAddr): [in] pAddr - Memory to release. Parameters to (*pAccess): [in] pName - Name of the variable [in] pAddr - Address of the variable. Returns: TRUE if the var[...]

  • Page 51

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 51 Copyright 2004-20 05 © Embedded Ar tists AB [out] ppSym - The symbol name . [out] ppAddr - The address of the symbol value (pointer to pointer). [out] pType - The type of the symbol [out] pState - The current state identifier. Returns: TRUE if there was a symbol in the table; otherwise[...]

  • Page 52

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 52 Copyright 2004-20 05 © Embedded Ar tists AB B.4 File System API B.4.1 fatOpen tFatResult fatOpen( const tU8* pPath, const tU8* pMode, tFatHandle* pHandle ) This function attempts to open the file with the specified absolute path. If successful, the pHandle will hold the handle to the o[...]

  • Page 53

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 53 Copyright 2004-20 05 © Embedded Ar tists AB B.4.3 fatIsDir tFatResult fatIsDir( const tFatHandle handle, tBool* pIsDir ) Tests if the specified handle represents a file or folder. Parameters: [in] handle – A handle to the file. [out] pIsDir – TRUE if the entry is a directory, other[...]

  • Page 54

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 54 Copyright 2004-20 05 © Embedded Ar tists AB This function attempts to write size bytes to the file pointed to by the handle. The offset to where the bytes will be written is specifie d in the handle and the offset will be updated with the number of bytes that are written. Parameters: [[...]

  • Page 55

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 55 Copyright 2004-20 05 © Embedded Ar tists AB FAT_ERROR_A_FOLDER – The path points to a folder and not a file FAT_ERROR_FS_NOT_INITIALIZED – The file system has not been initialized FAT_ERROR_READ_ONLY – The file system is read-only B.4.8 fatReadDirEntry tFatResult fatReadDirEntry([...]

  • Page 56

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 56 Copyright 2004-20 05 © Embedded Ar tists AB Possible error situations (what can be identified in an error code): FAT_OK - The function completed successfully. FAT_ERROR_A_FOLDER – The entry did not point to a file. B.4.11 fatGetEntryName tFatResult fatGetEntryName( tFatDirEntry* pFat[...]

  • Page 57

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 57 Copyright 2004-20 05 © Embedded Ar tists AB Possible error situations (what can be identified in an error code): FAT_OK - The function completed successfully. FAT_ERROR_NOT_EXISTS - There is no folder matching the pPath FAT_ERROR_A_FILE - There is a file matching the pPath FAT_ERROR_FS[...]

  • Page 58

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 58 Copyright 2004-20 05 © Embedded Ar tists AB B.5 PPP API B.5.1 Link Layer (with script engine) The link layer is used between PPP and the harware device driver (e.g. a UART). This layer includes a script engine that can be used to c ontrol the link. Command strings (ini t, start and clo[...]

  • Page 59

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 59 Copyright 2004-20 05 © Embedded Ar tists AB void linkSetStart( tPppDev* pDev, tU8* pStartStr ) Assign the start command string to the device. This command string will be executed when the 'linkStart' function is called. The 'linkStart' function will be called from L[...]

  • Page 60

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 60 Copyright 2004-20 05 © Embedded Ar tists AB tBool linkClose( tPppDev* pDev ) Execute the close command string. If the cl ose command string contains timeouts (@w or @r) this function will return before the command string has been completely processed. This function will be called by LC[...]

  • Page 61

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 61 Copyright 2004-20 05 © Embedded Ar tists AB B.5.11 pppReqAuth void pppReqAuth( tPppDev* pDev, tBool on ) Enable/disable request authentication. It is disabled by default. A request for authentication is normally done by a server. A client must send a valid user ID and password in order[...]

  • Page 62

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 62 Copyright 2004-20 05 © Embedded Ar tists AB B.6 UART API B.6.1 uartPppBlock void uartPppBlock( void ) This function will block PPP from accessi ng the UART connected to the Bluetooth module. Before PPP is blocked pppClose will be called. The default behaviour is to have PPP monito ring[...]

  • Page 63

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 63 Copyright 2004-20 05 © Embedded Ar tists AB B.7 Registry API B.7.1 regErase void regErase( void ) Erase the entire registry. B.7.2 regSetValue tRegResult regSetValue( tU8* pKey, tU8 keyLen, tU8* pValue, tU16 valueLen ) Set a value in the registry. This function is used when a new value[...]

  • Page 64

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 64 Copyright 2004-20 05 © Embedded Ar tists AB REG_RESULT_VAL_TRUNC – There was not enough space in the output buffer for the complete value. It has been truncated. B.7.4 regRemove tRegResult regRemove( tU8* pKey, tU8 keyLen ) Remove a symbol from the registry. Both key and value will b[...]

  • Page 65

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 65 Copyright 2004-20 05 © Embedded Ar tists AB B.8 I 2 C API B.8.1 i2cCheckStatus tS8 i2cCheckStatus( void ) Checks the I2C status. Returns: 00h Bus error 08h START condition transmitted 10h Repeated START condition transmitted 18h SLA + W transmitted, ACK received 20h SLA + W transmitted[...]

  • Page 66

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 66 Copyright 2004-20 05 © Embedded Ar tists AB tS8 i2cRepeatStart( void ) Generates a start condition on I2C when bus is free. Master mode will also automatically be entered. Note: After a stop condition, you may need a bus free time before you can generate a new start condition. Returns:[...]

  • Page 67

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 67 Copyright 2004-20 05 © Embedded Ar tists AB I2C_CODE_OK – The function completed successfully I2C_CODE_ERROR – an error occurred B.8.7 i2cWaitTransmit tS8 i2cWaitTransmit( void ) Wait until data has been transmitted. Parameters: [in] addr – the address to write to [in] pData – [...]

  • Page 68

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 68 Copyright 2004-20 05 © Embedded Ar tists AB B.9 EEPROM API B.9.1 eepromPageRead tS8 eepromPageRead( tU16 addr, tU8* pBuf, tU16 len ) Read data from the eeprom. Parameters: [in] addr – the address to read from [in] pBuf – the read data is stored in this buffer [in] len – number of[...]

  • Page 69

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 69 Copyright 2004-20 05 © Embedded Ar tists AB B.10 Time API B.10.1 clockMs tU32 clockMs( void ) Returns number of milliseconds since start-up Returns: Number of milliseconds since start-up.[...]

  • Page 70

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 70 Copyright 2004-20 05 © Embedded Ar tists AB C Getting Started This appendix contains inform ation about how to quickly get up and running with your application development and describes the many sample applications that are included. The Bluetooth QuickStart Kit comes shipped with a de[...]

  • Page 71

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 71 Copyright 2004-20 05 © Embedded Ar tists AB Files • sample_applet/led.c – this file contains code that controls the LED • sample_applet/led.h – header file with prototypes and constants needed to control the LED. • sample_applet/sample.c – this file contains the server code[...]

  • Page 72

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 72 Copyright 2004-20 05 © Embedded Ar tists AB C.2.4 Registry This sample application illustrates how to use th e Registry, that is, persistent storage in the eeprom. The example will start by trying to read a speci fied key from the registry. If the key is found the value associated with[...]

  • Page 73

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 73 Copyright 2004-20 05 © Embedded Ar tists AB The functionality can be tested by using, for example, a Telnet client to connect to the server. 1. In Windows, open a command prompt and type telnet <IP-address> <port> , where <IP-address> could be, e.g ., 192.168.2.230 an[...]

  • Page 74

    Bluetooth QuickStart Kit Version 1.0 - User’s Guid e Page 74 Copyright 2004-20 05 © Embedded Ar tists AB • sample_web/www/post.html – this file calls the formpost.egi . • sample_web/www/registry.shtml – this file interacts with the listreg.egi, addreg.egi and the remreg.egi . • sample_web/www/ssi.shtml – this file illustrates how SSI[...]