This shows you the differences between two versions of the page.
hardware:cflink:lanbridge-cflink-protocol [2013/12/05 12:16] jarrod [GTW - Default Gateway] |
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 345: | Line 386: | ||
</sxh> | </sxh> | ||
- | ==== DNS - Domain Name Server ==== | + | ==== DNS - Domain Name System Server ==== |
- | The ''DNS'' (Domain Name Server) command will configure the DNS used by the LAN Bridge if DHCP is disabled. It will be ignored if DHCP is enabled.\\ | + | The ''DNS'' (Domain Name System) command will configure the DNS Server used by the LAN Bridge if DHCP is disabled. It will be ignored if DHCP is enabled.\\ |
The change will not take effect until the LAN Bridge is rebooted. | The change will not take effect until the LAN Bridge is rebooted. | ||
Line 355: | Line 396: | ||
</sxh> | </sxh> | ||
- | * **<DNS>** = The IPv4 DNS Address to assign to the LAN Bridge | + | * **<DNS>** = The IPv4 DNS Server Address to assign to the LAN Bridge |
=== Reply === | === Reply === | ||
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 ==== |