{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Uploading Device Data","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"uploading-device-data","__idx":0},"children":["Uploading Device Data"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choosing-a-client-name","__idx":1},"children":["Choosing A Client Name"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will need to choose a \"client name\" for your app. A \"client name\" is used to identify data in the Tidepool Platform that your app has created."," ","We recommend using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/Reverse_domain_name_notation"},"children":["reverse DNS notation"]}," to identify your app/service. For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["com.mycompany.TidepoolUploader"]}," (company)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["com.github.pazaan.600SeriesAndroidUploader"]}," (personal project)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your client will also need to provide a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://semver.org/"},"children":["Semantic Version"]}," to identify which version of your app/service is uploading data."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"data-upload-session-types","__idx":2},"children":["Data Upload Session Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform has two data upload modes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/quick-start/uploading-device-data/normal"},"children":["Normal"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/quick-start/uploading-device-data/continuous"},"children":["Continuous"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will need to determine which mode is the best to use for your upload implementation."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"normal-upload-sessions--normal-","__idx":3},"children":["Normal Upload Sessions (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["normal"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A normal upload session is used for \"bulk\" uploads."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example of this is the Tidepool Uploader: When you use Tidepool Uploader, you are connecting a device to your computer, and using the Tidepool Uploader to read a large set of historical data from the device. Tidepool Uploader will create a normal upload session, and close that session when all data for that diabetes device has been uploaded."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Subsequent uploads for the same device will create a ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["new"]}," normal upload session, and this data will be deduplicated against any previous sessions."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"continuous-upload-sessions--continuous-","__idx":4},"children":["Continuous Upload Sessions (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["continuous"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A continuous upload session is used for devices that have the ability to connect to the internet (either directly or via a tethered device), and frequently upload data to the Tidepool platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example of this is Tidepool Mobile, which uploads updates from the Dexcom or Loop apps (via HealthKit) every 5 minutes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You are still able to use a continuous upload session to upload a large amount of historical data."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"upload-deduplicators","__idx":5},"children":["Upload Deduplicators"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["TODO: Section on deduplicators goes here."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"keep-reading","__idx":6},"children":["Keep Reading"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/quick-start/uploading-device-data/continuous"},"children":["Using A Continuous Upload Session"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/quick-start/uploading-device-data/normal"},"children":["Using A Normal Upload Session"]}]}]}]},"headings":[{"value":"Uploading Device Data","id":"uploading-device-data","depth":1},{"value":"Choosing A Client Name","id":"choosing-a-client-name","depth":2},{"value":"Data Upload Session Types","id":"data-upload-session-types","depth":2},{"value":"Normal Upload Sessions ( normal )","id":"normal-upload-sessions--normal-","depth":3},{"value":"Continuous Upload Sessions ( continuous )","id":"continuous-upload-sessions--continuous-","depth":3},{"value":"Upload Deduplicators","id":"upload-deduplicators","depth":2},{"value":"Keep Reading","id":"keep-reading","depth":2}],"frontmatter":{"seo":{"title":"Uploading Device Data"}},"lastModified":"2025-09-04T14:19:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/quick-start/uploading-device-data","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}