2.1  Proposed Installation of WiFisecureAccess controller on a door

The picture below is the proposed installation diagram of wiFisecureAccess controller on a door with electric strike of magnetic lock. The components of installation are 1) WiFisecureAccess controller, 2) Electric strike or magnetic lock, 3) Magnetic sensor (optional), 4) QRCode tag, and and 5) connecting cables. The magnetic sensor are optional and they may be installed only if you want its features.

2.2  Installation of an electric strike on a door

To install keyless entry using WiFiSecureaccess contoller, you need to install either an electric strike or a magnetic lock on the door. You have to choose the right kind of electric strike or magnetic lock that fits on your door frame. This part does not come with the wifisecureaccess controller, as the type of electric strike or magnetic lock that you need depends on your door frame and your personal likes. These are available to buy from Amazon or from any other sources you prefer.

2.3  Installation of a magnetic lock on a door

If you prefer to use a magnetic lock instead of an electric strike, you can do so, if your door is suitable for that.

2.4  Cabling electric strikes and magnetic locks to the controller

The following diagrams show how to cable the electric strike and magnetic lock to WiFiSecureAccess controller (normally off). This is a fail-secure type electric strike. It stays locked when the power is off. When power is applied, the lock opens.

If your electric strike has a built-in status sensor, it will have at least four terminals (or four wires coming out of it). In that case, cable the two wires of the solenoid coil as shown below. The status sensor terminals are to be cabled to D7 and GND as explained in section 2.5.

2.5  Installing magnetic sensor on a door

If you need to know the current state of the door (whether Open or Closed) from remote on your smart phone, you need to install a status sensor. If the electric strike has a built-in status sensor, that can be cabled to the device controller. The electric strike with status sensor witll have four wires coming out of it. Two of those are for the solenoid coil as explained earlier and the other two wires are from the status sensor. If the electric strike has this status sensor, cable those two wires to the D7 and GND of the device controller.

If the electric strike does not have built-in status sensor, you may install an external sensor. You can install a limit switch or a magnetic switch on the door such that it closes when the door is closed. Here is a picture of the sensor installed on a door.

Then cable the sensor to D7 of the smart device (with one terminal of the sensor D7 and the other terminal to GND on the smart device).

After installing the sensor, you need to test if it is working properly. In section 3.7 of this documentation, you will see how to check if the sensor is currently ON or OFF (Refer Fig 114).

Next, enable the sensor in the configuration. Click on 'Ports and Security' under Device Admin in the dahboard menu. Select the device. In the opening page, select 'Yes' for the 'Door Sensor Connected' field. Then press Submit button.

PS: In order for it to use the sensor to detect the current position of the door/gate, not only that you have to install the sensor, but also you have to set 'Yes' to the field 'Door Sensor Connected' in the 'Ports and security' settings of this device.

If the device is installed on a door with electric strike that has Status sensor built in, then you do not need an external magnetic sensor. You can cable the two wires of the status sensor of the elecxtric strike to D7 and GND terminal of the controller.

If sensor is installed and enabled. you can also enable notifications as explained in section 3.14 of this documentation.

Note:Doors and gates can be operated even without the sensor. As mentioned earlier, the sensor helps in knowing the current position of the door/gate (whether open or closed) from remote accurately. You can also enable sending notifications or sound buzzer if the door remains open for a long time. Sending notifications are possible only if the sensor is installed.

2.6  Integrating Smart controller to existing garage doors or gates

In order to integrate the smart controller to your garage doors or gates, you need to locate the two terminals of a manual push button on your existing garage door controller. There are plenty of manufactures of garage doors and gates and, therefore, the controller of those garage doors and gates can come in various designs. However, all of them will have a manual switch (push button) to open/close. This switch may either be located on the PCB of the garage door controller, or it may be mounted on the wall or elsewhere in the garage. On some garage door/gate controllers, you may find two terminals on a terminal block on the main controller marked as 'Push Button'. Here are some example pictures:

Here is another garage door controller from another manufacturer:

Or, in some cases, you may find a push button on the wall.

You can cable the smart controller to either the push button terminals on the main controller, or to the two terminals inside the push button on the wall. Test manually before cabling the smart controller to the push button terminals to confirm that this is compatible. To test it manually, short between the two terminals using a bare wire. You should be seeing the garage door either opens or closes. If so, this is compatible to the WiFiSecureAccess smart controller

If the garage door/gate is compatible, cable the WifiSecureAccess smart controller to the push button terminals of the garage door. Cable COM and NO terminals of the J2 connector of the WiFiSecureAccess controller to the push button terminals of the garage door/gate controller. Mount the controller anywhere convenient, preferably close to the pushbutton terminals (either on the wall, or near the terminal blocks on the garage controller).

Gates with two push buttons - one for Opening and another for Closing

There are some gates with two separate manual push buttons - one for opening and another for closing. In most of those cases, the gate's controller usually closes the gate automatically a few seconds after it is opened. So, smart device needs to be cabled to the Open terminals of the gate controller.

However, if you want the smart device to open as well as close that type of gate, the cabling of the smart device to the controller of that gate has to be done differently. To interface the WiFiSecureAccess smart device to that type of gates, you need to install two normally open Single Point Single Throw (SPST) switches on those gates. One is to be installed such that the switch closes and conducts when the gate is in fully closed position. Another SPST switch is to be installed such that it closes and conducts when the gate is in fully open position. Then cable the WiFiSecureAccess smart device through these two SPST switches as shown in the figure below. In this figure, the picture of the gate controller board is from the installation manual of a Lift Master gate available in USA. For any other similar gates, look for these Open and Close terminals on its controller board.

Note: It is assumed that the controller of the gate is such that it fully closes the gate when its Close push button is pressed and released without stopping the gate in between. Similarly, it is assumed that the controller opens the gate fully without stopping in between when the Open push button is pressed and released. If the gate is stuck in between, the controller of the gate must have the needed mechanism on its own to bring the gate either to a fully open position or a fully closed position. The Wifisecureaccess device will not be able to do that by giving commands when the gate is stuck in between

2.7  Installling Magnetic Sensor on garage doors or gates

Next, install the magnetic sensor. This is optional. If you install this sensor, you can know from remote whether or not the garage is currently open or closed. This will also help sending alarm notifications. Install the sensor at a convenient position on the garage door such that the distance from that to the WiFiSecureAccess controller is not too long. Install as per your convenience such that the two parts (A and B) of the sensor align themselves (within 10mm space between them) when the garage is closed. If you can fix them such that the gap is around 1cm, that will be much better. If the gap is longer, there can be instances that it can read incorrect position of the garage door. Fix the part (Part B) with the cable on the fixed frame and the other one (part A) on the moving frame of the garage. The following are some pictures that will help you install this. Note: Both the parts of the magnetic sensor have double-sided mounting tape at their back. So, you can mount it anywhere convenient, and no screw is required.

Then cable the sensor to D7 of the smart device (with one terminal of the sensor D7 and the other terminal to GND on the smart device).

After installing the sensor, you need to test if it is working properly. In section 3.7 of this documentation, you will see how to check if the sensor is currently ON or OFF (Refer Fig 114). The sensor must be ON when the garage/gate is closed and OFF when it is open.

PS: In order for it to use the sensor to detect the current position of the door/gate, not only that you have to install the sensor, but also you have to enable either one of the notifications (either buzzer or email as per section 3.14 of this documentation).

