====== HowTo Setup Barcode Scanner ======

In this HowTo we focus to the **Metrologic Product MS9535 Voyager and the Os X Operating System**.\\

To use the Thot library with a barcode scanner, we need to configre the scanner as a serial device and then we need to start a bash script that is able to interpret the data from the scanner. The connection use the bluetooth system, that is a default feature both on the Metrologic Scanner and also on the Apple products.

=== Essentials to configure the scanner ===
  - Print {{thot:scanner:metrologic-setup.jpg?100}} this page. It's a page with all the codes necessary to configure the scanner.

==== Pair the scanner ====

The first step to do is the pairing of the scanner with the computer host.
  - Check that the scanner is completely charged
  - Scan the first code on the page you printed before
  - From the **System Preferences** open the Bluetooth panel
  - Click the **Set Up New Device** button (in the low right of the windows), in the next window click on **Continue**.
  - Select the **Any Device** button and click **Continue**
  - The system will display all the devices it finds.
  - Check in the **options** panel that the system don't ask a key for pairing.
  - Select the **VoyagerBT** voice and click on **Continue**
    - The name complete of the device is VoyagerBT plus the serial number of the device
  - If all is correct the computer will pair with the scanner and present the Congratulations message. Click on **Quit**.
  - In case of error repeat the procedure from the beginning.

==== Configure the scanner ====
In the default configuration, the scanner will add a CR (Carriage Return) code to all the barcodes it scans and this generate a problem in the program that read the data from the scanner. To resolve this, we need to change the default behaviour of the scanner.\\
  - Pass the scanner over the 3rd barcode (the one labeled **Disable CR Suffix** that is printed on the configuration page printed before. The scanner will emit some **beeps**.

==== The program ====
  - Download {{thot:scanner:checkout.zip|this}} zip file and explode it.
  - Start the checkout program, you will hear z 2 tone **beeps** from the scanner. This means that the scanner is online, ready.
<note>
**If you have more than one VoyagerBT scanner**\\
\\
The program will connect only to the first scanner listed in the **/dev** directory
</note>

==== The use of the program ====
  - Try to scan your NBIS barcode (the code on the Camipro) or any other barcode. **NOT** the codes from the configuration page.
  - The program will open Safari, pointing in the **Thot Library Check Out Page**. If you are in the database of thot you'll see all the books you have in use.

==== Thot User ====
  - Configure a local account //thot// with no Admin privileges.
  - Assign to this user the **Autologin** at startup.
  - Login as thot
  - Open the **System Preferences** panel and select the **Dock** subpanel
    - Position the **Dock** on the right margin.
    - Activate the flag **Automatically Hide and show the Dock**
  - Open Safari and go to the **Preferences** panel (Safari->Preferences from the menu, or Command+,).
  - In the **General** tab
    - As home page insert: **http://thot.epfl.ch**
    - At the bottom of the page, There's the label **Open links from applications:**. Select the **in the current window** flag.
  - Close the preferences panel and Safari (not only the window, quit the application).
  - copy the checkout script in the **/Library/StartupItems**
  - copy the checkout script in the Desktop of the //thot// user.
  - reboot the computer and check everything.
  
\\

\\