This is an Android app for the IoT 2018/2019 course final project and it is based on Firebase and Nucleo-64 STM32F401 board + X-NUCLEO-IDW01M1 expansion board. The idea is to make it easier to find a public and secure place where you can leave your belongings in order to go running in total freedom and also to find other people near you with your same interests.
In order to install FitBox on your android smartphone you can simply install the .apk file placed in our git repository. During the installation you would be asked from the Google Play Protect service if you want to continue with the installation (this is because our application is not published on the Play Store).
The architecture of our system is the following:
The schema is composed only by the Nucleo board + the Wi-Fi expansion board ontop and a simple servo:
In order to access our application,you can use your Facebook profile or you can create a new profile that will be stored in our database on Firebase:
If you want to create a new account on our application, you can click on the SIGNUP button and you will be redirected to the following page:
If you already have an account you can log in by pressing on the LOGIN button in the splash screen; in this case you will be redirected to the following page:
If you don't have bookings your home screen will be like the following:
otherwise it will be like the following:
In order to book a locker you can click on the third icon of the bottom navigation bar and you will be redirected to the following page:
and now you need to select a park where you want to go. Once selected the park (clicking on the name) you will be shown a page containing a map with a marker on the park entrance. To select the day and time of the running you can press the button SELECT HOUR. You will be redirected to the following page:
Now you have two possibilities:
- Select a friend from those shown in the list (in this case your running will be the same day and at the same time as your friend's)
- Click on the BOOK button an select a new day and a new hour In the second case you will be shown the following page:
Whatever your previous choice was, in order to book a locker you will be redirected to the following page:
Now you can select a locker (obviously red lockers are the ones that are not available). Once selected the locker you will be redirected to the home page and your new booking will be displayed.
In order to manage your locker (so open/close and leave it) in the home page you can click on the booking you are interested in managing. You will be redirected to the following page:
Now if you want to open/close the locker you must authenticate you with your fingerprint. If you want to leave your locker you must click on the LEAVE LOCKER button. If you leave your locker, your booking will become disabled. If you click on the DELETE BOOKING button your booking will be deleted. Once you leave the locker the corresponding booking will be displayed in the profile page.
If you click on the second icon (Account) of the navigation bar, the following page will be displayed:
If you click on one of the displayed bookings you will see the following details:
In order to open and close the locker, it needs for a board an hardware architecture that permits a servo to move (that represents the lock of the locker). So it needs for a Nucleo STM32F401 board, on which to install a X-NUCLEO-IDW01M that is an Wi-Fi expansion board and finally the servo. In order to make all this components working, it needs for an application that manages them.
First of all you have to add your Wi-Fi credential in mbed_app.json <JSON file. There is two fields you have to modify, as follows:
{
"config": {
"wifi-ssid": {
"help": "WiFi SSID",
"value": "\"PUT_YOUR_SSID\""
},
"wifi-password": {
"help": "WiFi Password",
"value": "\"PUT_YOUR_PASSWORD\""
}
//...
}You have to put the link to your Firebase DB JSON Document that contain the open_door value of the locker in which you have to put the servo with the board:
HttpsRequest* request = new HttpsRequest(wifimodule, SSL_CA_PEM, HTTP_GET, "PUT YOUR FIREBASE DATABASE LINK");It is important that the file you get from the previous instruction has a field called open, with a Boolean subfield called boolean value as follows (this is an example):
{
"name": "YOUR_LINK",
"fields": {
"available": {
"booleanValue": false
},
"user": {
"stringValue": "Gianmarco Cariggi"
},
"open": {
"booleanValue": false
},
"lockName": {
"stringValue": "Locker1"
}
},
"createTime": "2019-06-04T14:44:55.338801Z",
"updateTime": "2019-06-08T09:17:08.841023Z"
}In this way the getLockerState() function can recognize the value of the locker and compare with its local variable of the servo.
Since the previous instruction (STEP 3) is an HTTPS request, it needs to put also the public key of CA authority because mbedOS doesn't have it. In the code there is a public key of Google Trust Services that is needed for Firebase DB, the key is valid in June 2019, but it can't be valid in the future. If it's not working, you have to modify this variable, adding the public key in PEM format:
static const char SSL_CA_PEM[]="-----BEGIN CERTIFICATE-----\n"
//...
"-----END CERTIFICATE-----"At this point, it remains to download the needed libraries through the link contained in the .lib files. After you do this, you have to compile the source code using an ARM compiler as ggc ARM. In our case we used the free web IDE mbed compiler here. You obtain the bin file which you have to copy inside the Nucleo board, using a serial terminal (at 9600 baud), you can see all the information messages.
- Implement a wearOS application in order to lock and unlock the locker with the smartwatch: in this way you will be able to leave also your smartphone into the locker
- Add a backup battery management system, a NFC reader and implement a push notification system that can inform the users about events that could occur to the locker (for example an electricity failure)
- Gianluca Capozzi
- Gianmarco Cariggi
- Gianluca Galli
Code is under MIT License