爱特生彩信开发机.doc-淘文阁

资源描述

《爱特生彩信开发机.doc》由会员分享，可在线阅读，更多相关《爱特生彩信开发机.doc（22页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。

1、【精品文档】如有侵权，请联系网站删除，仅供学习与交流爱特生彩信开发机.精品文档.爱特生彩信开发机使用手册成都爱特生信息技术有限公司目录一、产品简介41-1开发原理41-2产品特性5二、设备安装72-1设备图72-2安装方法7三、使用设置9四、常用调用指令104-1发送短信104-2发送彩信104-2-1 上传彩信内容文件104-2-2 提交彩信114-3接收短信114-4接收彩信124-4-1接收彩信体124-4-2获取彩信内容文件134-5取短信发送结果134-6取彩信发送结果14五、普通调用指令155-1设置设备运行参数155-2取设备运行状态155-3取短信到达报告165-4取彩信到达报

2、告165-5取设备振铃消息175-6取待发信息条数185-7清除待发短信185-8清除待发彩信195-9修改用户密码195-10查验用户名密码是否正确19六、事件通知设置21七、疑难解答22附录：指令速查23一、产品简介1-1开发原理爱特生彩信开发机类似一台网络主机，具有上网功能，带有 ip地址，内嵌支持asp调用的web服务器。彩信开发机内嵌的web服务器，提供了一系列asp调用语句。应用系统通过调用这些asp语句，来实现与彩信开发机的数据交互与控制。这些asp调用语句包括了以下的5类主要操作：1、应用系统通过asp调用语句向彩信开发机完成发送信息的提交，彩信开发机将自动控制发送这些短信和

3、彩信；2、彩信开发机通过事件通知机制来告诉应用系统有新的消息需要读取。3、彩信开发机可以自动接收来自手机的短信和彩信，应用系统通过asp调用语句来获取这些短信和彩信。4、应用系统通过asp调用语句来查询所提交信息的发送状态，以及一些日志查询操作等。5、应用系统通过asp调用语句来查询设备状态，以及进行设备控制。例如：应用系统需发送短信时调用：http:/192.168.1.216:8800/sendsms.asp? user=abc |password=123 | phone=13980809945 | smscontent= test|smsIndex=1，其中13980809945

4、代表手机号码，test代表短信内容。应用系统需发送彩信时调用：http:/192.168.1.216:8800/sendmms.asp? user=abc |password=123 | phone=13980809945 | mmstitle = testmms| mmsfilename = 1.jpg&1.txt&2.gif|smsIndex=1，其中13980809945代表手机号码，testmms代表彩信标题，1.jpg、1.txt、2.gif代表彩信的内容文件（需提前用asp语句提交到彩信开发机上）。彩信开发机检验用户名、密码、号码等信息无误后，返回状态值1，否则返回负值。应用系统需

5、查询发送结果时，可通过getsendsmsstatus.asp和getsendmmsstatus.asp的调用，分析返回结果来判断提交的消息发送成功与否。注：1、调用的时候，所有指令参数均需按http协议进行URL编码转换；2、除了上传文件指令（postmmsfile.asp）必须用POST方式外，其他的指令，既可以用GET方式，也可以用POST方式；3、调用接口使用的是8800端口，如果要实现外网来提交的话，则在路由器上要作相应的端口映射。1-2产品特性1、支持任何操作系统平台的二次开发爱特生彩信开发机使用的是http协议方式接口，任何操作系统和开发工具只要支持http协议，甚至只要

6、支持socket通信协议，就可以利用本产品来进行彩信短信的开发。2、用户不需要学习短信彩信的相关知识彩信短信的整个打包与收发过程均已经封装在了彩信开发机内部，由彩信开发机自动控制整个收发过程，开发这不必关心信息收发细节，只需要通过http指令传输诸如彩信接收号码、图片文件等即可，有效降低了开发门槛。3、系统稳定可靠，独立运行，受外界干扰因素较少爱特生彩信开发机，关闭了除开发所需指令外的所有网络接口，避免了外部操作和干扰的可能性；爱特生彩信开发机，内部系统从只读存储器上运行，断电重启后自动复原（设置和记录信息等非关键信息在其它存储器上做了保存），没有病毒的威胁和系统被破坏的可能性；爱特生彩信

