# Step 8: Program Door Locks

Once you have [set up door locks](https://docs.seam.co/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/visionline-acs-setup-instructions/developing-and-launching-your-visionline-mobile-key-app/developing-your-visionline-mobile-key-app/step-7-set-up-door-locks-with-ble-profiles) in the Visionline application, use the Lock Service 3G application to program the door locks themselves. When you program a lock, you download the identity and settings for the lock from Lock Service 3G to the lock.

{% hint style="info" %}
As part of its [mobile development course](https://docs.seam.co/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/visionline-acs-setup-instructions/developing-and-launching-your-visionline-mobile-key-app/developing-your-visionline-mobile-key-app/step-1-complete-the-assa-abloy-mobile-development-course), ASSA ABLOY provides a demo lock that includes the required BLE module.
{% endhint %}

This process consists of the following basic steps:

1. [Install Lock Service 3G on a laptop or tablet.](#install-lock-service-3g)
2. [Configure the Visionline application to download door lock data to Lock Service 3G.](#configure-visionline-for-lock-service-3g)
3. [Configure Lock Service 3G to connect to the Visionline server.](#configure-lock-service-3g-to-connect-to-the-visionline-server)
4. [Download door lock data from the Visionline server to Lock Service 3G.](#download-door-lock-data-to-lock-service-3g)
5. [Initialize each door lock to program it with the correct settings.](#initialize-door-locks)

***

## Install Lock Service 3G

Install the Lock Service 3G on a Windows laptop or tablet that you can move to each door lock. You use an [RJ12 service cable](https://estore.assaabloyglobalsolutions.com/us/marine/service-cable-rj12-for-3g-rfid-lcu-e-cylinder.html) with an [RJ12 to USB adapter cable](https://estore.assaabloyglobalsolutions.com/us/marine/cable-rj12-to-usb-adapter-for-3g.html) to connect this laptop or tablet to each door lock.

{% hint style="info" %}
If the service cable with adapter cable does not work correctly, you may need to install the following driver:

`CDM v2.12.xx WHQL Certified.exe`
{% endhint %}

***

## Configure Visionline for Lock Service 3G

1. Log in to the Visionline application if you are not already logged in.
2. Add a device.

   1. At the bottom of the left navigation pane, click **Lists**.
   2. In the **System setup** section of the left navigation pane, double-click **Devices**.
   3. In the **Devices** window, click **Add**.
   4. In the **Device details** window, type a **Name** for the device, such as `Lock Service 3G`.
   5. Select **Service device host** as the device **Type**.
   6. Make sure that the **Port** is `27015`.
   7. Make sure that the **Location** is **Server**.
   8. Click **Save**.
   9. In the **Device details** window, click **Close**.
   10. In the **Devices** window, click **Close**.

   <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-ee819fb7f28e5ce7d2579f47406574a6103daed9%2Fvisionline-add-device-for-lock-service-3g.png?alt=media" alt="Add a device in the Visionline app."><figcaption><p>Add a device in the Visionline app.</p></figcaption></figure>
3. Obtain the registration code for the Lock Service 3G instance.

   1. At the bottom of the left navigation pane, click **Lists**.
   2. In the **System setup** section of the left navigation pane, double-click **Service devices**.
   3. In the **Service devices** window, click **Add**.
   4. Note the registration code and validity period that the Visionline application displays.\
      You must enter this code in Lock Service 3G on the laptop or tablet.
   5. Click **OK**.
   6. In the **Service devices** window, click **Close**.

   <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-31e5244d01324eca54f08bdefcc4af3ce57aa3f8%2Fvisionline-get-registration-code.png?alt=media" alt="Obtain the registration code for Lock Service 3G."><figcaption><p>Obtain the registration code for Lock Service 3G.</p></figcaption></figure>

***

## Configure Lock Service 3G to Connect to the Visionline Server

1. Open the Lock Service 3G application if you have not done so already.
2. Add a server connection.

   1. In the **Setup** section of the left navigation pane, click **Server connections**.
   2. If the **Server connections** dialog does not display automatically, click **Add**.
   3. In the **Server connections** dialog, type a **Name** for this connection to the Visionline server.\
      Note that some of the field names in this dialog are different in different versions of Lock Service 3G.
   4. In the **Address** field, type the IP address of the Visionline server.
   5. Type the **Port** number to use to connect to the Visionline server.
   6. Click **OK**.

   <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-fc07de44456e208b4fbbec22758f6c3b02b48cfa%2Flock-service-3g-add-server-connection.png?alt=media" alt="Add the connection between Lock Service 3G and the Visionline server."><figcaption><p>Add the connection between Lock Service 3G and the Visionline server.</p></figcaption></figure>
3. At the right of the **Lock Service 3G** window, in the lower field in the **Serial port and host** area, select the name of the Visionline server connection that you created.

   <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-390dfedb6c74df8069baa9bdf2b1f60d2a3f1058%2Flock-service-3g-select-server.png?alt=media" alt="Select the Visionline server connection." width="139"><figcaption><p>Select the Visionline server connection.</p></figcaption></figure>
4. Register Lock Service 3G on the laptop or tablet.

   1. In the **Setup** section of the left navigation pane, click **Register PC**.
   2. In the **Register PC** area, type the registration **Code** that you obtained from the Visionline application.
   3. Click **Register**.

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-be2dd82d02b7690bc9c97d70dd22fe1d511bb848%2Flock-service-3g-register-pc.png?alt=media" alt="Use the registration code from the Visionline application to register Lock Service 3G."><figcaption><p>Use the registration code from the Visionline application to register Lock Service 3G.</p></figcaption></figure>

   Lock Service 3G registers with the Visionline server and displays a **Registration Finished** message.
5. Click **OK**.
6. Retrieve the Visionline system ID.

   1. In the **Setup** section of the left navigation pane, click **System ID**.
   2. In the **System ID** area, click **Get**.

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-e409c1ecbe7d91acb20dacf7ebf5a972cd57e34e%2Flock-service-3g-get-system-id.png?alt=media" alt="Retrieve the Visionline system ID."><figcaption><p>Retrieve the Visionline system ID.</p></figcaption></figure>

   Lock Service 3G retrieves the Visionline system ID and then displays a **New system ID has been set** message.
7. Click **OK**.

***

## Download Door Lock Data to Lock Service 3G

1. Open the Lock Service 3G application if you have not done so already.
2. In the **Setup** section of the left navigation pane, click **Download data from server**.
3. At the right of the **Lock Service 3G** window, in the lower field in the **Serial port and host** area, select the name of the Visionline server connection.
4. In the **Download data from server** area, click **Check all**.
5. Click **Download**.

<figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-fd869f9c29bb10ca4b14798ea8ddaf98d04fa27c%2Flock-service-3g-download-data.png?alt=media" alt="Download the door lock data from the Visionline server to Lock Service 3G."><figcaption><p>Download the door lock data from the Visionline server to Lock Service 3G.</p></figcaption></figure>

Lock Service downloads the door lock data from the Visionline server and displays a message when the download is complete.

***

## Initialize Door Locks

Perform the following steps on each lock:

1. Only if necessary, update the Lock Control Unit firmware.\
   **Test locks from ASSA ABLOY should already be preprogrammed with the correct firmware.**\
   For other locks, contact ASSA ABLOY to learn whether you need to update the Lock Control Unit firmware and, if so, to obtain the correct firmware version.
   1. Open the Lock Service 3G application if you have not done so already.
   2. In the **Initiation** section of the left navigation pane, click **Upload firmware**.
   3. At the right of the **Lock Service 3G** window, in the lower field in the **Serial port and host** area, select the name of the Visionline server connection.
   4. In the **Upload firmware** area, click **Browse**.\\

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-caba60ae463d7d4af3044f609a79a9445993212e%2Flock-service-3g-upload-firmware.png?alt=media" alt="Select the Lock Control Unit firmware to upload."><figcaption><p>Select the Lock Control Unit firmware to upload.</p></figcaption></figure>
   5. Select the firmware that ASSA ABLOY has sent to you and then click **Open**.
   6. In the **Available versions** table, right-click the appropriate firmware version and select **Save to database**.\\

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-e1be75b5f219ec2aeb374d073d2bd440eb6c4298%2Flock-service-3g-upload-fw-save-to-db.png?alt=media" alt="Save the firmware to the database." width="362"><figcaption><p>Save the firmware to the database.</p></figcaption></figure>
   7. In the **Available versions** table, select the appropriate firmware version.
   8. At the right of the **Lock Service 3G** window, in the upper field in the **Serial port and host** area, select the serial port that you want to use to connect to the lock.

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-c5262632cd0f25ef7642ce0bdbeb53d7d69c6860%2Flock-service-3g-select-port.png?alt=media" alt="Select the port." width="139"><figcaption><p>Select the port.</p></figcaption></figure>
   9. Connect the service cable with adapter cable from the laptop or tablet running Lock Service 3G to the lock.
   10. At the bottom of the **Upload firmware** area, click **Upload**.
2. Open the Lock Service 3G application if you have not done so already.
3. Initialize the lock.
   1. In the **Initiation** section of the left navigation pane, click **Initialize lock**.
   2. At the right of the **Lock Service 3G** window, in the lower field in the **Serial port and host** area, select the name of the Visionline server connection.
   3. In the **Initialize lock** area, expand the appropriate door area and select the lock that you want to initialize.
   4. Select the **Read parameters after successful initialization** checkbox.
   5. Select the **Include BLE configuration data** checkbox.
   6. At the right of the **Lock Service 3G** window, in the upper field in the **Serial port and host** area, select the serial port that you want to use to connect to the lock.
   7. Connect the service cable with adapter cable from the laptop or tablet running Lock Service 3G to the lock and then click **Initialize**.

      <figure><img src="https://2727122207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxnN2A67918om1UthYWsF%2Fuploads%2Fgit-blob-0ba2ce8d933c066968524d063139161bc65d65b4%2Flock-service-3g-initialize-lock-ble-config.png?alt=media" alt="Connect Lock Service 3G to each lock and initialize it."><figcaption><p>Connect Lock Service 3G to each lock and initialize it.</p></figcaption></figure>