Bridgetek LDSBus BRT AN 080 User manual

Use of Bridgetek devices in life support and/or safety applications is entirely at the user’s risk, and
the user agrees to defend, indemnify and hold Bridgetek harmless from any and all damages,
claims, suits or expense resulting from such use.
Bridgetek Pte Ltd (BRTChip)
178 Paya Lebar Road, #07-03 Singapore 409030
Tel: [phone] Fax: [phone]
Web Site: http://brtchip.com
Copyright © Bridgetek Pte Ltd
Application Note
BRT_AN_080
LDSBus Python SDK on IDM2040 User
Guide
Version 1.0
Issue Date: 29-11-2021
This document provides information about how to setup and use the LDSBus Python
SDK on IDM2040.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
2
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
Table of Contents
1Introduction .............................................................. 3
2Credits....................................................................... 4
3Getting Started with IDM2040................................... 5
3.1 Hardware Overview.............................................................5
3.2 Hardware Setup Instructions ..............................................5
4Thonny Python IDE - Installation/Setup Instructions 9
5Procedure to run LDSU Circuitpy Sample Example
using Thonny ............................................................... 12
6Contact Information ................................................ 18
Appendix A –References ............................................. 19
Document References ...............................................................19
Acronyms and Abbreviations.....................................................19
Appendix B –List of Tables & Figures .......................... 20
List of Tables.............................................................................20
List of Figures ...........................................................................20
Appendix C –Revision History ..................................... 21

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
3
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
1Introduction
This document describes how to use IDM2040 with LDSU circuitpy example including the
Installation procedure for Thonny Python IDE and steps to execute LDSU circuitpy examples.
The Python SDK will run on IDM2040 with appropriate LDSBus interface. IDM2040 has built-in
LDSBus interface and is capable of supplying up to 24v to the LDSBus. More information on the
IDM2040 is available at https://brtchip.com/product/.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
4
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
2Credits
Open Source Software
Thonny Python IDE: https://thonny.org

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
5
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
3Getting Started with IDM2040
3.1 Hardware Overview
Figure 1 - IDM2040 Hardware Features
3.2 Hardware Setup Instructions
Follow these steps to setup the IDM2040 Hardware Setup –
a. Remove the Jumper.
RJ45
Jumper
20v Adapter
Reset Button
Port for PC
connection
Boot button

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
6
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
b. Connect the LDSU module to HVT.
c. Using RJ45 cable, connect HVT to IDM2040 RJ45 connector.
d. Connect the 20v supply adapter using a USB-C cable to the USB-C port on the IDM2040.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
7
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
e. Turn on the 20v adapter using the AC power supply.
f. Connect IDM2040 to PC using Type-C cable.
g. Press the Boot button the IDM2040 board; Hold it for a few seconds and release it after
resetting the board. Windows will open a drive named “RP1-RP2”.
h. In the given example package, there must be an “.uf2” file, copy the file and paste it into
“RP1-RP2” drive.
i. Upon copying the “.uf2” file to “RPI-RP2”, the device will reboot automatically and again
will appear as a new drive, such as “CIRCUITPY”.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
8
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
The “code.py” is the main file which runs every time theIDM2040 is reset. Open this file and
delete any content inside of it before saving.
j. The COM port for this device will appear in Device Manager. Here is an example screen
showing the IDM2040’s COM Port as COM6.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
9
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
4Thonny Python IDE - Installation/Setup Instructions
Follow these steps to install and setup Thonny Python IDE –
a. Download the Thonny Python IDE package from https://thonny.org/.
b. Click Windows to download the windows version.
`
c. Upon downloading the application, complete the installation by clicking the executable file
(.exe) and following the installation wizard. Upon completing the installation, open the
Thonny Python IDE from the Windows Startup.
d. To open the Properties, click the left mouse button at the right bottom corner. Select
“CircuitPython (generic)”.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
10
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
e. Click “Configure Interpreter…”.
f. Click on the Port drop down and select the port appeared for IDM2040 in device manager
after connecting. In this example screenshot COM port appeared as COM6. Click [OK].
`

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
11
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
g. Thonny will report the device information at the interpreter prompt (“Adafruit CircuitPython
7.0.0-dirty on 2021-11-11; Raspberry Pi Pico with rp2040”) if the device port is correct.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
12
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
5Procedure to run LDSU Circuitpy Sample Example
using Thonny
Follow these steps to run the LDSU circuitpy sample example –
a. Open the sample package file. As part of the sample package there is a folder by name
“json” which contains various sensor json file.
b. Copy and paste the “json” folder to the “CIRCUITPY” storage device.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
13
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
c. Open any given example using a text editor such as notepad ++ and copy it to the Thonny
Editor and save it. For example, open “LDSBus_Thermocouple_Sensor.py” and copy/paste
on Thonny Editor. Click [Save].
d. Upon clicking [Save], a “Where to save to?” dialog box will be displayed. Click and select
CircuitPython device.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
14
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
e. Enter a file name and click [OK].
Note: When sample code is saved to “code.py” then every time it reboots, it will begin running
“code.py”. In order to avoid this, specify a different name.
f. The file will be saved to “CIRCUITPY” drive.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
15
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
g. To run the example from Thonny Editor, click (Run current script).
h. The Circuitpy LDSU example will run to scan the bus and start reporting the sensor data.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
16
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
i. To stop the execution, click (Stop). Users can update the code as required or can
copy/paste another example to try in the Thonny editor.
Note: Upon making any changes to the script file, remember to Save and Run the script.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
17
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
j. Remember to copy the following files - “irBlasterAppHelperFunctions” and
“lir_input_file.txt” before trying the LDSBus_IR_Blaster.py example.
Refer to BRT_AN_078_LDSU IR Blaster_Application for more details on
“LDSBus_IR_Blaster.py” example.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
18
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
6Contact Information
Head Quarters –Singapore
Branch Office –Taipei, Taiwan
Bridgetek Pte Ltd
178 Paya Lebar Road, #07-03
Singapore 409030
Tel: [phone]
Fax: [phone]
Bridgetek Pte Ltd, Taiwan Branch
2 Floor, No. 516, Sec. 1, Nei Hu Road, Nei Hu District
Taipei 114
Taiwan, R.O.C.
Tel: [phone]
Fax: [phone]
E-mail (Sales)
[e-mail]
E-mail (Sales)
[e-mail]
E-mail (Support)
[e-mail]
E-mail (Support)
[e-mail]
Branch Office - Glasgow, United Kingdom
Branch Office –Vietnam
Bridgetek Pte. Ltd.
Unit 1, 2 Seaward Place, Centurion Business Park
Glasgow G41 1HH
United Kingdom
Tel: [phone]
Fax: [phone]
Bridgetek VietNam Company Limited
Lutaco Tower Building, 5th Floor, 173A Nguyen Van
Troi,
Ward 11, Phu Nhuan District,
Ho Chi Minh City, Vietnam
Tel : [phone]
Fax : [phone]
E-mail (Sales)
[e-mail]
E-mail (Sales)
[e-mail]
E-mail (Support)
[e-mail]
E-mail (Support)
[e-mail]
Web Site
http://brtchip.com/
Distributor and Sales Representatives
Please visit the Sales Network page of the Bridgetek Web site for the contact details of our distributor(s) and
sales representative(s) in your country.
System and equipment manufacturers and designers are responsible to ensure that their systems, and any Bridgetek Pte
Limited (BRTChip) devices incorporated in their systems, meet all applicable safety, regulatory and system-level performance
requirements. All application-related information in this document (including application descriptions, suggested Bridgetek
devices and other materials) is provided for reference only. While Bridgetek has taken care to assure it is accurate, this
information is subject to customer confirmation, and Bridgetek disclaims all liability for system designs and for any applications
assistance provided by Bridgetek. Use of Bridgetek devices in life support and/or safety applications is entirely at the user’s
risk, and the user agrees to defend, indemnify and hold harmless Bridgetek from any and all damages, claims, suits or expense
resulting from such use. This document is subject to change without notice. No freedom to use patents or other intellectual
property rights is implied by the publication of this document. Neither the whole nor any part of the information contained in,
or the product described in this document, may be adapted or reproduced in any material or electronic form without the prior
written consent of the copyright holder. Bridgetek Pte Limited, 178 Paya Lebar Road, #07-03, Singapore 409030. Singapore
Registered Company Number: 201542387H.

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
19
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
Appendix A –References
Document References
BRT_API_002_LDSBus_Python_SDK_Guide
BRT_AN_078_LDSU IR Blaster_Application
Acronyms and Abbreviations
Terms
Description
HVT
High Voltage T-Junction
IDE
Integrated Development Environment
LDSBus
Long Distance Sensor Bus
USB
Universal Serial Bus

Application Note
BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Version 1.0
Document Reference No.: BRT_000378 Clearance No.: BRT#187
20
Product Page
Document Feedback Copyright © Bridgetek Pte Ltd
Appendix B –List of Tables & Figures
List of Tables
NA
List of Figures
Figure 1 - IDM2040 Hardware Features ................................................................................. 5