User Tools

Site Tools


products:wiz550web:wiz550web_tutorial_kr

WIZ550web Tutorials

Overview

WIZ550web의 I/O 제어는 CGI를 이용하여 I/O의 제어와 모니터링을 수행한다. 웹 페이지는 HTTP GET / POST method를 활용하여 웹 서버의 상태 값을 얻거나(GET) 웹 페이지의 변경된 값을 웹 서버로 전달(POST)하도록 구성되어 있으며, 이러한 동작을 수행하기 위하여 웹 페이지의 HTML / JavaScript(AJAX)와 웹 서버의 CGI handler가 일치하도록 구현되어 있어야 한다. CGI에 관한 설명은 'Getting Started Guide: WIZ550web의 CGI'에 설명되어 있다.

사용자는 Tutorial을 통해 WIZ550web에 구현된 I/O interface function의 이해와 활용이 가능하다. 이를 통해 사용자는 원격지에서 웹 서버로 접속하고, 사용자 device의 상태를 모니터링 하거나 I/O의 on/off 기능을 수행하는 사용자만의 WIZ550web용 웹 페이지를 제작할 수 있다.

Tutorials

본 Tutorial 에서는 다음과 같은 내용을 다룬다.

    • Web browser와 WIZ550web의 기본적인 동작에 대해 소개하고, 사용자가 웹 페이지만 수정하여 원하는 형태의 I/O 제어용 웹 사이트를 구성 할 수 있도록 미리 정의된 I/O interface function과 테스트 페이지를 소개한다.
    • WIZ550web에서 제공하는 Digital I/O (16)의 On - Off 상태를 제어 할 수 있는 Web page 제작에 대해 다룬다. 이를 통해 사용자는 웹을 통해 제품의 LED / Relay 등을 제어 할 수 있다. 이 Tutorial을 통해 학습한 기능을 응용하면 Digital I/O의 Direction (Input / Output / None) 제어 기능도 제작 할 수 있다.

미리 정의된 I/O Function에 대한 명세는 다음 가이드에서 확인 할 수 있다.



2017/05/12 11:16 · hkjung

Interface Functions Guide for WIZ550web

Overview


WIZ550web은 펌웨어의 수정 없이 웹 페이지의 제작만으로 장치 이름 및 Network 설정, 각각의 Digital I/O와 Analog input의 제어와 모니터링을 수행할 수 있도록 CGI를 위한 HTTP Request function set을 제공한다.

GET / SET interface로 나뉘어 구현되어 있으며, 사용자는 JavaScript와 AJAX를 이용한 HTTP GET / POST method로 각 기능에 해당하는 CGI를 요청하는 방법을 활용하면 손쉽게 WIZ550web을 제어할 수 있는 웹 페이지를 구현 및 제작 할 수 있다. GET 명령의 경우 해당하는 요청에 대한 JavaScript Callback function의 형태로 값을 얻도록 구성 되었으며, SET 명령의 경우 CGI 요청과 함께 설정하고자 하는 값을 지정된 Web form element의 형태로 HTTP request에 포함하여 WIZ550web으로 전송하면 된다.

WIZ550web의 CGI에 관한 내용은 'Getting Started Guide: WIZ550web의 CGI' 챕터를 참조하기 바란다.


Get/Set interface CGI를 이용한 테스트 용 웹 페이지 및 펌웨어는 다음 링크에서 다운로드 할 수 있다.

WIZ550web GitHub Repository

https://github.com/Wiznet/WIZ550web

WIZ550web GitHub Repository: Webpage source code

GET/SET Interface functions Testpage

WIZ550web GET/SET Interface


WIZ550web의 GET/SET interface를 위한 CGI 리스트는 아래와 같다.

GET Function List

Get: Functions Table

HTTP Request
CGI name
Description
widget.cgi Get Basic Settings
io.cgi Get I/O all status, include pin 90,91 on-board LED
io_alias.cgi Get all I/O status. direction and port names
adc.cgi Get all ADC Status/values
get_devinfo.cgi Get Device info
get_netinfo.cgi Get Network info
get_serial_data.cgi Get serial data from buffer (Console port)
get_uart0info.cgi Get Serial port 0 settings (UART1, Console)
get_uart1info.cgi Get Serial port 1 settings (UART2, AT command)
get_dio0.cgi
~
get_dio15.cgi
Get I/O status per port
get_ain0.cgi
~
get_ain3.cgi
Get ADC info per port
Section CGI name JavaScript
Callback Parameter
Return Type Description Value (Example) Note
Device Information get_devinfo.cgi fwver String Firmware version 1.0.0 -
devname String Device name WIZ550web -
pcode String Product identifier 1-2-0 For WIZ configuration tool
mac String MAC address 00:08:DC:xx:xx:xx -
Network Information get_netinfo.cgi ip String IP address 192.168.11.2 -
gw String Gateway IP address 192.168.11.1 -
sub String Subnet Mask 255.255.255.0 -
dns String DNS server IP address 8.8.8.8 -
dhcp 1-digit number DHCP enable 0 or 1 1 : Enabled
0 : Disabled
Serial Port Information get_uart0info.cgi
get_uart1info.cgi
baud 1-digit number Baud rate 0 ~ 9 0:600
1:1200
2:2400
3:4800
4:9600
5:19200
6:38400
7:57600
8:115200
9:230400
databit 1-digit number Data bit 0 or 1 0:Databit8
1:Databit9
parity 1-digit number Parity bit 0 ~ 2 0:None
1:Odd
2:Even
stopbit 1-digit number Stopbit 0 or 1 0:Stopbit1
1:Stopbit2
flow 1-digit number Flow control 0 ~ 3 0:None
1:RTS/CTS
2:RS-422
3:RS-485
16-Digital I/O
(0 ~ 15)
get_dio0.cgi
~
get_dio15.cgi
dio_p 1 or 2-digit numbers I/O Pin Info. 0 -
dio_s 1-digit number I/O State 0 or 1 0 : Low
1 : High
dio_d 1-digit number I/O Direction 0/1/2 0 : NotUsed
1 : Input
2 : Output
dio_a String I/O Alias Digital I/O #0 -
4-Analog Inputs
(12-bit ADC)
get_ain0.cgi
~
get_ain3.cgi
ain_p 1-digit number Analog input pin 0 ~ 3 -
ain_v 1 ~ 4-digit numbers Analog input value 0 ~ 4095 The values need to transform for use.