After installing and testing the sensor, you need to enable at least one of the two notifications so that the controller will use it. Section 3.14 of this documentation tells you how to enable the notifications. If you do not enable any one notification, the controller will not read the sensor. If it does not read sensor, and if you open or close the door either manually, or by using any other remote, the controller will not know it and whatever it reports may be out of sync. So, to use sensor, not only that you have to install the sensor, but also must enable at least one notification. Even if you do not want any notifications, you can let it sound buzzer at least once when it stays open for a long time ( say 5 minutes). Refer 3.14 of this documentation for enabling it.

Note:The doors, garage doors and gates can be operated even without the sensor. As mentioned earlier, the sensor helps in knowing the current position of the garage door (whether open or closed) from remote accurately. You can also enable sending notifications if the garage remains open for a long time. Sending notifications are possible only if the sensor is installed.

2.8  Integrating with a Boom Gate or any similar gate

If this is a parking lot, or any public access place with a boom gate or any similar gate with its own controller, WifiSecureAccess controller can be integrated with it. Most of those boom gate controllers will have a manual push button terminal to manually operate the gate. Either a push button is already connected, or one can connect a push button to it. If so, by pushing that push button, one can open or close the gate. Once you locate those two terminals of that push button, you can cable the RELAY terminals COM and NO of the WiFiSecureAccess controller to those two terminals of the push button. That is all what is needed to integrate WiFiSecureAccess controller to a boom gate or any similar gate with its own controller.

You need to interface WiFiSecureAccess controller to every gate of the public place or the parking lot. The controller can be installed anywhere secure so that nobody other than the owner can access it. Then, run cables from that to the boom gate controller. It is important that WiFi is available at the location where the controller is installed. Install the scanner (or just the QRCode or NFC tag) anywhere convenient for the public to scan when entering the public place or parking lot. You can print additional QRCode, if you want, as per the instructions given in the next section of this document. If you are installing the scanner instead of just QRCode or NFC tag, and if you want the LED and buzzer of that to be active, then it has to be cabled to the WiFiSecureaccess controller using the flat cable that came with the unit. However, the length of that cable is only 1.5 meter and is not advisable to extend it. So, if you want the scanner to be cabled to the controller, the controller has to be near the scanner. The pictures below show how the WiFiSecureAccess controller can be cabled to a boom gate.

Fig 51A below shows a typical cabling diagram for a Magnetic Autocontrol barrier boom gate. Magnetic Autocontrol is one of the available barrier boom gates used by customers. For any other make and model of boom gates, refer to their User Manual to find the trigger points to connect the device to.

2.9  Installing an ultrasound sensor in a bay in parking lots to detect a vehicle

When used in parking lots, need may arise to detect if a vehicle is parked in a bay. Ultrasound sensors can be useed for this. This is optional. HC-SR04 Distance Transducer Sensors can be cabled to WiFisecureaccess controller, and that will help the controller to sense if there is a vehicle parked in a bay. This sensor is available for purchase, and it does not come with WiFisecureAccess controller. These sensors are low-cost sensors which are readily available in the market. You will find them on eBay and amazon. Here is a link from Amazon.
Note: This is just one link to show the type of sensor. We are not recommending to buy this. You can search and buy this from any supplier of your choice.

(If this link is broken, search for HC-SR04 in Amazanon.com)
PS: Make sure to buy the model that works with 3.3V power supply
Buy Now

Figure 22 shows how to connect this ultrasound sensor to WiFiSecureAccess controller. Use connector PJ3 on the smart device. This connector has four pins (GND, D1, D6 3V3). Connector J1 also has these D1, D6, 3.3V and GND. You can use either one of these connectors. Connect D1 to 'Trig', D6 to 'Echo', GND to GND and 3V3 to VCC as marked in Fig 61 and 63.

If you are using J1 connector, do the cabling as shown in Fig 60 and 61.

If using PJ3 connector, use a flat cable to connect from PJ3 connector to the ultrasound sensor.

Installation of ultrasound in each and every bay of a parking lot is optional. To install an ultrasound sensor at each bay, you also need a WiFiSecureAccess controller at each and every bay. You need to install this only if you want to detect if there is a vehicle parked in each bay. If installing In a parking bay, install the sensor in the bay at convenient location so that it senses when the vehicle is parked.

Refer to section 5.2 for configuring the WiFisecureAccess controller to enable the use of ultrasound sensors connected to it.

3.1  Setting up the App on your Smart Phone

If you have not downloaded the wifisecureaccess app yet, please download it to your smartphone now. Search for wifisecureaccess in either Apple Store or Google Play store.

3.2  Setting WiFi of the Device

There are two ways of setting the WiFi of the device

• Using the hotspot of your smart phone
• Setting the device as a web server and using a browser (Chrome preferred) on your computer or smart phone. Refer to section 3.5 of this documentation for this method.

Using the HotSpot on your smart phone

If this is a brand new device, its WiFi has been factory reset to the following:

4.1  Allowing Others to Use Your Devices

You can allow or authorize the others to use your smart device. To allow someone else to use your device, they have to be registered with wifisecureaccess.com. So, request the other user to register with wifisucureaccess.com. To register, either download the app and open the app and press Admin Dashboard, or go to https://wifisecureaccess.com and click on dashboard in the top navigation bar. When it requests you to login, click on 'Create a New account'

Once they are registered, you add their email address to the Allowed Users group of your device as per the steps below:

First create a Device Group. This can be done by clicking 'Devices groups' under 'Device Groups' in the Dashboard menu.

4.2  Configuring Group Entry Controls

It is possible to create entry controls on the members of a device group. For example, if you want to allow the members of a group only between some specific time of a day, you can set the opening and closing times for a group. To do that, click on 'Group entry Control' under Device Groups. This tab will be available only if you have created a group. If you have created multiple groups, you will be prompted to select a group. Once selected, you will see a page similar to Fig 133.

4.3  Creating a New Group by merging members of two other groups

If you have created two groups and you have added members in each group, and if you are interested in creating ai new group that should contain members of both the other groups, you can do so. First create a new empty group by clicking 'Devices Groups' under 'Device Groups' in the dashboard menu. Then click on 'Merge Device Groups' under 'Device groups' in Dashboard menu. You will see a page similar to Fig 134.

4.5  Uploading allowed users from a file on your computer

If you have a file with email addresses of all the allowed users, you can upload that directly to any of the device groups, if you want. The file must be a txt file with multiple lines, with each line for each customer. The format of each line must be as follows:

customer_email, start_date_time, expiry_date_time, permissions

jack@gmail.com,2021-10-15 10:30, 2021-11-20 12:00,M
abcd@gmail.com, 2021-10-15 10:30, 2021-11-20 12:00
xyz@gmail.com, , 2022-06-10 2:00
john@gmail.com
jason@gmail.com, 2021-06-12 5:30
ray@gmail.com,,,M

4.6  Downloading allowed users to a file on your computer

A list of all allowed users in a group can be downloaded to a file on your computer. Click on 'Download Allowed Users' under 'Device Groups" in the Dashboard menu. It will prompt you for the group name. Then it will download all the download users to a file on your computer. That wil will contain one loine for each user. Each line will have a format as shown below:

customer_email, start_date_time, expiry_date_time

4.7  Displaying number of people within an Office/Building

If you have installed separate doors for entry and exit, and if nobody is allowed to open or close the door either manually or by any other means other than wifisecureaccess system, the system keeps a count of the number of people within the room or building. If any of the door is for entry as well as exit (ENTRY/EXIT), you can install a separate QRCodes or NFC tags for entry and exits, instead of using the same tag for both. You can print the QRCode labels for entry as well as exit in the 'Configure Device' menu. Click on 'Configure device' under Device Admin in the dashboard menu (Fig 135).

4.8  Group Use Records