7、开发机，与应用系统保持独立，应用系统主机断电、关机、病毒破坏等，以及网络路由器断开等，均不影响彩信开发机的信息收发工作；爱特生彩信开发机，具有收发记录、待发信息、待收信息断电保存功能，确保信息不丢失，应用系统可以随时获取这些信息。4、使用简单，开发周期短爱特生彩信开发机的http协议接口，简单易用，灵活性强，在各类开发工具中都可以方便使用，并且我们还提供了多种开发示例。开发机提供的8个初级调用指令即可以满足绝大多数应用系统的开发需要，大多数系统利用这8个初级调用指令，在一天内就可以完成接口开发和测试。5、支持设备数的无限扩充，应用系统规模便于灵活控制本产品支持任意多台彩信开发机连在路由器上

8、同时使用，对电脑硬件没有要求（不需要插串口扩展卡），加扩系统收发规模时，只要路有器上有足够的空闲网口即可。6、支持远程调用开发通过网络的路由设置，应用系统可以实现远程彩信开发机的调用。例如，在托管主机、虚拟主机等也能轻松实现短信彩信的收发需求。7、产品接口调用安全性高对爱特生彩信开发机的各种调用都需要授权，普通接口调用需要用户名和密码；重要设置类的接口调用则需要系统管理员密码；重要基础类设置和系统升级操作，则需要在电脑上插入硬件的操作员密钥。同时，爱特生彩信开发机还可以设置只允许某个ip地址的主机才能调用接口，非设定ip的请求一律拒绝。二、设备安装2-1设备图爱特生彩信开发机正面：爱特生彩

9、信开发机背面：2-2安装方法1、将天线插入天线座，拧紧。2、用小螺丝刀顶一下sim卡座侧的小黄点，sim卡座就会弹出，放入sim卡后插回原位。3、网线一头连接彩信开发机，另外一头连接路由器。4、连接电源线，并开启modem电源开关和总电源开关（上按为开，下按为关）。5、如果你的路由器的子网掩码为255.255.255.0，默认网关为192.168.1.1，且ip地址192.168.1.216没有其他主机在使用，则本彩信开发机已经安装完毕，能够正常进行后面章节的开发使用；否则，请参照3-1的方法进行网络设置。注：在更换sim卡的时候，请关闭电源开关后再操作。三、使用设置可以通过系统管理

10、员软件来对设备进行设置。使用系统管理员软件，必须要具备系统管理员操作密钥（类似u盘一样大小的蓝色硬件）。在windows系统的电脑上，从彩信开发机主页下载系统管理员软件并安装。在电脑上插入操作密钥后，可打开系统管理员软件进行操作。操作完毕后，请拔出操作密钥并妥善保管，没有操作密钥的人员无法启动该软件。系统管理员软件主要具备如下功能：1、设置接口调用的用户名和密码；2、设置彩信开发机ip地址信息；3、限制与彩信开发机进行通信连接的主机IP，如果设置了限制IP，则其他电脑不能和本设备进行通信（系统管理员软件除外）；4、设备内软件升级。注：设备出厂时，预设的ip地址为192.168.1.21

11、6，子网掩码255.255.255.0，默认网关192.168.1.1；预设接口调用的用户名为abc，密码为123；没有限制与彩信开发机的接口调用ip。四、常用调用指令4-1发送短信描述用于提交要发送的短信（可一次提交多条，可以不关心之前提交的是否发送完毕，最大可存储待发短信500条）。指令http:/xxx.xxx.xxx.xxx:8800/sendsms.asp? user= |password= | phone= | smscontent=| smsIndex=| modemindex=说明user 值为用户名；password值为登录口令；phone 值为短信接收号码（多个号码时，号码