Get: JavaScript Callback Function Name Table

HTTP Request
CGI name
JavaScript Function Name
on Web page
get_devinfo.cgi function DevinfoCallback(o)
get_netinfo.cgi function NetinfoCallback(o)
get_uart0info.cgi function UartinfoCallback(o)
get_uart1info.cgi
get_dio0.cgi
~
get_dio15.cgi
function DioCallback(o)
get_ain0.cgi
~
get_ain3.cgi
function AinCallback(o)

SET Function List

Set: Functions Table

HTTP Request
CGI name
Description
config.cgi Set Basic Settings for DemoPages
dout.cgi Set I/O port On/Off
save_alias.cgi Change name of I/O port
dir_change.cgi Change I/O direction
tx_serial_data.cgi Send serial data to UART1(Console port)
set_default_io_status.cgi IO Settings Factory Reset and Reboot
set_devinfo.cgi Set Device info (changes takes effect after reboot)
set_netinfo.cgi Set Network info (changes takes effect after reboot)
set_uart0info.cgi Set Serial port 0 settings (UART1, Console) (changes takes effect after reboot)
set_uart1info.cgi Set Serial port 1 settings (UART2, AT command) (changes takes effect after reboot)
set_diodir.cgi Change I/O direction. same as dir_change.cgi
set_diostate.cgi Set I/O port On/Off. almost the same as dout.cgi
set_dioalias.cgi Change name of I/O port. same as save_alias.cgi

config.cgi is for DemoPages.

Other common APIs are from set_devinfo.cgi

Section CGI name Parameter Webform Element Description Parameter Example Note
Device
Configuration
config.cgi devicename Param: String Device name devicename=WIZ550WEB -
dhcp Param: 0 or 1 DHCP enable dhcp=0 1 : Enabled
0 : Disabled
lib Param: Sting Local IP address lip=192.168.11.100 Including dots
gw Param: String Gateway IP address gw=192.168.11.254
sub Param: String Subnet Mask sub=255.255.255.192
dns Param: String DNS server IP address dns=168.126.63.1
baudrate Param: 1-digit number Baud rate baud=8 0:600
1:1200
2:2400
3:4800
4:9600
5:19200
6:38400
7:57600
8:115200
9:230400
databit Param: 8~9 Data bit databit=8 8:Databit8
9:Databit9
parity Param: 0~2 Parity bit parity=0 0:None
1:Odd
2:Even
stopbit Param: 1~2 Stopbit stopbit=1 1:Stopbit1
2:Stopbit2
flowcontrol Param: 0~3 Flow control flowcontrol=0 0:None
1:RTS/CTS
2:RS-422
3:RS-485
Device Information set_devinfo.cgi devname Param: String Device name devname=Server1 -
Network Information set_netinfo.cgi ip Param: String IP address ip= 192.168.11.3 Including dots
gw Param: String Gateway IP address gw= 192.168.11.254
sub Param: String Subnet Mask sub= 255.255.255.192
dns Param: String DNS server IP address dns= 168.126.63.1
dhcp Param: 0 or 1 DHCP enable dhcp=0 1 : Enabled
0 : Disabled
Serial Port Information set_uart0info.cgi
set_uart1info.cgi
baud Param: 1-digit number Baud rate baud=8 0:600
1:1200
2:2400
3:4800
4:9600
5:19200
6:38400
7:57600
8:115200
9:230400
databit Param: 8~9 Data bit databit=8 8:Databit8
9:Databit9
parity Param: 0~2 Parity bit parity=0 0:None
1:Odd
2:Even
stopbit Param: 1~2 Stopbit stopbit=1 1:Stopbit1
2:Stopbit2
flow Param: 0~3 Flow control flow=0 0:None
1:RTS/CTS
2:RS-422
3:RS-485
16-Digital I/O
(0 ~ 15)
set_diostate.cgi pin / val Params: digit numbers I/O State pin=0&val=1 pin:0~15
val=0(Low/On)
val=1(High/Off)
set_diodir.cgi pin / val I/O Direction pin=1&val=2 pin:0~15
val=0(Not used)
val=1(Input)
val=2(Output)
set_dioalias.cgi pin / val Params: digit numbers / String I/O Alias pin=1&val=pin#1 pin:0~15
value:string
2014/11/26 18:14 · hkjung
products/wiz550web/wiz550web_tutorial_kr.txt · Last modified: 2017/05/12 11:17 by hkjung