The system keeps record of the use of all the doors/gates of this group. At any time, you can see who used this group at what time. To see the group use records, click on 'Group Use records' under "device groups' in the dashboard menu. If you have created multiple groups, you will be prompted to select the group. Once selected, you will see a page similar to Fig 137.

You can download these use records to your computer, if you want to do so for keeping any records, or for analysing the data. To download, click on 'Download Group Use records' under Device Groups in the dashboard menu. There you can provide the dates between which you want to download the data. Leaving any of these dates will take that date as open-ended. Leaving both dates as blank will download all the available use records for the past 30 days.

You can also add a program in any of your applications to download these records, and do analysis. These use records can be read using a python program. Refer to section 9.2 of this documentation.

5.1  Installing Smart Devices and Cabling them to door/gates/Boom Gates

Cabling the Device to actuators on the doors and gates, or to boom gate of the parking lot is described section 2.8 of this document. Install smart devices at every entry gate and exit gate of the public place or parking lot. Either install the scanner or print additional QRCode label (or NFC Tag, if you are using NFC Tags) of the device and locate it at the convenient place at the gate so that the customers can scan them easily. Refer to section 3.7 of this documentation if you want to use additional QRCode or NFC tag other than the ones used with the scanner.

5.2  Enabling and using ultrasound sensors, if needed

If interested in detecting the vehicle in each and every bay of a parking lot, you need to install WiFiSecureAccess controller at every bay of the parking lot and cable ultrasound sensors to it. Then position the sensor to detect the vehicles when parked in that bay as explained in section 2.9 of this documentation.

If ultrasound sensors are installed and cabled to WiFiSecureAccess controller in that bay, that controller has to be configured to use the ultrasound sensor. To do so, click on 'Configure Device' in the left menu bar under Device Admin in Dashboard. Then select the controller to which the sensor is cabled. In the page that opens, you will see a field name 'USOUND'. By default, this is set to 'No'. Select USOUND to 'YES' as shown in Fig 138. Then press Submit.

5.3  How to register a Public Access Place or a Public Parking Lot with WiFiSecureAccess

You need to first register your public place or parking lot with WiFiSecureAccess providing a unique name and its address. Address must be identifiable by Google maps. To register, click 'Dashboard'. If you have not used WiFiSecureAccess yet, you will be asked to login or register yourself and will be taken to a login page. Once loged in, you will be taken to the index page where you will see several options. If you have not purchased and registered any WifiSecureAccess controllers yet, you will see some tabs to 1) 'Take ownership of a device' and 2) Create a Virtual Device. If you have purchased a controller, click on 'Take ownership of a device' and follow the prompt. Or, if you want to work with a virtual device, click on 'Create a virtual device'. A virtual device is just a label with a QRCode, or NFC tag. A virtual device is enough to manage access to public places and parking lots if you do not want it to control its gates or doors. Physical controller is required to control the doors and gates at the entry and exit. Once you have taken ownership of a controller, or created a virtual device, you will see a button named 'Register Public Place/Parking Lot' in the main dashboard page. If you already have another parking lot in the system, you will see a button name 'Public Place/Parking Lot Admin'. If so, click 'Public Place/Parking Lot Admin'. That will show the button 'Register Public Place/Parking Lot'. Then click on 'Register Public Place/Parking Lot'.

1. Access Type: This field sets the type of the premise - whetrher this is a parking lot for parking vehicles or whether it is a place for people access such as cinema halls, public event halls, buses and trains and so on. There are two options for this field. Select according to what this place is used for.

2. Transport Type: This field sets whether or not this is used for public transport such as buses, trains, or planes. If this is used for public transport, set this field as Yes. Otherwise, set it as No. The default is No.

3. Device Usage: This field is autoset and cannot be changed by users. This field is for information only. This field shows whether the public place/parking lot has devices installed at every seat/bay of the public place/parking lot. If you want to manage every seat/bay of the place, you can install devices at every seat/bay in addition to controllers (devices) at the entry and exit. If you ever install like that, this 'Device Usage' field will show it as DEVICE AT EVERY SEAT/BAY'.

4. Hold Time: This is the time in minutes a seat/bay in a public place or parking lot can be held by a customer while driving to that location. The default is 0, indicating that holding a seat/bay is not allowed. If you set this field as 0, nobody can hold a a seat/bay. To allow this feature, set the Hold Time to the number of minutes that you woould like to allow holding.

5. Category Option: There are two options here. 1) ALLOW CATEGORY DOWNGRADE and 2) DO NOT ALLOW CATEGORY DOWNGRADE. If you select the first option, customers can access a lower entry/parking category when the seats/bay in the category of the customer is full. For example, if the public place/parking lot has several categories of checkin, and if the customer's category is, say, 4 and, say, if all seats/bay in category 4 are currently full, the customer will be allowed to checkin to category 3 if seats/bay in category 3 are available, if this field is set to "ALLOW CATEGORY DOWNGRADE". These categories have to be configured for your public place/parking lot after registering the public place/parking lot. In the later sections of this document, you will find the steps for that.

6. Allow Waiting: If you choose the option “Allow Waiting”, customers will be allowed to enter the public place/parking lot and wait within the public place/parking lot when the place is full. On the other hand. If “DO NOT ALLOW WAITING” option is chosen, no customer will be allowed in when it is full.

7. Info Link: You can give a url of your website here (if you have one) describing more about your public place/parking lot. If a link is given, that link will be available for customers to click in the pop up window in the Google map. They can click on the name of your public place/parking lot and it will take them to your site.

5.4  Configuring Devices at Entry and Exit Gates or Doors

It is now necessary to configure all the smart devices that are installed at the entry and exit gates of this public place/parking lot. Do the following steps on each and every one of those smart devices. As mentioned earlier, the devices can also be virtual device with just a QRCode or NFC tag.

Click on 'Configure Device' under Device Admin in Dashboard. You will see a page similar to Fig 148.

5.5  Configure Entry/Parking Categories and maximum Spaces Available in Each Category

The next thing to do after registering a public place/parking lot is to configure entry/parking categories and number of spaces available in this public place/parking lot in each category. There are two types of access categories: 1) General and 2) special. General categories are for general public whereas the special categories are for restricted public. These categories will help setting different access fees and access times for different categories of checkin. Special categories are reserved for those whom you authorise. At the time of checkin, the customer selects which category he wants to checkin. If he has chosen a special category, the system will check if he is authorized to check into that category. You can create a maximum of 10 categories with different priorities in each. A category priority number greater than 9 is considered as special category. The higher the priority number, the higher is the priority.

To create an access category in the pblic place or parking lot that you own, click on 'Access Categories' under 'Public Place/Parking' in the dashboard menu. That will open up a page as shown below.

Special categories

5.7  Uploading members of Special Categories from a file

If you have a file with email addresses of all the members whom you want to add to the special categories, you can upload that directly to any of the special categories. The file must be a txt file with multiple lines, with each line for each customer. The format of each line must be as follows:

customer_email, start_date_time, expiry_date_time, entry_fee_discount, fine_discount

abcd@gmail.com, 2021-10-15 10:30, 2021-11-20 12:00, 20.0, 10.0
xyz@gmail.com, , 2022-06-10 2:00, 39.0
john@gmail.com
jason@gmail.com, 2021-06-12 5:30

5.8  Downloading members of Special Categories to a file

The list of members of any special category can also be downloaded to a file on your computer. Click 'Download Spl Cat Members' under 'Public Place/Parking Lot admin' in the dashboad menu. It will prompt fot the public place/parking lot. Then it will prompt for the category. Then, it will download the list of members to a file on your computer. This file will have one line for each member. Each line will have the following format:

customer_email, start_date_time, expiry_date_time, entry_fee_discount, fine_discount

5.9  Configure Access Fees or Parking Fees

