Bridgetek IDM2040 LDSBus Python SDK User Guide
- June 12, 2024
- Bridgetek
Table of Contents
- Introduction
- Credits
- Getting Started with IDM2040
- Thonny Python IDE – Installation/Setup Instructions
- Procedure to run LDSU Circuitpy Sample Example using Thonny
- Contact Information
- Appendix A – References
- Appendix B – List of Tables & Figures
- Appendix C – Revision History
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
**Bridgetek IDM2040 LDSBus Python SDK User Guide
**
This document provides information about how to setup and use the LDSBus Python SDK on IDM2040.
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.
Introduction
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/.
Credits
Open Source Software
- Thonny Python IDE: https://thonny.org
Getting Started with IDM2040
Hardware Overview
Figure 1 – IDM2040 Hardware Features
Hardware Setup Instructions
Follow these steps to setup the IDM2040 Hardware Setup –
a. Remove the Jumper.
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.
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”.
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.
Thonny 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)”
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].
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.
Procedure 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.
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 selectCircuitPython device.
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.
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.
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.
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.
Contact Information
| Head Quarters – Singapore | Branch Office – Tai |
|---|
Bridgetek Pte Ltd
178 Paya Lebar
Road, #07-03 Singapore 409030
Tel: +65 6547 4827
Fax: +65 6841 6071| Bridgetek Pte Ltd, Taiwan Branch 2 Floor, No. 516, Sec. 1,
Nei Hu Road, Nei Hu District
Taipei 114 Taiwan, R.O.C.
Tel: +886 (2) 8797 5691
Fax: +886 (2) 8751 9737
E-mail (Sales)
E-mail (Support)| sales.apac@brtchip.com
support.apac@brtchip.com| E-mail
(Sales)E-mail (Support)|
sales.apac@brtchip.com
support.apac@brtchip.com
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: +44 (0) 141 429 2777 Fax: +44 (0) 141 429 2758| Bridgetek VietNam
Company Limited Lutaco Tower Building, 5th Floor, 173A Nguyen Van Troi, Ward
11, Phu Nhuan District, Ho Chi Minh City, Vietnam Tel : 08 38453222 Fax : 08
38455222
E-mail (Sales)
E-mail (Support)| sales.apac@brtchip.com
support.apac@brtchip.com| E-mail (Sales)
E-mail (Support)| sales.apac@brtchip.com
support.apac@brtchip.com
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.
Appendix A – References
Document References
BRT_API_002_LDSBus_Python_SDK_Guide
BRT_AN_078_LDSU IR Blaster_Application
Acronyms and Abbreviations
| Terms | Descripti |
|---|---|
| HVT | High Voltage T-Junction |
| IDE | Integrated Development Environment |
| LDSBus | Long Distance Sensor B |
| USB | Universal Serial Bu |
Appendix B – List of Tables & Figures
List of Tables
NA
List of Figures
Figure 1 – IDM2040 Hardware Features:……………. 5
Appendix C – Revision History
Document Title: BRT_AN_080 LDSBus Python SDK on IDM2040 User Guide
Document Reference No.: BRT_000378
Clearance No.: BRT#187
Product Page: http://brtchip.com/product/
Document Feedback: SendFeedback
| Revision | Changes | Date |
|---|---|---|
| 1.0 | Initial Release | 29-11-2021 |
Bridgetek Pte Ltd (BRTChip)
178 Paya Lebar Road, #07-03 Singapore 409030
Tel: +65 6547 4827
Fax: +65 6841 6071
Web Site : http://brtchip.com
Copyright © Bridgetek Pte Ltd
References
- Home - IC & Module
- Home - IC & Module
- Contact Us - IC & Module
- Product Change Notifications - IC & Module
- Product Change Notifications - IC & Module
- Product Change Notifications - IC & Module
- Thonny, Python IDE for beginners
- Thonny, Python IDE for beginners
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>