Difference between revisions of "Card Reader"

From IVS Wiki
Jump to: navigation, search
(Wiring and Diagram)
(Wiring and Diagram)
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
=Wiring and Diagram=
 
=Wiring and Diagram=
[[File:VALT Card Reader.png|900px|link=https://ipivs.com/wiki/images/e/e4/VALT_Card_Reader.png|Click to Expand]]
+
<div class="section">
 +
{{img | file = VALT Card Reader.png | width=800px}}
  
 
Using 22/8 cable and a 2x20 pin connector, crimp the wires and connect as shown below  
 
Using 22/8 cable and a 2x20 pin connector, crimp the wires and connect as shown below  
Line 23: Line 24:
 
|Pin 18
 
|Pin 18
 
|}
 
|}
[[File:cardreader6.png|100px]] [[File:CardReCable.jpg|400px|https://ipivs.com/wiki/images/3/39/CardReCable.jpg]]
+
{{img | file = cardreader6.png | width=80px}} {{img | file = CardReCable.jpg | width=400px}}
 +
</div>
  
 
=Finding the IP Address=
 
=Finding the IP Address=
 +
<div class="section">
 
Since the card reader is headless, there is no way to display the IP address. There are two options for discovering the IP address for the device.
 
Since the card reader is headless, there is no way to display the IP address. There are two options for discovering the IP address for the device.
 
* Check the DHCP server logs to see what IP address was assigned to the device. The default name is cardreader.
 
* Check the DHCP server logs to see what IP address was assigned to the device. The default name is cardreader.
Line 34: Line 37:
 
*# Type the following command and press enter. <pre>ifconfig</pre>
 
*# Type the following command and press enter. <pre>ifconfig</pre>
 
*# The ip address for eth0 should be displayed on the screen.
 
*# The ip address for eth0 should be displayed on the screen.
 +
</div>
  
 
==Manually Set an IP Address==
 
==Manually Set an IP Address==
 
+
<div class="section">
 
If ip address cannot be obtained from DHCP and cannot access the web interface, the ip address maybe manually configured on the device.
 
If ip address cannot be obtained from DHCP and cannot access the web interface, the ip address maybe manually configured on the device.
 
From the console:
 
From the console:
Line 48: Line 52:
 
static ip_address=192.168.1.45/24
 
static ip_address=192.168.1.45/24
 
static routers=192.168.1.1</nowiki>
 
static routers=192.168.1.1</nowiki>
[[File:cardreader2.png]]
+
{{img | file = cardreader2.png}}
 
<ol start=4>
 
<ol start=4>
 
<li> Change the ip address, subnet mask, and gateway to the appropriate values.
 
<li> Change the ip address, subnet mask, and gateway to the appropriate values.
Line 60: Line 64:
 
</ol>
 
</ol>
 
:: '''Note:''' ''Changing the IP address in this way completely bypasses the web interface. If the web interface is accessed later on, the configuration will not be reflected there and changes made to the network configuration in the web interface will overwrite this configuration.''
 
:: '''Note:''' ''Changing the IP address in this way completely bypasses the web interface. If the web interface is accessed later on, the configuration will not be reflected there and changes made to the network configuration in the web interface will overwrite this configuration.''
 +
</div>
  
 
=Configuring the Card Reader=
 
=Configuring the Card Reader=
 
==Web Interface==
 
==Web Interface==
 +
<div class="section">
 
Once know the IP address for the card reader microcomputer is known, the web interface can be accessed by typing https://''ipaddress'' in any web browser. Make sure to replace ''ipaddress'' with the actual ip address for the card reader microcomputer.
 
Once know the IP address for the card reader microcomputer is known, the web interface can be accessed by typing https://''ipaddress'' in any web browser. Make sure to replace ''ipaddress'' with the actual ip address for the card reader microcomputer.
  
::[[File:cardreader4.png]]
+
::{{img | file = cardreader4.png | width=800px}}
 
When prompted enter the username and password for the card reader.
 
When prompted enter the username and password for the card reader.
 
: '''Defaults'''
 
: '''Defaults'''
Line 71: Line 77:
 
: Password: admin51
 
: Password: admin51
 
The configuration page will now be displayed.
 
The configuration page will now be displayed.
:: [[File:cardreader5.png]]
+
:: {{img | file = cardreader5.png | width=800px}}
 +
</div>
 +
 
 
===VALT Configuration===
 
===VALT Configuration===
 +
<div class="section">
 
{| class="wikitable"
 
{| class="wikitable"
 
! Setting
 
! Setting
Line 92: Line 101:
 
|Displays whether or not the card reader is able to connect to the VALT server using the URL and credentials specified. This will also display an error if the room number does not exist.
 
|Displays whether or not the card reader is able to connect to the VALT server using the URL and credentials specified. This will also display an error if the room number does not exist.
 
|}
 
|}
 +
</div>
  
 
===Card Configuration===
 
===Card Configuration===
 +
<div class="section">
 
{| class="wikitable"
 
{| class="wikitable"
 
!Setting
 
!Setting
Line 104: Line 115:
 
|The position in the RFID card number where the actual card number ends.
 
|The position in the RFID card number where the actual card number ends.
 
|}
 
|}
 +
</div>
 +
 
===Network Configuration===
 
===Network Configuration===
 +
<div class="section">
 
{| class="wikitable"
 
{| class="wikitable"
 
!Setting
 
!Setting
Line 123: Line 137:
  
 
'''Note:''' ''Network changes made in the web interface will take effect after the next reboot of the card reader.''
 
'''Note:''' ''Network changes made in the web interface will take effect after the next reboot of the card reader.''
 +
</div>
  
 
===Admin Configuration===
 
===Admin Configuration===
{|
+
<div class="section">
 +
{| class="wikitable"
 
!Setting
 
!Setting
 
!Function
 
!Function
Line 144: Line 160:
 
|Saves Valt, Card, and Network configuration. Success or Failure messages will be displayed below each section.
 
|Saves Valt, Card, and Network configuration. Success or Failure messages will be displayed below each section.
 
|}
 
|}
 +
</div>
  
 
==Command Line==
 
==Command Line==
 +
<div class="section">
 
# Connect to the card reader via SSH  
 
# Connect to the card reader via SSH  
 
# Type the following command and press enter. <pre>sudo nano /usr/local/ivs/config/cardreader.cfg</pre>
 
# Type the following command and press enter. <pre>sudo nano /usr/local/ivs/config/cardreader.cfg</pre>
#: [[File:cardreader3.png]]
+
#: {{img | file = cardreader3.png}}
 
# Modify the settings for your environment (see table below for settings definitions).
 
# Modify the settings for your environment (see table below for settings definitions).
 
# Press Ctrl-X
 
# Press Ctrl-X
Line 194: Line 212:
  
 
'''Note:''' ''The network settings specified in this file are used by the web interface only. Changing these settings will not change the actual network settings for the microcomputer.''
 
'''Note:''' ''The network settings specified in this file are used by the web interface only. Changing these settings will not change the actual network settings for the microcomputer.''
 +
</div>

Latest revision as of 07:58, 3 August 2022

Wiring and Diagram

VALT Card Reader.png

Using 22/8 cable and a 2x20 pin connector, crimp the wires and connect as shown below Using B connectors, splice the HID RP15 connections with the corresponding colors.

HID RP15 Microcomputer
Red Pin 4
Black Pin 6
Green Pin 8
White Pin 10
Orange Pin 18

Cardreader6.png CardReCable.jpg

Finding the IP Address

Since the card reader is headless, there is no way to display the IP address. There are two options for discovering the IP address for the device.

  • Check the DHCP server logs to see what IP address was assigned to the device. The default name is cardreader.
  • Connect a monitor and keyboard to the microcomputer. You can then check the ip address by doing the following:
    1. Press alt-F2 on the keyboard.
    2. Enter the username ivsadmin.
    3. Enter the default password.
    4. Type the following command and press enter.
      ifconfig
    5. The ip address for eth0 should be displayed on the screen.

Manually Set an IP Address

If ip address cannot be obtained from DHCP and cannot access the web interface, the ip address maybe manually configured on the device. From the console:

  1. Type the following command and press enter.
    sudo rm /etc/dhcpcd.conf
  2. Type the following command and press enter.
    sudo nano /etc/dhcpcd.conf
  3. Copy and paste the following into the file.
hostname
clientid
persistent
interface eth0
static ip_address=192.168.1.45/24
static routers=192.168.1.1

Cardreader2.png

  1. Change the ip address, subnet mask, and gateway to the appropriate values.
Note: The subnet mask must be in CIDR notation.
  1. Press Ctrl-X
  2. Enter Y to save
  3. Do not change the file name and press enter.
  4. Reboot the microcomputer for the network changes to take affect.
Note: Changing the IP address in this way completely bypasses the web interface. If the web interface is accessed later on, the configuration will not be reflected there and changes made to the network configuration in the web interface will overwrite this configuration.

Configuring the Card Reader

Web Interface

Once know the IP address for the card reader microcomputer is known, the web interface can be accessed by typing https://ipaddress in any web browser. Make sure to replace ipaddress with the actual ip address for the card reader microcomputer.

Cardreader4.png

When prompted enter the username and password for the card reader.

Defaults
Username: ivs
Password: admin51

The configuration page will now be displayed.

Cardreader5.png

VALT Configuration

Setting Value
VALT Server Address This is the full URL for the VALT server. If https:// is not specified http:// is assumed.
VALT Username Username utilized to access VALT, this user should be a member of the administrator's group.
VALT Password VALT password for the specified user.
VALT Room Room number for the room in VALT that the card reader will control. This number can be found by pulling up the room in VALT and looking at the URL.
Status Displays whether or not the card reader is able to connect to the VALT server using the URL and credentials specified. This will also display an error if the room number does not exist.

Card Configuration

Setting Value
Card Number Start Position The position in the RFID card number where the actual card number starts.
Card Number End Position The position in the RFID card number where the actual card number ends.

Network Configuration

Setting Value
Mode Network configuration mode. (DHCP or STATIC)
IP Address Specifies the IP address for the card reader.
Subnet Mask Specified the subnet mask for the card reader. It must be specified in CIDR notation.
Gateway Specifies the gateway for the card reader.

Note: Network changes made in the web interface will take effect after the next reboot of the card reader.

Admin Configuration

Setting Function
Web Password The password user to log into the web interface.
Change Password Changes the web interface password to the value specified on the line above.
Restart Card Reader Reboots the card reader. This is required after changing the network configuration/
Web Interface Disables the web interface. WARNING: If disabled the only way to access the card reader will be through the command line interface.
Update Config Files Saves Valt, Card, and Network configuration. Success or Failure messages will be displayed below each section.

Command Line

  1. Connect to the card reader via SSH
  2. Type the following command and press enter.
    sudo nano /usr/local/ivs/config/cardreader.cfg
    Cardreader3.png
  3. Modify the settings for your environment (see table below for settings definitions).
  4. Press Ctrl-X
  5. Enter Y to save
  6. Do not change the file name and press enter.
  7. Reboot the microcomputer for the network changes to take affect.
Setting Value
server IP address or host name for the VALT server.
username Username utilized to access VALT, this user should be a member of the administrator's group.
password VALT password for the specified user.
room Room number for the room in VALT that the card reader will control. This number can be found by pulling up the room in VALT and looking at the URL.
https Specifies if https is enabled on the VALT appliance. Should be set to True or False.
mode Network configuration mode. Should be set to DHCP or STATIC
ipaddress Specifies the IP address for the microcomputer.
subnetmask Specifies the subnet mask for the microcomputer. It must be specified in CIDR notation.
gateway Specifies the gateway for the microcomputer.
cardstart The position in the RFID card number where the actual card number starts.
cardend The position in the RFID card number where the actual card number ends.

Note: The network settings specified in this file are used by the web interface only. Changing these settings will not change the actual network settings for the microcomputer.