To configure entry/parking fees and fines, click on 'Entry Control and Fees' under 'Public Place/Parking Lots Admin' in the Dashboard menu. You will be presented with a page similar to Fig 152.

Category: This is the checkin/parking category for which this tariff applies. Select one from the pulldown menu. You need to create separate fee slabs for each category.

Week and Day: 'Week' and 'Day' are the week number of the calendar year (Gregarian Week number) and day of the week respectively. By default these are set as *, indicating that the check-in/parking fee is the same any day of the week in every week of the year. However, if you want to set different fees for different days of the week, you can select the day for which this fee is applicable. Similarly, if you want to set different fee for different weeks in the year, you can enter the week number. If you do not know the week number corresponding to a date, just enter any date within that week. It will find its week number. Keep in mind that if you are setting a fee for, say, Monday of the week, and leave week as *, that fee is applicable for every Monday of every week. If so, you will have to set another fee for the other days of the week.



Note: If the entry you have chosen is for a specific week or a specific day, then you need to create another entry for the rest of the weeks of the year and days of the week. You can add multiple tariff entries for the same category in the same public place/parking lot for different days. In other words, you can have a tariff table for Saturday and Sunday which is different from that of Monday through Friday. If the system does not find an entry for the period of check-in/parking, it will let the customer check-in/park free. If you are applying the same fee for all days of the week and for all the weeks of the year, leave week as * and day as *.

Fee Slab: This is the parking fee structure in slab format, with multiple sub-slabs separated by comma(;). This has a format as follows:

<duration in minutes from the start of parking >,<fee>, <fee increase as amount per minute>, <duration from the start>,<fee>,<fee increase rate per minute>; ...

If the fee_slab is left blank, it is assumed that the access is free.

Each sub-slab is separated by a comma(;). Each sub-slab has a duration (in minutes) and a fee for that duration, and a fee rate per minute, each separated by colon (,). The fee and rate are in decimal format. The currency is what is set for each public place/parking lot.
Examples:
0,2.0,0.0;30,4.0,1.0;300,6.0,2.0
This example has three slabs. The first one is 0,2.0,0.0. That means that the fee is 2.0 if the duration is 0 minute or more (but, below the next slab), and the fee rate is 0.0. That means that the fee does not increase wuth the duration of parking within this slab. The next slab is 30,4.0,1.0. This means that if the parking duration is 30 minutes or more (below the next slab), pfee is 4.0. It also increases at the rate of 1.0 per minute within this slab. The next slab is 300,6.0,2.0. This means that if the total parking duration is 300 minutes or more, fee is 6.0, and it increases at the rate of 2.0 per minute after 300 minutes.

So, with the above slabs, if someone parks for a duration of 60 minutes, fee will be 4.0 + (60 - 30) * 1.0 = 34.00. And, if anyone parks for 600 minutes, fee will be 6.0 + (600 - 300) * 2.0 = 606.00

Another Example:
30,6.0,0
This means that parking fee is 6.0 if the parking duration is 30 minutes or more. There is no fee if parking duration is less that 30 minutes.

If this premise has multiple fee start and fee end, or multiple opening and closing hours in a day, create separate entry for ech of those. You can add multiple entries for te same day. The only condition is that fee start and fee end of one entry cannot overlap with those of the other entries.

Note: In addition to these fees, if one is interested in adding any extra fee for using any gate, that can be addedd by setting extra fee for that device. This can be set by clicking Devices Admin → Device Station Prop. Select the device and in the form that opens, set extra fee for that device. In this form, there are some additional properties also that can be set. If this device is used in public transport, one can set a station name for this device. One can also assign a Zone name and a zone value. When a user travels from one zone to another zone, the computed fee using fee slab is multiplied by the difference between the zone values to get the actual fee.

Fine Slab: 'Fine Slab' is the fine charged, if one checks-in/parks more than the maximum check-in/park duration. This slab has the same format as 'Tariff Slab'

Note: Fine is comuted starting the maiximum allowed parking time till the the time when parking ended. Fee is computed for the duration from parking start to parking end.

Start Time and End Time: The 'Start Time' and 'End Time' are the start time and end time for the fee and fine. These are in 24 hour clock in the format hh:mm. Outside this time, it is assumed that there is no fee or fine. If you want to apply the fee for the entire 24 hours of the day, leave these two fields blank. If this premise has multiple fee or slabs within a day, create more entries into this table, one for each start/End time of fee and fine. This start time and end time are applicable to both Fee_Slab and Fine_slab. It is allowed to have fine slab even when fee slab is empty, and vice versa.

Max Checkin/Park Duration: 'Max Checkin/Park Duration' is the maximum duration allowed to be checked-in/parked in minutes. By default, it is 24 hours (1440 minutes). If anyone is occupying beyond maximum duration, the check-in/parking has to be either extended (if allowed) or fine will be applied.

Min Park/Book Duration: 'Min Park/Book duration' is the minimum time in minutes that one can park or book a seat/bay in this public place/parking lot. By default, it is 30 minutes. You can change it to anything.

Open Time and Close Time: 'Open Time' and 'Close Time' are the opening and closing time of this public place/parking lot. They must be entered in 24 hour clock in a format hh:mm. Outside this time, this premise is considered as closed. If you leave the 'Open Time' and 'Close Time' blank, it is assumed that this public place/parking lot is open all day. Fee as well as fine are will be considered as 0 outside the opening and closing hours of this premise.

Checkout Extendable: 'Checkout Extendable' can be either 'EXTENDABLE' or 'NOT EXTENDABLE'. If 'NOT EXTENDABLE' nobody will be allowed in when their check-in/parking expires. They will not be able to extend their check-in/parking. Fines will be applied if anybody occupies beyond maximum check-in/park duration.

5.10  Enable/Disable Booking/Check-in/Parking in a Public Place or Parking Lot

Booking is disabled by default when a public place/parking lot is registered. You can enable booking in any public place/parking lot by clicking 'My Public Places and Parking Lots' under Public Place/Parking Lot Admin in the dashboard menu and selecting 'Allow Booking' to 'Yes'. This selection allows booking to all categories created within this public place/parking lot unless selectively disabled for each category.

However, you can selectively disable booking in any category during any specific period of the year. To do so, first click on 'My Bookings' under 'Public Place/Parking Lot Admin'. If you have registered more than one public place/parking lot, you will be prompted to select one. Once selected, you will be presented with a Table similar to Fig 153 showing all the current bookings in all categories in selected public places/parking lots.

5.11  Check Status and Use Records of Your Public Place or Parking Lots

You can check the current status of your public place/parking lots, as well as the previous check-in/parking records. On the “Public Place/Parking lots Admin” page, you will see the tabs: “Checkin/Parking Status”, “Single Bay Detail”, “Lot availability summary”, “Checkin/Parking records”. You can click on any of these to get the current status as well as previous records of your public place/parking lots. Note: “Single Bay Detail” is for those public places/parking lots where each seat/bay has a Smart device.

For administrative reasons, if the owner of the public place/parking lot finds it necessary, he can forcefully checkout a person or /unpark a vehicle that occupies in any of the public place/parking lot that he owns. To do that, click 'CheckOut/Unpark a Vehicle' in the 'Public Place/Parking Lot Admin'

The system keeps checkin/parking records only for 30 days. The owner of the Public place/parking lot can see these records by clicking 'Use/parking records' under 'Public Place/Parking Lot Admin' in the dashboard menu. These records can also be downloaded to a local computer for any future analysis. to download, click on 'Download Use/Parking records' under 'Public Place/Parking Lot Admin' in the dashboard menu. If the owner of the public place/parking lot wants to integrate downloading within any of their application programs, they can do so by writing a small segment of a program. This is explained in section 9.4 of this documentation.

