Generate Configuration Code
Getting Started
Configuration codes require TabSINT version 3.0 or higher
A QR Code is useful for normalizing settings in TabSINT among multiple devices. It also allows one to quickly change from one TabSINT configuration to the next. This process saves time, is easy to implement and can ensure each tablet is running TabSINT with the same configuration and protocol, which is often important in clinical studies.
A personal QR Code can be generated by setting the parameters in a 'tabsintConfig.json' using the text box provided at the bottom of this page or via the Admin View in TabSINT. This module will explain how to:
- Generate a QR Code via the TabSINT admin page
- Generate a QR Code with tabsintConfig.json
Generate a QR Code using TabSINT
Set Up tab
In Admin View on the Set Up tab, configure the tablet. All highlighted options shown below can be independently configured and will be saved when generating the QR Code.

Protocols tab
In Admin View on the Protocols tab, set the "Server." Setting the server and inputting the correct repositories and passwords will automatically load the selected protocol. Doing this also exposes passwords to any person who scans this QR Code. Use appropriate methods to ensure privacy and confidentiality for any QR Codes generated with this information.
- TabSINT Server - Input highlighted regions as shown below

- GitLab - Input highlighted regions as shown below

- Device Storage
Selecting "Device Storage" lets you choose a local directory to load the protocol from. You can either enter the name of the directory in which your protocol.json
file is located (relative to the Device storage/tabsint-protocols
directory), or if the Directory
textbox is left empty, select the + Add
button to manually navigate to the directory. The desired protocol would need to have been previously loaded onto the tablet via USB in order to load a protocol in this way.

Once a tablet is configured in TabSINT with the desired settings a QR Code can be generated directly on that tablet.
In Admin View go to the Set Up tab. In the Preferences module, select Generate
and the QR Code will be created.

This QR Code can now be scanned directly by a second tablet. On the second tablet, either from the home screen or by selecting the menu in the upper right corner of the Admin View, select Scan Configuration

This QR Code is also saved as a .png image and can be accessed in the tablets device storage.

Generate a QR Code with tabsintConfig.json
All fields that could be configured using TabSINT as outlined in the previous section, can also be configured by creating a tabsintConfig.json and generating the QR code at the bottom of this page.
For a full list these parameters and their appropriate naming see the Configuration Schema
For all parameters not set, the default setting will be implemented. The defaults settings are noted in the Configuration Schema. For example below, the default server is set to gitlab
, with tabsintServer
and localServer
being the other options.

Examples of tabsintConfig.json
- The below example changes the Admin settings accordingly: the default headset to WAHTS; disables logs; unchecks Admin mode; and requires results to be encrypted. All other parameters will be the default settings.
{
"adminSettings": {
"defaultHeadset": "WAHTS",
"disableLogs": true,
"adminMode": false,
"requireEncryptedResults": true
}
}
- The below example changes the server to the "TabSINT server" and provides credentials to load and set the protocol to demo-audiometry. All other parameters will be the default settings.
{
"server": "tabsintServer",
"tabsintServer":{
"site": "demo-audiometry",
"username": "amv",
"password": "abcd1234"
}
}
- The below example sets the server to GitLab and provides credentials to the "creare-com/tabsint-protocols" group. It sets the repository to "sandbox" and loads the sandbox protocol onto the tablet. Admin settings are set to: Default headset WAHTS; Results to Upload Only; Record the test location; and requires results to be encrypted. All other parameters will be the default settings.
{
"description": "example 1",
"server": "gitlab",
"gitlab": {
"site": "https://gitlab.com/",
"group": "creare-com/tabsint-protocols/",
"repository": "sandbox"
},
"adminSettings": {
"defaultHeadset": "WAHTS",
"resultsMode": "Upload Only",
"recordTestLocation": true,
"requireEncryptedResults": true
}
}
Once the tabsintConfig.json has be created with the desired parameters, paste the contents of the .json into the below text box and press Generate.
Right click on one of the generated codes to save or copy the code for future use. Scan one of the generated codes into TabSINT (via the Welcome Screen or the Menu at the top right hand corner of TabSINT) to automatically configure TabSINT admin settings.
Generate PDF417 Generate QRCode Clear