12、间&号分割，单次提交号码少于100个）；smscontent 值为短信内容（长度小于160字节）。smsIndex 值为短信自定义编号。Modemindex 值为本短信指定由某手机卡发送，无此参数时，设备自由选择空闲设备发送（此参数尽量省略）。返回value注：value值为1表示提交成功，其余值表示失败（-1号码参数不正确，-2待发短信条数大于500条）。示例http:/192.168.1.216:8800/sendsms.asp? user=abc |password=123 | phone=13980809945 | smscontent= test|smsIndex=1| modemi

13、ndex=14-2发送彩信4-2-1 上传彩信内容文件描述上传发送彩信时要用到的文件（彩信中的文字要预先保存为文本文件）。必须使用post方式传输文件，post数据部分为文件数据（二进制方式）。指令http:/xxx.xxx.xxx.xxx:8800/postmmsfile.asp? user= |password= | mmsfilename=说明user 值为用户名；password值为登录口令；mmsfilename 值为文件名（不包含路径，每次只能上传一个文件）。返回value注：value值为1表示提交成功，其余值表示失败。特别提醒：单个彩信内容文件必须小于100K字节。示例http

15、接收号码（多个号码时，号码间&号分割，单次提交号码少于100个）；mmstitle 值为彩信标题（长度小于160字节）；mmsfilename值为彩信文件名（不含路径，需提前上传，多个文件时文件间&号分割）；mmsIndex 值为彩信自定义编号；Modemindex 值为本彩信指定由某手机卡发送，无此参数时，设备自由选择空闲设备发送（此参数尽量省略）。返回value注：value值为1表示提交成功，其余值表示失败（-1号码参数不正确，-2待发彩信条数大于500条）。示例http:/192.168.1.216:8800/sendmms.asp? user=abc |password=123 |

16、phone=13980809945 | mmstitle = testmms| mmsfilename = 1.jpg&1.txt&2.gif|smsIndex=1| modemindex=14-3接收短信描述接收设备收到的短信（接收调用过后，设备会自动将其删除）。指令http:/xxx.xxx.xxx.xxx:8800/getrecvsms.asp? user= |password= 说明user 值为用户名；password值为登录口令。返回13980809945my testsms2008-03-20 11:30:102008-03-20 11:30:15注：count值为记录个数；Ph

17、oneNumber 值为发送手机号码SMSContent值为短信内容SendTime 值为短信发送时间RecvTime 值为收到短信时间示例http:/192.168.1.216:8800/ getrecvsms.asp? user=abc |password=1234-4接收彩信4-4-1接收彩信体描述接收设备收到的彩信（接收调用过后，设备会自动将其删除）。指令http:/xxx.xxx.xxx.xxx:8800/getrecvmms.asp? user= |password= 说明user 值为用户名；password值为登录口令。返回13980809945my testsmst1.gif

18、|mm.mid|1.txt322008-03-20 11:30:15注：count值为记录个数；PhoneNumber 值为发送手机号码；MMSTitle 值为彩信标题；MMSFileName 值为彩信的内容文件（一个或多个，由|号分割）；RecvMMSID 值为彩信接收编号；RecvTime 值为收到彩信时间。示例http:/192.168.1.216:8800/ getrecvmms.asp? user=abc |password=1234-4-2获取彩信内容文件描述接收彩信中的内容文件。指令http:/xxx.xxx.xxx.xxx:8800/getmmsfile.asp? user=

19、|password= |recvmmsid= | Resfilename=说明user 值为用户名；password值为登录口令;recvmmsid 值为彩信接收编号；Resfilename 值为彩信内容文件名。返回文件的二进制数据。示例http:/192.168.1.216:8800/ getmmsfile.asp? user=abc |password=123|recvmmsid=32 | Resfilename= t1.gif4-5取短信发送结果描述用于获取提交短信的已发送结果（待发中的不返回）。指令http:/xxx.xxx.xxx.xxx:8800/getsendsmsstatus.

20、asp? user= |password=说明user 值为用户名；password值为登录口令。返回6612008-03-20 13:22:45注：count值为记录个数；SMSIndex 值为短信自定义号（提交时设置的）；Status 值为发送结果，1为成功，其余为失败。示例http:/192.168.1.216:8800/ getsendsmsstatus.asp? user=abc |password=123 4-6取彩信发送结果描述用于获取提交彩信的已发送结果（待发中的不返回）。指令http:/xxx.xxx.xxx.xxx:8800/getsendmmsstatus.asp? us