5.12  Integrating this system with your own booking platform

WifiSecureAccess access control system has a booking platform of its own. Customers (public) can book any seat or bay of this public place as per the steps described in section 5.13 of this documentation. However, if you are currently using a booking platforms for the customers to book a bay or a seat in this public place or parking lot, you can continue to use that by integrating this to your booking platform. Integration is simple, if you can add an HTTPS POST call within your platform whenever customer makes a booking using your platform. That will then populate the booking information in WiFiSecureAccess system so that the customer will use that booking to checki in when he scans the QRCode or NFC tag at the door/gate. The format of the HTTPS POST call that your platform should make is as follows:

POST HTTP/1.1
Host: wifisecureaccess.com/access/lotAddBookingJson/
Content-Type: application/json
data = { "lot_owneremail": lot_owner_email, "password": lot_owner_password, "facility_name": facility_name, "customer_email": customer_email, "parking_category": access_category, "booking_start": booking_start, "Booking_end": booking_end, "vehicle_reg_no": vehicle_reg_no, "seat_bay_no": seat_bay_no, }

--where

5.13  How to create a Stripe account for Receiving Fees from customers

If you are charging fees, you have to create a an account with Stripe.com and connect that account with wifisecureaccess.com. First, login to Stripe.com and open an account. Once an account is opened, go to https://wifisecureaccess.com. Click “Public Place/Parking lots Admin” on the Dashboard. If you have registered public places or parking lots with WiFiSecureAccess and if you have not yet connected your stripe account with wifisecureaccess.com, you will see a button “Create/Connect Stripe account” at the bottom of this page as shown in Fig 155.

5.14  Monitoring and Managing Check-in and Parking by public customers

When Public places or parking lots are in the system, everyone can see a button 'My Checkin/Parking Admin' in the Dashboard. This is a link to the public (customers and Motorists who want to use these places)) to manage their checkin or parking. They can also locate a public place or parking lot in a city and to see and manage their parking. If they click on that link, they will see a page similar to Fig 156, if thee are registered public places or parking lots in the system. Or, if you have already registered a vehicle, you may see a page similart to Fig 159 below.

1. 'Show All Public Pl/Parking Lots on Map' : Click this button to see all registered public places and parking lots in the system on a Google map. They will see either a green marker or a red marker at the public places and parking lots. The marker is green if there are spaces available in that public place or parking lot and it is red when the place is full at this time. Click on this marker to see further details of this public place or parking lot. They will see a pop up window. They will see its name, available access/parking categories, available spaces in each category as well as access/parking fee in each category at this time. If the owner of the public place/parking lot has provided a link to the url of this place, they can go to their site by clicking the name of that public place or parking lot. Also, if the owner of this place has enabled booking, they will see a link to "Make a Booking'. And, if the owner has set a hold time, they will see a link to 'Hold a space'. If yes, they can click that link to hold it. Then follow the prompts. If successful, they can hold a space space in that public place or parking lot while driving to that place. Note: This feature of holding a spot is available only if the place has smart devices at every seat/bay.
2. 'My Vehicles': Clicking this link will take them to a page showing all their registered vehicles. They can add more vehicles or delete any registered vehicles on this page.
3. 'My Checkin/Parking Status': If they click this tab, it will display the checkin/parking status of their checkin status or parking status of their currently parked vehicles. If they have checked into a public place or parked a vehicle in any parking lot, this will display the duration of checkin/parking, time when it expires, access/parking charge accumulated so far, and a link to extending checkin/parking, if extension of parking is allowed by the owner of that place.
4. 'My Bookings': Clicking this tab will take them to a page showing all their current bookings. They will be able to make any modification of their booking in this page, if allowed.
5. 'Share My Vehicle': This tab helps you to share their vehicle with friends and family. If they share, those whom they share with can use this vehicle to park in any of the parking lot.
6. 'Vehicles Sharing': Clicking this tab will display all the vehicles that are shared between them and others.
7. 'My Checkin/Parking records': This tab helps them to see all their checkin/parking records in the last 30 days. The system keeps record of every public customer for 30 days, and and they can see where and when they checked in or parked, how long they parked and what access/parking fee and fine they paid in the past 30 days.

8.1  Opening/Closing a door/gate with an HTTPS POST call

To open or close a door/gate, make an HTTPS POST call with the following details:

POST HTTP/1.1
Host: wifisecureaccess.com/devicePortsJson/
Content-Type: application/json

Provide the credentials and data in the following JSON format:
data = { "email": email, "password": password, "device_name": device_name, "action": action, }

--where email and password are the email address and password of the owner of the device connected to your door/gate. device_name is the name of this device. action should be either "ON" or "OFF". If you want to open the door/gate, action must be "ON", and if you want to close it, action must be "OFF".

If a POST call is made as per that above format, the door/gate will be activated as per the action specified. Refer to the following sample python program. This sample call will open the door/gate. Edit this code and replace the device_name, email and passwords with those of yours before running this program. Also make sure that requests module is installed in python using 'pip install requests' before running this program.

#!/usr/bin/env python
import requests
import json

# This uses requests module.  So, if not already installed on your computer, install it before running this program
# pip install requests
#

def main_loop():
   url = "https://wifisecureaccess.com/access/devicePortsJson/"
   #the following are just an example.  replace these with your's.
   device_name = 'My Door'  # Replace this with the name of your device
   email = "tester@gmail.com"  # replace this with your email
   password = "12345678"      # replace this with your password
   action = "ON"  # or, action = "OFF", if you want to put OFF the port
   data = {'email': email, 'password': password, 'device_name': device_name, 'action': action,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)

   if r.status_code == requests.codes['ok']:
      res = r.json()
      if res['result'] and res['result'] == 'SUCCESS':
         print("SUCCESS")
      elif res['msg']:
         print(res['msg'])
      else:
         print("FAIL")

   else:
      print(r)
      print("Server error or communication error")

if __name__ == '__main__':
  main_loop()

8.2  HTTPS call to add or remove allowed Users

Repeating what we said in section 4-4 above ...
You can populate the allowed users of any group from any of your applications such as a booking platform using an HTTPS call. This feature helps integrate the WiFiSecureaccess door controller with your applications such as a booking platform. If these devices are installed, for example, on the door of a hotel room or an AirBnB room, the application platform that makes the booking can enter the customer's email and their start date and expiry date directly into the allowed user's list of the group associated with the controller device. If done, the customer will be allowed to open the door during the period between start-date and expiry-date. The customers can open the door either by a voice prompt, or by scanning the QRCode or NFC tag fixed on the door. Thus, this is an ideal system for hotels and AirBnB users. This eliminates the need to pass on the keys or access cards to the customer.

To add the user to the device's group, make an HTTPS POST call with the following details:

POST HTTP/1.1
Host: wifisecureaccess.com/loadAllowedUsersJson/
Content-Type: application/json
data = { "email": your_email, "password": your_password, "device_group_name": device_group_name, "customers": customers }

-where customers is a double list of customer details.
customers = [customer1, customer2, customer3, ....]
-where each customer is a list as below:
[email_address, start_date, expiry_date]

For example, if you want to add two customers to the allowed group of a device, the customers should be as follows:
customer1 = [customer1_email, customer1_start_date, customer1_expiry_date]
customer2 = [customer2_email, customer2_start_date, customer2_expiry_date]
customers = [customer1, customer2]

Note: Leave start date and expiry date as "", if there is no start date or end date for that customer. If there is no start date, that means that the customer can access immediately. If there is no expiry date, the customer is authorized forever.

