This shows you the differences between two versions of the page.
|
hardware:cflink:lanbridge-cflink-protocol [2013/12/05 12:18] jarrod [DNS - Domain Name Server] |
hardware:cflink:lanbridge-cflink-protocol [2021/05/17 00:00] (current) jarrod |
||
|---|---|---|---|
| Line 13: | Line 13: | ||
| * ''4'' - ''10'' = Reserved for future use | * ''4'' - ''10'' = Reserved for future use | ||
| * ''11'' - ''20'' = Configurable as TCP or UDP communication | * ''11'' - ''20'' = Configurable as TCP or UDP communication | ||
| + | |||
| + | ===== Authentication ===== | ||
| + | |||
| + | By default, authentication on LAN Bridge is disabled. To enable it, use the [[#pwd-login-password|Configure Password command]]. | ||
| + | |||
| + | When authentication is enabled, the LAN Bridge will send a ''RLANATH'' command when first connecting. When this command has been sent, no other commands will be accepted until the correct username and password has been received. | ||
| + | |||
| + | If an incorrect login message is received, the LAN Bridge will respond with [[hardware:cflink:error-codes#lan-bridge-solo-error-codes|''RLANERR'' message, with error code 134]]. | ||
| + | |||
| + | Once successfully logged in, the LAN Bridge will reply with ''RLANWHO'' response to acknowledge that login is correct and the device will now respond to other commands. | ||
| + | |||
| ===== Queries ===== | ===== Queries ===== | ||
| Line 264: | Line 275: | ||
| ===== Configuration Messages ===== | ===== Configuration Messages ===== | ||
| + | |||
| + | ==== PWD - Login Password ==== | ||
| + | |||
| + | The ''PWD'' command configures a password that must be sent before any additional commands will be accepted. By default the password is disabled.\\ | ||
| + | To clear the login, you must first have issued the correct login/password, then send this command without any username or password data. | ||
| + | |||
| + | === Data === | ||
| + | <sxh cflink; light: true> | ||
| + | > [F2]<ID>[F3]CLANPWD[F4]<USER>:<PASSWORD>[F5][F5] | ||
| + | </sxh> | ||
| + | * **<USER>** = The login username to set | ||
| + | * **<PASSWORD>** = The login password to set | ||
| + | |||
| + | === Reply === | ||
| + | <sxh cflink; light: true> | ||
| + | // The reply is just an echo of the command in reply format, without the password . | ||
| + | < [F2]<ID>[F3]RLANPWD[F4]<USER>[F5][F5] | ||
| + | </sxh> | ||
| + | |||
| + | === Example === | ||
| + | <sxh cflink; light: true> | ||
| + | // Configure username as 'admin' and password as 'mysecretpass' of LAN Bridge on CFLink ID [02] | ||
| + | > [F2][02][F3]CLANPWD[F4]admin:mysecretpass[F5][F5] | ||
| + | // Reply | ||
| + | < [F2][02][F3]RLANPWD[F4]admin[F5][F5] | ||
| + | // Remove the login completely from LAN Bridge on CFLink ID [02] | ||
| + | > [F2][02][F3]CLANPWD[F4][F5][F5] | ||
| + | // Reply | ||
| + | < [F2][02][F3]RLANPWD[F4][F5][F5] | ||
| + | </sxh> | ||
| ==== IP4 - IPv4 Address ==== | ==== IP4 - IPv4 Address ==== | ||
| Line 685: | Line 726: | ||
| ===== Transmission Messages ===== | ===== Transmission Messages ===== | ||
| + | |||
| + | ==== PWD - Authenticate Password ==== | ||
| + | |||
| + | The ''PWD'' (Password) command allows you to login to a LAN Bridge that has a login configured.\\ | ||
| + | No other commands will be accepted until the correct login details are entered if a login has been configured.\\ | ||
| + | |||
| + | === Data === | ||
| + | <sxh cflink; light: true> | ||
| + | > [F2]<ID>[F3]TLANPWD[F4]<USER>:<PASSWORD>[F5][F5] | ||
| + | </sxh> | ||
| + | |||
| + | * **<USER>** = The username to login with | ||
| + | * **<PASSWORD>** = The password to login with | ||
| + | |||
| + | === Reply === | ||
| + | <sxh cflink; light: true> | ||
| + | < [F2]<ID>[F3]RLANPWD[F4]<USER>[F5][F5] | ||
| + | </sxh> | ||
| + | |||
| + | === Example === | ||
| + | <sxh cflink; light: true> | ||
| + | // Login to LAN Bridge on CFLink ID [02] with username 'admin' and password 'mysecretpass' | ||
| + | > [F2][02][F3]TLANPWD[F4]admin:mysecretpass[F5][F5] | ||
| + | // Reply | ||
| + | < [F2][02][F3]RLANPWD[F4]admin[F5][F5] | ||
| + | </sxh> | ||
| ==== SND - Send Data ==== | ==== SND - Send Data ==== | ||