21、er= |password=说明user 值为用户名；password值为登录口令。返回66154A89EA12008-03-20 13:22:45注：count值为记录个数；SMSIndex 值为彩信自定义号（提交时设置的）；MSCID值为彩信中心服务器为此条彩信产生的唯一识别标号；Status 值为发送结果，1为成功，其余为失败。示例http:/192.168.1.216:8800/ getsendmmsstatus.asp? user=abc |password=123 五、普通调用指令5-1设置设备运行参数描述设置modem设备的运行参数（可以只带想设置的参数，不想设置的可省略）。指令

22、http:/xxx.xxx.xxx.xxx:8800/setmodemparam.asp? user= | password=| modemindex=| SendSmsRate=|sorp=|usetype=|clearSendinfo=说明user 值为用户名；password值为登录口令。Modemindex值为要设置的modem号（省略此参数时，默认设置1）。SendSmsRate值为设置短信发送速度。Sorp值为设置设备启动发送（0）或暂停发送（1）。Usetype值为使用类型（只发彩信、只收信息、不收彩信、全功能）。clearSendinfo值为清除设备发送条数信息。返回value

24、要设置的modem号（省略此参数时，默认设置modem1）。返回07135011522110注：SorP值为0表示设置的状态控制（0为正常状态，1为暂停状态）。UseType值为设置的设备使用类型。ConnectStatus值为设备的连接状态（1为已连接设备，其他为未连接）。SendSmsRate值为设置的短信发送限速。SendCoun值为累计发送成功条数。WaitRecvMMSCount值为待收彩信条数。SmsFStauts值为短信功能是否正常（1正常，0未知，-1不正常）。MmsFStatus值为彩信功能是否正常（1正常，0未知，-1不正常）。ConErrorCount值为连续发送失败条数

25、。示例http:/192.168.1.216:8800/getmodemstatus.asp?user=abc|password=123|modemindex=15-3取短信到达报告描述用于获取提交发送短信的对方接收报告（如果对方接收了我们发送的短信，会有报告产生）。指令http:/xxx.xxx.xxx.xxx:8800/getsendsmsreport.asp? user= |password=说明user 值为用户名；password值为登录口令。返回139808099452008-03-20 13:22:45注：count值为记录个数；PhoneNumber值为接收了短信的手机号码；R

26、ecvTime值为对方接收时间。示例http:/192.168.1.216:8800/getsendsmsreport.asp? user=abc |password=123 5-4取彩信到达报告描述用于获取提交发送彩信的对方接收报告（如果对方接收了我们发送的彩信，会有报告产生）。指令http:/xxx.xxx.xxx.xxx:8800/getsendmmsreport.asp? user= |password=说明user 值为用户名；password值为登录口令。返回54A89EA112008-03-20 13:22:45注：count值为记录个数；MSCID值为彩信发送时彩信中心服务器返

27、回的编号（以此可查询到是哪条彩信）；Status值为状态值（1为已接收，其余值为失败）；RecvTime值为接收到报告的时间。示例http:/192.168.1.216:8800/getsendmmsreport.asp? user=abc |password=123 5-5取设备振铃消息描述如果有人往设备中的手机卡上打过电话，则有振铃信息产生，本指令用于取振铃信息。指令http:/xxx.xxx.xxx.xxx:8800/getring.asp? user= |password=说明user 值为用户名；password值为登录口令。返回159888899992008-03-21 14:28

28、:45注：count值为记录个数；PhoneNumber值为彩信发送时彩信中心服务器返回的编号（以此可查询到是哪条彩信）；RecvTime值为接收到振铃的时间。示例http:/192.168.1.216:8800/ getring.asp? user=abc |password=123 5-6取待发信息条数描述获得全部或某个设备上提交后还未发送完成的短信和彩信数目。指令http:/xxx.xxx.xxx.xxx:8800/getwaitsendmsgcount.asp? user=| password= |modemindex=说明user 值为用户名；password值为登录口令；modem

