Difference between revisions of "Card Reader Install"

From IVS Wiki
Jump to: navigation, search
(Created page with "=Wiring= A level shifter should be used between the RP15 and the microcomputer as the RP15 works at 5V and the microcomputer is rated for 3.3V. {| class="wikitable" ! HID RP15...")
 
(Wiring)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
=Wiring=
 
=Wiring=
A level shifter should be used between the RP15 and the microcomputer as the RP15 works at 5V and the microcomputer is rated for 3.3V.
+
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.  
 
{| class="wikitable"
 
{| class="wikitable"
 
! HID RP15
 
! HID RP15
Line 6: Line 7:
 
|-
 
|-
 
|Red
 
|Red
|Pin 4
+
|Pin 3
 
|-
 
|-
 
|Black
 
|Black
|Pin 6
+
|Pin 5
 
|-
 
|-
 
|Green
 
|Green
|Pin 8
+
|Pin 7
 
|-
 
|-
 
|White
 
|White
|Pin 10
+
|Pin 9
 
|-
 
|-
 
|Orange
 
|Orange
|Pin 18
+
|Pin 17
 
|}
 
|}
[[File:cardreader6.png]]
+
[[File:cardreader6.png|100px]] [[File:CardReCable.jpg|400px|https://ipivs.com/wiki/images/3/39/CardReCable.jpg]]
 +
 
 
=Finding the IP Address=
 
=Finding the IP Address=
Since the card reader is headless, there is no way to display the IP address. You have 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.
 
* Connect a monitor and keyboard to the microcomputer. You can then check the ip address by doing the following:
 
* Connect a monitor and keyboard to the microcomputer. You can then check the ip address by doing the following:
Line 30: Line 32:
 
*# 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.
 +
 
==Manually Set an IP Address==
 
==Manually Set an IP Address==
If you are unable to get an ip address from DHCP and are unable to access the web interface, you can manually configure an ip address 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:
 
# Type the following command and press enter. <pre>sudo rm /etc/dhcpcd.conf</pre>
 
# Type the following command and press enter. <pre>sudo rm /etc/dhcpcd.conf</pre>
Line 53: Line 57:
 
<li> Reboot the microcomputer for the network changes to take affect.
 
<li> Reboot the microcomputer for the network changes to take affect.
 
</ol>
 
</ol>
:: '''Note:''' ''Changing the IP address in this way completely bypasses the web interface. If you choose to access the web interface 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.''
 +
 
 
=Configuring the Card Reader=
 
=Configuring the Card Reader=
 
==Web Interface==
 
==Web Interface==
Once you know the IP address for the card reader microcomputer, you can access the web interface 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]]
 
::[[File:cardreader4.png]]
Line 65: Line 70:
 
The configuration page will now be displayed.
 
The configuration page will now be displayed.
 
:: [[File:cardreader5.png]]
 
:: [[File:cardreader5.png]]
===Valt Configuration===
+
===VALT Configuration===
 
{| class="wikitable"
 
{| class="wikitable"
 
! Setting
 
! Setting
 
! Value
 
! Value
 
|-
 
|-
|Valt Server Address
+
|VALT Server Address
 
|This is the full URL for the VALT server. If https:// is not specified http:// is assumed.
 
|This is the full URL for the VALT server. If https:// is not specified http:// is assumed.
 
|-
 
|-
|Valt Username
+
|VALT Username
 
|Username utilized to access VALT, this user should be a member of the administrator's group.
 
|Username utilized to access VALT, this user should be a member of the administrator's group.
 
|-
 
|-
|Valt Password
+
|VALT Password
 
|VALT password for the specified user.
 
|VALT password for the specified user.
 
|-
 
|-
|Valt Room
+
|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.
 
|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
 
|Status
|Displays whether or not the card reader is able to connect to the VALT server using the url and credentials specified. 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.
 
|}
 
|}
  
Line 137: Line 142:
 
|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.
 
|}
 
|}
 
  
 
==Command Line==
 
==Command Line==
# 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]]
 
#: [[File:cardreader3.png]]
Line 175: Line 179:
 
|-
 
|-
 
|subnetmask
 
|subnetmask
|Specifies the subnetmask for the microcomputer. It must be specified in CIDR notation.
+
|Specifies the subnet mask for the microcomputer. It must be specified in CIDR notation.
 
|-
 
|-
 
|gateway
 
|gateway

Latest revision as of 07:34, 8 October 2020

Wiring

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 3
Black Pin 5
Green Pin 7
White Pin 9
Orange Pin 17

Cardreader6.png https://ipivs.com/wiki/images/3/39/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.