Kassie2

The DIESELLOGGER is a electronic device to control and measure the diesel payout of diesel storage tanks. The device is used in conjunction with an Andriod Application which make it ideal for the record keeping on a farm to do costing and claiming diesel rebates. The diesel storage tank is normally locked and opened only by the Andriod App if all the required fields are entered. The Andriod App will by default store and upload all transactions. The filling data is also recorded on the device itself but as a backup, Data logged by the device can optionally be automatically uploaded via wifi to the cloud database or it can be transferred on request. The device itself can stores up to 1024 transactions, after which the oldest data will be overwritten. Data from device is uploaded to a MySQL database on the cloud which can be accessed by a standalone desktop computer program. Filling and costing data captured by the mobile are finally processed by the Desktop Software called ORANJE BOER..(Farm Costing Software).

The Capacity of storage tanks and diesel plants can be entered. The fill quantity can be restricted by the capacity depending on setup.

Components of the Total Product
(1). DieselLogger Hardware/Firmware
(2). DieselLogger Andriod App
(3). ORANJE BOER Desktop Program
(4). MySQL Database
(5). Cloud Data Folder for Text files

Required Data Fields
The following field must be captured by the mobile app before the diesel tank will unlock :
(1). Mobile User
(2). Storage Tank Number or Name
(3). Date and Time
(4). Vehicle/Tractor/Truck ID
(5). Km or Hour Reading
(6). Costing Centre

DieselLogger Device Functions
(1). Log Storage Tank fill
(2). Log and measureVehicle/Tractor fuelups
(3). Determine Storage Tank Level
(4). Upload transactions
(5). Control Fuel line lock
(6). Provide Transaction Date Time
(7). Upload/Download Setup
(8). View Transactions

Operators - Usernames and Passwords
Each person operating the DieselLogger or Andriod App must have an unique username linked to a mobile. Example : Koos072353. The number of the digits should be enough to identify the mobile.If Koos also using a second mobile, he should have a second username, example : Koos072311.
Each person must have an unique password, and will login to the mobile using only his secret password. Koos may use the same password on both mobiles in the examples above.
The username will be logged with each transaction, never the password. To ensure reliable tracking of who opens the lock, the password must never be shared with anyone else,

Admin Users versus Normal Users versus Main Users
Admin users have the authority to setup the whole system and to enrol normal users.
Normal users can only fill up storage dieseltanks or fuelup dieselplants and upload data, but are not allowed to add tractors/vehicles or to do any changes to the setup of the system.
The Main User will be the user who registered the mobile initially.
Reregistration will delete previous main user but will keep the other users.

DieselLogger Andriod App : Setup Procedures
(1) App Download
The company will provide the link to download the software. An email address will be required whereto logged data will be sent to.Two authorization codes will be issued, one to register the mobile software for ADMIN users and the other one to register mobile for NORMAL users. The company will also allocate cloud space for user uploads and downloads.
(2) Installation and Registration as Admin User.
(3) General Setup - wifi + auto upload + date/time
Discuss Port Forwarding
Discuss Static IP setup
(4) Device Setup : Adding/Deleting DieselStorage Tanks
(5) Device Setup:: Adding/Deleting DieselPlants
(6) Device Setup : Adding/Deleting Costing Centers
(7) Upload/Download Device Setup by Admin
The mobile must be connected to the internet.
The following codes will be uploaded : DieselPlants,StorageTanks, Costing Accounts and Users. The codes can be downloaded by other user mobiles eliminating the need to make a setup on each mobile. No need to upload Wifi Setup, as it is only required to setup it once.Application will terminate after downloading of codes and users. Reopen App to login a new user.
(8) Adding/Deleting users to shared mobile
(9) Installation and Registration as Normal User
(10) Opening and Closing the Software
Users will be prompt for their password before the software can be used. After opening, the main menu will appear with the EXIT button at the bottom. Scroll down If you can't see the EXIT button.
(10) Download of Device Setup by users

Calibration Example
1. Make sure the PPL = P has been set to spec.
2. Fill up a known amount of N liters.
3. Take the actual reading = X.
4. New PPL := X.P/N
5. Round off to a whole integer number.

Procedure Storage Tank Fill
The mobile must be connected to the private wifi of the DieselLogger device.
Only whole number of liters are excepted.

Procedure Plant Fuelup
The mobile must be connected to the private wifi of the DieselLogger device.

Upload/Download Data
(a). Mobile Upload
(b). Device backup data - Request upload
(c) Oranje Boer Upload / Download

POWER ON will clear request to upload data.
POWER ON button depressed will clear any data to upload.

ORANJE BOER Desktop Program
(1). Installation

DieselLogger LEDs
There are four LEDs :
Blue : Indicates cooling is between the temperature limits
Green : Device is busy reading, saving or uploading data
Orange : Indicated the SETUP MODE has been entered.
Red : Indicates a temperature alarm condition.
The device continually indicates the status as it runs through the read,upload,save,setup and wait conditions.

Registering the App Online:
1. Run the app, click on Register
2. Read and Accept the Terms&Conditions (can be viewed)
3. Click on DOWNLOAD REGISTRATION
4. Wait for message "Download Complete!", then click OK.
5. Enter the code received from our office : +27 219138091
Company Name is required.
6. Click on Register, wait for message "Successful", then Exit

TIMER SETUP - Kassie2Mobile App
Select the correct Date and Time to adjust the Date and Time of the device, then select one of five possible temperature reading frequencies (every 15min, 30min,1hr,3hr,6hr)
Click on UPDATE UNIT. The KASSIE2 Device will respond immediately by displaying the date/time sent on the LCD Display.
Click CLOSE on the app to select the next SETUP item.

WIFI SETUP - Kassie2Mobile App
Select WIFI SETUP and enter the credentials of your Wifi access.
The fields must be entered one by one. After each field, click the RED UP ARROW next to the field to UPLOAD. The KASSIE2 device will then respond on the LCD Display with the value of the field sent.
(a). SSID & Password is required to access the internet on site.
(b). DUMP COMMAND - provided by PEETLAB. The command to dump temperature recordings saved by KASSIE2. It will upload to a seperate database on the webserver. Up to a 1000 readings (the latest values) are stored on the device itself.
(c). UPLOAD COMMAND - provided by PEETLAB. The command to upload actual values periodically on the website. The period is set in the TIMER SETUP menu = Temperature Reading Frequency.
(d). Check the UNIT SETUP COMPLETED field if you are finish with to total setup. By "checking" this field, the KASSIE2 device will not go automatically into the SETUP MODE after startup, it will instead link up to the internet and start uploading temperatures.
(e). Click CLOSE to exit the WIFI SETUP.

CLOSING THE KASSIE2MOBILE APP
To finish the setup, click on DISCONNECT to leave the SETUP MODE and break the WIFI connection between the MobileApp and the KASSIE2 device, which is only required during setup.

ENTER SETUP MODE AFTER THE INITIAL SETUP
To add/delete probes at a later stage, device must be switched off, wait for 10 seconds, switch on again. Wait for the setup mode message to appear and press and hold both buttons for at least 3 seconds. The device will go into the SETUP MODE

MOBILE APP REPORT
Wherever Internet connectivity is available, temperatures with datetime stamp per station can be viewed. The number of mobile installations for interested parties is not limited.

DESKTOP APP
The Desktop application for KASSIE2 allows you to delete or export the records and view it in graphical format. Two sets of data are available form the app, the normal sequential uploads and the records that were dumped through the KASSIE2 menu. The DUMPED records are temperature data that is stored on the device itself between the normal uploads.