29、index值为modem设备序号（忽略此参数时取全部设备）。返回31注：SmsCount值为待发短信条数；MmsCount值为待发彩信条数。示例http:/192.168.1.216:8800/getwaitsendmsgcount.asp?user=abc|password=123 5-7清除待发短信描述清除全部或某个设备上提交后还未发送完成的短信。指令http:/xxx.xxx.xxx.xxx:8800/removewaitsendsms.asp? user=| password= |modemindex=说明user 值为用户名；password值为登录口令；modemindex值为mo

30、dem设备序号（忽略此参数时取全部设备）。返回value注：value值为1表示成功，其余值表示失败。示例http:/192.168.1.216:8800/ removewaitsendsms.asp?user=abc|password=123 5-8清除待发彩信描述清除全部或某个设备上提交后还未发送完成的彩信。指令http:/xxx.xxx.xxx.xxx:8800/removewaitsendmms.asp? user=| password= |modemindex=说明user 值为用户名；password值为登录口令；modemindex值为modem设备序号（忽略此参数时取全部设备）

31、。返回value注：value值为1表示成功，其余值表示失败。示例http:/192.168.1.216:8800/ removewaitsendmms.asp?user=abc|password=123 5-9修改用户密码描述修改用户登陆密码。指令http:/xxx.xxx.xxx.xxx:8800/changepassword.asp?user=| password= |newkey=说明user 值为用户名；password值为登录口令；newkey值为新设口令。返回value注：value值为1表示设置成功，其余值表示失败。示例http:/192.168.1.216:8800/chan

32、gepassword.asp?user=abc|password=123| newkey=8885-10查验用户名密码是否正确描述检查一下用户名和密码是否正确（一般用于系统启动时，在调用各种指令前先校验一次，以免因用户名和密码错误而产生不必要的问题）。指令http:/xxx.xxx.xxx.xxx:8800/checkuserinfo.asp? user= |password=说明user 值为用户名；password值为登录口令。返回value注：value值为1表示用户名和密码正确，其余值表示错误。示例http:/192.168.1.216:8800/ checkuserinfo.asp?

33、 user=abc |password=123 六、事件通知设置应用系统获取接收彩信短信、发送信息状态、信息接收报告等，可以采用前面的指令进行论询（如每隔10秒钟轮询一次）。但是如果轮询间隔过长，实时性不高；如果轮询间隔过短，对应用系统和开发记的性能有影响，浪费计算机处理器资源。为了解决这个问题，爱特生彩信开发机提供了事件通知机制，当彩信开发机收到彩信短信、有新的发送信息状态或接收报告时，主动调用一个用户设定的URL连接，应用系统接收到这个调用消息后再到彩信开发机取消息。事件通知机制的URL设置在彩信开发机系统管理员软件中完成，共有7种事件URL可供用户设置。用户可以全部设置，也可以只设置自己

34、感兴趣的事件。这7种事件分别是：接收到新的短信、接收到新的彩信、有新短信发送状态、有新彩信发送状态、有新短信接收报告、有新彩信接收报告、有新的振铃消息。下面是在系统管理员软件中的事件通知设置界面（示例中应用系统主机为192.168.1.24，监听端口为8808）：七、疑难解答附录：指令速查指令描述章节sendsms.asp发送短信4-1postmmsfile.asp上传彩信内容文件4-2-1sendmms.asp提交彩信4-2-2getrecvsms.asp接收短信4-3getrecvmms.asp接收彩信体4-4-1getmmsfile.asp获取彩信内容文件4-4-2getsendsmss

35、tatus.asp取短信发送结果4-5getsendmmsstatus.asp取彩信发送结果4-6setmodemparam.asp设置设备运行参数5-1getmodemstatus.asp取设备运行状态5-2getsendsmsreport.asp取短信到达报告5-3getsendmmsreport.asp取彩信到达报告5-4getring.asp取设备振铃消息5-5getwaitsendmsgcount.asp取待发信息条数5-6removewaitsendsms.asp清除待发短信5-7removewaitsendmms.asp清除待发彩信5-8changepassword.asp修改用户密码5-9checkuserinfo.asp查验用户名密码是否正确5-10

展开阅读全文