Here is a sample program to add two customers as alloowed members in a device group named test_group:

#!/usr/bin/env python
import requests
import json

def main_loop():
   email = 'tester@gmail.com'  # Replace this with your email address
   password = 'password'   # Replace with your password of your account with wifisecureaccess.com
   url = "https://wifisecureaccess.com/access/loadAllowedUsersJson/"
   #customer = [[customer_email, dt_start_str, dt_exp_str[, [.....], [.....],]
   customers = [['customer1@gmail.com', '2021-09-24 10:30', '2021-09-25 10:30'], ['customer2@gmail.com', '', ''],]
   data = {'email': email, 'password': password, 'device_group_name': 'test_group', 'customers': customers,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      #print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

#!/usr/bin/env python
import requests
import json

def main_loop():
   email = 'tester@gmail.com'  # replace with your email address
   password = 'password'  # Replace this with your password of your account with wifisecureaccess.com
   url = "https://wifisecureaccess.com/access/removeAllowedUsersJson/"
   customers = ['customer1@gmail.com', 'customer2@gmail.com',]
   data = {'email': email, 'password': password, 'device_group_name': 'test_group', 'customers': customers,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      #print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

8.3  HTTPS call to add or remove customers to Special category of a Public Place or Parking Lot

Repeating what we said in section 8-5 above ...
Similar to what we have explained in section 4.4 of this documentation, you can integrate wifisecureaccess with any of your applications (such as online booking) and update the special category through an HTTPS call from that application to wifisecureaccess.com. If WiFiSecureAccess controllers are installed at the gate of parking lots to control the boom gate (or whatever door they have), the application platform that makes the booking can enter the customer's email and their start date and expiry date directly into the allowed user's list of the group associated with the controller device. If done, the customer will be allowed to enter the parking lot or public place during the period between start-date and expiry-date. The customers can open the gate by scanning the QRCode or NFC tag fixed at the gate. Thus, this is an ideal system for public places (such as cinema halls and other public event places) and parking lots. This eliminates the need to carry tickets and other documents to enter the place..

To add a customer to a special category, of a public place/parking lot, make an HTTPS POST call with the following details:

POST HTTP/1.1
Host: wifisecureaccess.com/addMembersSpCatJson/
Content-Type: application/json
data = { "email": your_email, "password": your_password, "parking_lot_name": parking_lot_name, "customers": customers }

-where customers is a double list of customer details.
customers = [customer1, customer2, customer3, ....]
-where each customer is a list as below:
[email_address, start_date, expiry_date, fee_discount, fine_discount,]

Note: Whenever we use the word 'parking lot', it also means any public access place in addition to parking lot

For example, if you want to add two customers to the allowed group of a device (controller), the customers should be as follows:
customer1 = [customer1_email, customer1_start_date, customer1_expiry_date, customer1_fee_discount, customer1_fine_discount,]
customer2 = [customer2_email, customer2_start_date, customer2_expiry_date, customer2_fee_discount, customer2_fine_discount,]
customers = [customer1, customer2]

Note: Leave start date and expiry date as "", if there is no start date or end date for that customer. If there is no start date, that means that the customer can access immediately. If there is no expiry date, the customer is authorized forever.

As mentioned before, fee_discount and fine_discount are in percentages (0.00 to 100.00)

Here is a sample python program that will populate the allowed users in Special category of a public place or parking lot: This program adds two customers (customer1@gmail.com and customer2@gmail.com to the Special category 10 of the public place/parking lot named 'MY PUBLIC PLACE',

#!/usr/bin/env python
import requests
import json

#This inserts members to special parking category

def main_loop():
   email = 'tester@gmail.com'   # Replace this with your email
   password = 'password'   # Replace this with the password of your account with wifisecureacces.com
   url = "https://wifisecureaccess.com/access/addMembersSpCatJson/"
   #customers = [[customer_email, dt_start, dt_exp_str, %fee_discount, %fine_discount], [.....], [......],]
   customers = [['customer1@gmail.com', '2021-09-25 10:30', '2021-09-27 10:30', 70.0, 50.0,], ['customer2@gmail.com', '', '', 0.0, 0.0,],]
   data = {'email': email, 'password': password, 'parking_lot_name': 'MY PUBLIC PLACE', 'parking_category': 10, 'customers': customers,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      #print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

#!/usr/bin/env python
import requests
import json

#This removes members to special parking category

def main_loop():
   email = 'tester@gmail.com'  # Replace this with your email
   password = 'password'  # Replace this with the password of your account with wifisecureaccess.com
   url = "https://wifisecureaccess.com/access/removeMembersSpCatJson/"
   customers = ['customer1@gmail.com', 'customer2@gmail.com',]
   data = {'email': email, 'password': password, 'parking_lot_name': 'MY PUBLIC PLACE', 'parking_category': 10, 'customers': customers,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      #print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

8.4  HTTPS call to add a booking in a Public Place or Parking Lot

Here is an example python code to make a booking using an HTTPS POST call:

#!/usr/bin/env python
import requests
import json

def main_loop():
   lot_owner_email = 'tester@gmail.com'   # replace this with the email of the owner of the public place/parking lot
   password = 'password'   # owner's password
   url = "https://wifisecureaccess.com/access/lotAddBookingJson/"
   facility_name = 'abcd'  # replace this with the registered name of the public place/parking lot
   customer_email = 'raman.v.nath@gmail.com'   # replace this with the email address of the customer who is making this booking
   parking_category = 'GENERAL'  #  replace this with the name of the access category that the customer is booking
   booking_start = '2022-01-12 10:30'  # replace this the start date and time
   booking_end = '2022-01-13 10:00'   # replace this with the end date and time of booking
   seat_bay_no = 'A2'  # This is optional.  If you are entering seat/bat number, replace A2 with what the customer is booking
   vehicle_reg_no = 'WAU 971'   #  This must be provided if this is a parking lot, and not a public access place. Replace WAU971 with the customer's vehic;le reg number
   data = {'lot_owner_email': lot_owner_email, 'password': password, 'facility_name': facility_name, 'customer_email': customer_email, 'parking_category': parking_category, 'booking_start': booking_start, 'booking_end': booking_end, 'vehicle_reg_no': vehicle_reg_no, 'seat_bay_no': seat_bay_no,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

8.5  HTTPS call to delete a booking in a Public Place or Parking Lot

Here is an example python code to delete a booking using an HTTPS POST call:

#!/usr/bin/env python
import requests
import json

def main_loop():
   lot_owner_email = 'tester@gmail.com'   # replace this with the email of the owner of the public place/parking lot
   password = 'password'   # owner's password
   url = "https://wifisecureaccess.com/access/lotdeleteBookingJson/"
   facility_name = 'abcd'  # replace this with the registered name of the public place/parking lot
   customer_email = 'raman.v.nath@gmail.com'   # replace this with the email address of the customer who is making this booking
   booking_start = '2022-01-12 10:30'  # replace this the start date and time
   booking_end = '2022-01-13 10:00'   # replace this with the end date and time of booking
   vehicle_reg_no = 'WAU 971'   #  This must be provided if this is a parking lot, and not a public access place. Replace WAU971 with the customer's vehic;le reg number
   data = {'lot_owner_email': lot_owner_email, 'password': password, 'facility_name': facility_name, 'customer_email': customer_email, 'parking_category': parking_category, 'booking_start': booking_start, 'booking_end': booking_end, 'vehicle_reg_no': vehicle_reg_no, 'seat_bay_no': seat_bay_no,}
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   r = requests.post(url, data=json.dumps(data), headers=headers)
   if r.status_code == requests.codes['ok']:
      res = r.json()
      print(res)
      if res['result'] and res['result'] == 'SUCCESS':
         print(res['msg'])
      else:
         print('Error_code = ', res['Error_code'], res['msg'])


if __name__ == '__main__':
    main_loop()

9.1  Copying Device Use Records

'Device Use Records' have the information of anybody's using this device. The owner of a device can see the use records in Dashboard by clicking 'Device Use Records' under 'Device Admin'. These records can also be copied at frequent intervals to your local computer. Given below is an example of a program to copy these records.

#!/usr/bin/env python
import requests
import json
import getpass
import os

def main_loop():
   while True:
      email = input("Enter email : ")
      if email and email != "":
         break
   email = email.upper()
   while True:
      password = getpass.getpass()
      if password and password != "":
         break
   while True:
      device_name = input("Device Name: ")
      if device_name and device_name != '':
         break
   if device_name.isspace():
      print("device name cannot be empty spaces")
      exit(1)
   start_date = input("Start Date (yyyy-mm-dd hh:mm): ")
   if start_date.isspace():
      start_date = ''
   end_date = input("End Date (yyyy-mm-dd hh:mm): ")
   if end_date.isspace():
      end_date = ''
   while True:
      file_name = input("File Name: ")
      if file_name and file_name != '':
         break
   if file_name.isspace():
      print("Error.  File name cannot be blank spaces")
      exit(1)

   s = requests.session()
   n_next = 0
   url = "https://wifisecureaccess.com/access/get_useRecordsJson/"
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   try:
      f = open(file_name, "a+")
   except:
      print("Unable to open the file %s" % (file_name))
      exit(1)

   while True:
            data = {'email': email, 'password': password, 'records_type': 'device', 'device_name': device_name, 'start_date': start_date, 'end_date': end_date, 'n_next': n_next,}
            r = s.post(url, data=json.dumps(data), headers=headers)
            if r.status_code == requests.codes['ok']:
               res = r.json()
               if res['result'] and res['result'] == 'SUCCESS':
                  if n_next == 0:
                     print("Field Names: ", res['field_names'])
                     if os.stat(file_name).st_size == 0:
                        field_names = res['field_names']
                        for field_name in field_names:
                           f.write(field_name)
                           f.write(", ")
                        f.write("\r\n\r\n")
                  records = res['records']
                  for record in records:
                     for value in record:
                        if not value:
                           value = ''
                        print(value, end=", ")
                        f.write(value)
                        f.write(", ")
                     print()
                     f.write("\r\n")
                  n_next = res['n_next']
                  records_remaining = res['records_remaining']
                  if records_remaining == 0:
                     break
               else:
                  if 'msg' in res:
                     msg = res['msg']
                  else:
                     msg = ""
                  print("FAIL: ", msg)
                  break
            else:
               print(r)
               print("FAIL:  Communication error")
               break
   f.close()

if __name__ == '__main__':
  main_loop()

$ python test_getDeviceUseRecords.py
Enter email : test53680@gmail.com
Password: 
Device Name: New_Device
Start Date (yyyy-mm-dd hh:mm): 2020-03-28 10:30
End Date (yyyy-mm-dd hh:mm): 2020-04-09 23:10
File Name: my_file.txt
{'result': 'SUCCESS', 'msg': 'Login Success'}
Field Names:  ['customer_email', 'use_date', 'use_time']
RAMAN.V.NATH@GMAIL.COM, 2020-04-08, 00:41, 
RAMAN.V.NATH@GMAIL.COM, 2020-04-08, 00:44, 
RAMAN.V.NATH@GMAIL.COM, 2020-04-08, 00:45, 
TEST53680@GMAIL.COM, 2020-04-08, 10:50, 
TEST53680@GMAIL.COM, 2020-04-08, 10:52, 
TEST53680@GMAIL.COM, 2020-04-08, 10:52, 
TEST53680@GMAIL.COM, 2020-04-08, 10:52, 
TEST53680@GMAIL.COM, 2020-04-08, 10:52, 
TEST53680@GMAIL.COM, 2020-04-08, 10:52, 

9.2  Copying Group Use Records

Group records is the use records of a group, showing who used the devices in this group and when. These records can be seen on the dashboard by clicking 'Group Records' under Device Groups in Dashboard. To copy the same records into your computer, you need a program to make calls to the IOT server. Given below is a program to do that.

#!/usr/bin/env python
import requests
import json
import getpass
import os

def main_loop():
   while True:
      email = input("Enter email : ")
      if email and email != "":
         break
   email = email.upper()
   while True:
      password = getpass.getpass()
      if password and password != "":
         break
   while True:
      group_name = input("Group Name: ")
      if group_name and group_name != '':
         break
   if group_name.isspace():
      print("group name cannot be blank spaces")
      exit(1)
   start_date = input("Start Date (yyyy-mm-dd hh:mm): ")
   if start_date.isspace():
      start_date = ''
   end_date = input("End Date (yyyy-mm-dd hh:mm): ")
   if end_date.isspace():
      end_date = ''
   while True:
      file_name = input("File Name: ")
      if file_name and file_name != '':
         break
   if file_name.isspace():
      print("Error.  File name cannot be blank spaces")
      exit(1)

   s = requests.session()
   n_next = 0
   url = "https://wifisecureaccess.com/access/get_useRecordsJson/"
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   try:
      f = open(file_name, "a+")
   except:
      print("Unable to open the file %s" % (file_name))
      exit(1)

   while True:
            data = {'email': email, 'password': password, 'records_type': 'group', 'group_name': group_name, 'start_date': start_date, 'end_date': end_date, 'n_next': n_next,}
            r = s.post(url, data=json.dumps(data), headers=headers)
            if r.status_code == requests.codes['ok']:
               res = r.json()
               if res['result'] and res['result'] == 'SUCCESS':
                  if n_next == 0:
                     print("Field Names: ", res['field_names'])
                     if os.stat(file_name).st_size == 0:
                        field_names = res['field_names']
                        for field_name in field_names:
                           f.write(field_name)
                           f.write(", ")
                        f.write("\r\n\r\n")
                  records = res['records']
                  for record in records:
                     for value in record:
                        if not value:
                           value = ''
                        print(value, end=', ')
                        f.write(value)
                        f.write(", ")
                     print()
                     f.write("\r\n")
                  n_next = res['n_next']
                  records_remaining = res['records_remaining']
                  if records_remaining == 0:
                     break
               else:
                  if 'msg' in res:
                     msg = res['msg']
                  else:
                     msg = ""
                  print("FAIL: ", msg)
                  break
            else:
               print(r)
               print("FAIL:  Communication error")
               break
   f.close()

if __name__ == '__main__':
  main_loop()

$ python test_get_groupUseRecords.py
Enter email : test53680@gmail.com
Password: 
Group Name: My House
Start Date (yyyy-mm-dd hh:mm): 2020-03-10 0:0
End Date (yyyy-mm-dd hh:mm): 2020-04-11 0:0
File Name: my_file.txt
{'result': 'SUCCESS', 'msg': 'Login Success'}
Field Names:  ['device_name', 'device_use_type', 'customer_email', 'use_date', 'use_time']
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-07, 08:01, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-07, 07:59, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-07, 07:59, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:10, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:10, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:09, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:09, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:08, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:08, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:06, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:06, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:06, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:06, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:04, 
New_Device, CONTROL/SENSOR, TEST53680@GMAIL.COM, 2020-04-06, 23:00, 

9.3  Copying Customer Use Records

Customer use records are the records of a customer's use of all the devices in the system. You can see your use records of any devices in the system in Dashboard by clicking 'My Use Records' under 'User Admin' in Dashboard. If you want the same records copied into your local computer to keep the data for longer time, or to do detailed data analysis for your special needs, you need a program to make calls to the server. Given below is a program in python to get these records from the server.

#!/usr/bin/env python
import requests
import json
import getpass
import os

def main_loop():
   while True:
      email = input("Enter email : ")
      if email and email != "":
         break
   email = email.upper()
   while True:
      password = getpass.getpass()
      if password and password != "":
         break
   start_date = input("Start Date (yyyy-mm-dd hh:mm): ")
   if start_date.isspace():
      start_date = ''
   end_date = input("End Date (yyyy-mm-dd hh:mm): ")
   if end_date.isspace():
      end_date = ''
   while True:
      file_name = input("File Name: ")
      if file_name and file_name != '':
         break
   if file_name.isspace():
      print("Error.  File name cannot be blank spaces")
      exit(1)

   s = requests.session()
   n_next = 0
   url = "https://wifisecureaccess.com/access/get_useRecordsJson/"
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   try:
      f = open(file_name, "a+")
   except:
      print("Unable to open the file %s" % (file_name))
      exit(1)

   while True:
            data = {'email': email, 'password': password, 'records_type': 'customer', 'start_date': start_date, 'end_date': end_date, 'n_next': n_next,}
            r = s.post(url, data=json.dumps(data), headers=headers)
            if r.status_code == requests.codes['ok']:
               res = r.json()
               if res['result'] and res['result'] == 'SUCCESS':
                  if n_next == 0:
                     print("Field Names: ", res['field_names'])
                     if os.stat(file_name).st_size == 0:
                        field_names = res['field_names']
                        for field_name in field_names:
                           f.write(field_name)
                           f.write(", ")
                        f.write("\r\n\r\n")
                  records = res['records']
                  for record in records:
                     for value in record:
                        if not value:
                           value = ''
                        print(value, end=", ")
                        f.write(value)
                        f.write(", ")
                     print()
                     f.write("\r\n")
                  n_next = res['n_next']
                  records_remaining = res['records_remaining']
                  if records_remaining == 0:
                     break
               else:
                  if 'msg' in res:
                     msg = res['msg']
                  else:
                     msg = ""
                  print("FAIL: ", msg)
                  break
            else:
               print(r)
               print("FAIL:  Communication error")
               break
   f.close()

if __name__ == '__main__':
  main_loop()

$ python test_getCustomerUseRecords.py
Enter email : test53680@gmail.com
Password: 
User Timezone (example: Australia/Sydney) deault: UTC
(Refer https://en.wikipedia.org/wiki/List_of_tz_database_time_zones): US/Pacific
Start Date (yyyy-mm-dd hh:mm): 2020-04-08 08:21
End Date (yyyy-mm-dd hh:mm): 2020-04-08 10:53
File Name: my_file.txt
{'result': 'SUCCESS', 'msg': 'Login Success'}
Field Names:  ['device_name', 'device_use_type', 'group_name', 'use_date', 'use_time']
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device_H1.2, CONTROL/SENSOR, None, 2020-04-08, 10:52, 
New_Device_H1.2, CONTROL/SENSOR, None, 2020-04-08, 10:51, 
New_Device_H1.2, CONTROL/SENSOR, None, 2020-04-08, 10:51, 
New_Device_H1.2, CONTROL/SENSOR, None, 2020-04-08, 10:51, 
D8BFC0F2D182, CONTROL/SENSOR, None, 2020-04-08, 10:50, 
A020A62FC8BD, CONTROL/SENSOR, None, 2020-04-08, 08:21, 

9.4  Copying Parking Records

If you own any parking lot, parking records of your parking lot can be copied to your local computer using a program. The following is a program in python to read parking records of any parking lot that you own.

#!/usr/bin/env python
import requests
import json
import getpass
import os

def main_loop():
   while True:
      email = input("Enter email : ")
      if email and email != "":
         break
   email = email.upper()
   while True:
      password = getpass.getpass()
      if password and password != "":
         break
   while True:
      parking_lot_name = input("Parking Lot Name: ")
      if parking_lot_name and parking_lot_name != '':
         break
   if parking_lot_name.isspace():
      print("parking lot name cannot be blank spaces")
      exit(1)
   start_date = input("Start Date (yyyy-mm-dd hh:mm): ")
   if start_date.isspace():
      start_date = ''
   end_date = input("End Date (yyyy-mm-dd hh:mm): ")
   if end_date.isspace():
      end_date = ''
   while True:
      file_name = input("File Name: ")
      if file_name and file_name != '':
         break
   if file_name.isspace():
      print("Error.  File name cannot be blank spaces")
      exit(1)

   s = requests.session()
   n_next = 0
   url = "https://wifisecureaccess.com/access/get_parkingRecordsJson/"
   headers = {'Content-Type': 'application/json', 'Accept': 'application/json',}
   try:
      f = open(file_name, "a+")
   except:
      print("Unable to open the file %s" % (file_name))
      exit(1)

   while True:
            data = {'email': email, 'password': password, 'records_type': 'parking_lot', 'parking_lot_name': parking_lot_name, 'start_date': start_date, 'end_date': end_date, 'n_next': n_next,}
            r = s.post(url, data=json.dumps(data), headers=headers)
            if r.status_code == requests.codes['ok']:
               res = r.json()
               if res['result'] and res['result'] == 'SUCCESS':
                  if n_next == 0:
                     print("Field Names: ", res['field_names'])
                     if os.stat(file_name).st_size == 0:
                        field_names = res['field_names']
                        for field_name in field_names:
                           f.write(field_name)
                           f.write(", ")
                        f.write("\r\n\r\n")
                  records = res['records']
                  for record in records:
                     for value in record:
                        if not value:
                           value = ''
                        print(value, end=", ")
                        f.write(value)
                        f.write(", ")
                     print()
                     f.write("\r\n")
                  n_next = res['n_next']
                  records_remaining = res['records_remaining']
                  if records_remaining == 0:
                     break
               else:
                  if 'msg' in res:
                     msg = res['msg']
                  else:
                     msg = ""
                  print("FAIL: ", msg)
                  break
            else:
               print(r)
               print("Fail")
               break

   f.close()

if __name__ == '__main__':
  main_loop()

$ python test_getLotParkingRecords.py
Enter email : test53680@gmail.com
Password:
Parking Lot Name: PARKING_LOT28265
Start Date (yyyy-mm-dd hh:mm): 2020-03-30 10:00
End Date (yyyy-mm-dd hh:mm): 2020-04-10 23:00
File Name: my_file.txt
{'result': 'SUCCESS', 'msg': 'Login Success'}
Field Names:  ['vehicle_reg_no', 'bay_no', 'entry_device_name', 'exit_device_name', 'parked_device_name', 'entry_station_name', 'exit_station_name', 'customer_email', 'parking_category', 'amount_charged', 'currency', 'Charge_id', 'park_start_date', 'park_start_time', 'park_end_date', 'park_end_time', 'Duration)Min)']
WAU 971, A1 , Entry Gate, Entry Gate, , Entry Gate, Entry Gate, TEST53680@GMAIL.COM, GENERAL, GENERAL, 0.00, AUD, , 2022-08-08, 14:44, 2022-08-08, 14:45, 1,
WAU 971, A1, Entry Gate, Entry Gate, , Entry Gate, Entry Gate,  TEST53680@GMAIL.COM, GENERAL, GENERAL, 0.00, AUD, , 2022-08-08, 14:46, 2022-08-08, 14:46, 20,
WAU 971, , , , , Entry Gate, Exit Gate, TEST53680GMAIL.COM, GENERAL, 0.00, AUD, , 2022-08-08, 10:49, 2022-08-08, 10:50, 30,