The Mobility Factory Documentation

The Mobility Factory Documentation

  • App manual
  • Control Center manual
  • Platform docs
  • Developers docs
  • Release history
  • Cooperative docs

›Setup&configuration guides

Getting Started

  • How to write docs
  • Test app

REST API

  • REST API

Concepts

  • Pricing
  • Access Control
  • Messaging

Setup&configuration guides

  • Setting up an invoicing service
  • Setting up an ilockit bike lock
  • Setting up garage door
  • Setting up 2FA

Setting up garage door

Database

The next paragraph is for reference purposes only. If a vehicle has multiple vehicle service units associated with it, on a database level, access to the garage door should be granted for every vehicle service unit. If the configuration is done via Control Center, Control Center will automatically take care of this.

A home zone in the database can have multiple garage doors associated with it: /places/<placeId>/garageDoors will be a map of key, value pairs, where the key is the vehicleServiceUnitId and value the garageDoorId.

Control Center permission

Administrators with the garageDoors:Control permission set to true will be allowed to open all garage doors.

Wesmartpark

  1. The following json should be added to the database.

{
  "type": "wesmartpark",
  "name": "WeSmartPark test device",
  "ownerGroup": "tmf",
  "managerId": "12388",
  "parkingId": "608",
  "door": 0
}

"door": 0 should be used for the WeSmartPark entry door.

"door": 1 should be used for the WeSmartPark exit door.

  1. One or more garage doors can be linked to a home zone. See above
  2. Make sure there is a refreshToken in /secure/garageDoors/wesmartpark/refreshToken

Extra steps needed for TMF apps older then version 22.03

In TMF apps older then version 22.03 a deprecated API call is used. This configuration and the associated API call should be phased out.

  1. Set parkingDoor:true on carConfigs/<carConfigId>
  2. Create a person with id wesmartpark that is member of the same owner group and has the correct permission
  3. Add a json to resourceSets/wesmartpark following the below explained structure.
{
  "apis": {
      "parking":{
          "cars": {
              "vehicleId": "garageDoorId"
          },
          "key": "wesmartpark"
      }
  }
}

The cars map should contain key/value pairs where key is the id of the physical vehicle and the value the id of the garage door.

  1. Set groups/<ownerGroupId>/generalResourceSet/wesmartpark

Lthings

The following should be added to the database.


{
  "type": "lthings",
  "name": "Lthings test device",
  "ownerGroup": "tmf",
  "parkingId": "f197af43-26f4-48da-9131-b0dc697a83b5"
}

parkingId should contain the lthings device id.

  1. One or more garage doors can be linked to a home zone. See above
  2. Make sure there is an API key in /secure/garageDoors/lthings/apiKey

Steps needed for TMF apps older then version 22.03

In TMF apps older then version 22.03 a deprecated API call is used. This configuration and the associated API call should be phased out.

  1. Set parkingDoor:true on carConfigs/<carConfigId>
  2. Create a resourceSet according to the following json
  3. Add a json to resourceSets/lthings following the below explained structure.
{
  "apis": {
      "parking":{
          "cars": {
              "vehicleId": "deviceId"
          },
          "key": "<insert lthings api key here>"
      }
  }
}

The cars map should contain key/value pairs where key is the id of the physical vehicle and value the lthings device id.

  1. Set groups/<ownerGroupId>/generalResourceSet/lthings
← Setting up an ilockit bike lockSetting up 2FA →
  • Database
    • Control Center permission
  • Wesmartpark
  • Lthings
The Mobility Factory Documentation
For cooperative members
TMF Member PortalTMF CommunityTMF Bug ReportingPropose new featureContact support
More information
Demo AppDemo Control CenterTMF Home pageContact for more infoMembership application
Terms and Conditions
Copyright © 2023 The Mobility Factory SCE