Skip to content
This repository has been archived by the owner on Dec 18, 2019. It is now read-only.
Eric Beug edited this page Apr 11, 2017 · 1 revision

FAQ

Will Divertsy work on an iPad

No. Divertsy is Android only for now. We are not aware of an easy way to connect 3rd party USB devices, such as the scale, to an iPad without going through Apple's MFI program.

Will Divertsy work with scales other than Dymo

In theory, yes. However, we are not currently aware of other scale brands in this price range that share their data over USB. If you have another brand and are looking to integrate it with Divertsy, view the setupScaleDataListener method in the UsbScaleManager class. The Dymo scales are a Low-Speed USB HID device which sends 6 bytes of data to indicate the weight and settings. Other brands will likely send their data in a different format and will need the code updated to handle this.

We always weight our items in a bin. Can that weight be subtracted from the total?

Yes. In the General settings of the Divertsy application is a setting for "Bin Weight". Make sure to set the amount you want subtracted and move the slider to "Use Bin Weight". Note, there is not setting for LBS or KG for the bin weight. You will need to ensure your scale does not change its measurement units while using the bin weight option or the data recorded will be incorrect.

Can Divertsy work offline without an Internet connection

Yes, for the Divertsy client. Data on each client is recorded locally and multiple data points can be collected prior to syncing. Syncing is done either manually through the share options in Divertsy or through a 3rd party sync client using its schedule/settings. We recommend using the FolderSync application which supports a number of sync services and controls over syncing options. If you use the built in Google Drive feature, data will be saved locally while offline, but then synced when an connection can be found.

What Android permissions are needed by the Divertsy client

Divertsy uses writing to External Storage in order to save its data in a location that can be accessed by 3rd party apps (such as sync services). USB Permission is required to read the scale data while Wake Lock and Key Guard permissions help to keep the tablet awake as data is being read. Optionally, Bluetooth permission can be granted to scan for location beacons. Bluetooth is disabled by default and can be enabled in the Divertsy settings.

What Bluetooth beacons are supported?

Divertsy looks for bluetooth beacons which use the Eddystone URL format. The BLEScanner class can be configured to look for specific host names in the URL and will only attempt to parse those beacons. By default, the hostname is "HAX" and the remaining URL is parsed for location data. For example a beacon received with "http://HAX/F4/Kitchen" would record that the data was collected from the "Kitchen" area of the "4th Floor". Additional location beacons can be deployed without needed to change the application, however, if you would like to use a different hostname or URL parsing, you will need to recompile the Divertsy client application.

Are remote updates supported?

Yes, however they do not go through the Play Store or other market places. The update is triggered by pushing a new version of the application to the "/sdcard/Divertsy/" folder on the tablet with a file name "Divertsy######.apk" where "######" is a version number greater than the current version of the application. The current Divertsy version number can be seen at the top of the screen when the application runs. By default, this will be the date (Year, Month, Date) which the client code was compiled. The user will be prompted to install the new update when Divertsy restarts and will require that the package is signed with the same key as the currently installed Divertsy application, and that the permission to install from unknown locations is also enabled in the Android tablet settings.

You may want to use the FolderSync application to allow you to sync out application updates to this folder. The choice of user setting in Divertsy should be maintained between upgrades unless a different signing key is used.

Can I setup our own default list of office names?

Yes it can be by recompiling the Divertsy client code. Edit the [divertsy_default_strings.xml] (divertsy_client/src/main/res/values/divertsy_default_strings.xml) file and follow the example for the "pref_offices" string-array.

Can I change which default waste streams are selected?

Yes. On each client, you can select which waste streams buttons to show by selecting them in the "Set Waste Streams" option in the "Location" settings. The default choices and button colors can be changed by recompiling the Divertsy client code. Edit the [raw/waste_streams.json] (divertsy_client/src/main/res/raw/waste_streams.json) file to add or change waste stream buttons.

What languages are supported?

Currently, the default waste stream buttons are translated into English, Spanish, French, and German. You can set the language for the buttons in Divertsy's settings, then "Location", then "Language (for buttons)". These translations are stored in the [raw/waste_streams.json] (divertsy_client/src/main/res/raw/waste_streams.json) file. Data is still recorded with English names for the waste streams since this is needed for processing.

The application will show error messages in the default lanuage set for the Android tablet (under Android's "settings" then "language" option). Currently, these are in English, French, and German. However, some settings and messages are currently only in English. To add additional languages and translations, see the [strings.xml] (divertsy_client/src/main/res/values/strings.xml) files in the client source code.

Can data be saved to a different location than the "/sdcard/"

Yes, if you recompile the application. This can be changed in the source code in the Utils class. Look for the LOG_BASE_DIR and LOG_FILENAME variables.

Which IDE is used for developing the Divertsy client

Android Studio has been used for developing the Divertsy client. Use the "Import Project" settings to load the client code and build your own version.

Can data be sent from other applications?

Yes. Divertsy includes a BroadcastReceiver which will look for weight data being sent from other applications on the device. It will still require a user to choose a waste stream in the Divertsy application. Below is an example of how to send the broadcast message to Divertsy.

Intent sendIntent = new Intent();
sendIntent.setAction("com.divertsy.REMOTE_SCALE_WEIGHT");
sendIntent.putExtra("floatScaleWeight", fScaleWeightValue);
sendIntent.putExtra("stringScaleUnit", "KG");
sendBroadcast(sendIntent);

Will Divertsy work with the DYMO S25 scale?

Sort of. There is code to support the Dymo S25 scale in the Divertsy client (data is recorded in grams or ounces), however, we have seen issues with successfully using some S25 scales. While the scale will turn on with USB power and even show a proper USB endpoint, it doesn't always send readable data to the tablet. We have had success with newly purchased S25 scales, so this may just be an issue with some older scales.