Tham số
Sơ lược
- Tìm hiểu những từ khóa truy vấn tham số nào áp dụng cho linh kiện, footprint hoặc đối tượng PCB nói chung, cùng cách sử dụng từng từ khóa trong bộ lọc hoặc truy vấn.
- Xem các truy vấn mẫu để tìm đối tượng theo tên tham số, tìm giá trị khớp hoàn toàn hoặc một phần và loại trừ các đối tượng không đáp ứng điều kiện.
- Hiểu cách chuyển giá trị tham số dạng chuỗi thành giá trị số để so sánh theo khoảng bằng các từ khóa như 'StrToNumber' và 'StrToNumberDef'.

Các hàm truy vấn PCB Parameters được hiển thị trong hộp thoại Query Helper
Trang tham khảo này trình bày chi tiết các từ khóa của ngôn ngữ truy vấn thuộc danh mục Parameters có trong tài liệu PCB và thư viện PCB. Để được trợ giúp về một từ khóa truy vấn cụ thể, hãy sử dụng các mục có thể thu gọn bên dưới hoặc bôi đen (hoặc nhấp vào bên trong) từ khóa bất kỳ trong Query Helper hoặc bảng Filter, rồi nhấn F1 để truy cập ngay mục tương ứng.
CompParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số linh kiện PCB; có thể kiểm tra giá trị này để trả về các linh kiện PCB thỏa mãn truy vấn.
Cú pháp
CompParameterValue(ParameterName : String) : String
Ví dụ sử dụng
CompParameterValue('Mounting Technology') Like 'SM*'
Trả về tất cả các linh kiện có tham số Mounting Technology với giá trị chuỗi bắt đầu bằng SM, chẳng hạn như SMT, SMD, v.v. Các đối tượng con liên quan của đối tượng linh kiện thỏa mãn điều kiện, chẳng hạn như đường mạch, cung tròn, pad, văn bản, v.v., cũng được trả về.
CompParameterValue('Mounting Technology') Like '*SM*'
Trả về tất cả các linh kiện và các đối tượng con liên quan có tham số Mounting Technology với giá trị chuỗi chứa *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Trả về tất cả các linh kiện và các đối tượng con liên quan có giá trị tham số VoltageRating lớn hơn 50 vôn. Giá trị chuỗi do CompParameterValue trả về được chuyển đổi thành số để so sánh bằng hàm StrToNumber có khả năng nhận biết đơn vị.
FootprintParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số footprint PCB; có thể kiểm tra giá trị này để trả về các linh kiện PCB thỏa mãn truy vấn.
Cú pháp
FootprintParameterValue(ParameterName : String) : String
Ví dụ sử dụng
FootprintParameterValue('Mounting Type') Like 'SMD'
Trả về tất cả các linh kiện và các đối tượng con liên quan có tham số footprint Mounting Type với giá trị chuỗi chứa SMD.
HasCompParameter
Tóm tắt
Trả về các linh kiện PCB có tham số mang tên được chỉ định.
Cú pháp
HasCompParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Trả về tất cả các đối tượng linh kiện cha có tham số mang tên Mounting Technology. Các đối tượng con liên quan của đối tượng linh kiện thỏa mãn điều kiện, chẳng hạn như đường mạch, cung tròn, pad, văn bản, v.v., cũng được trả về.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Trả về tất cả các linh kiện và các đối tượng con liên quan, except đối với các đối tượng linh kiện cha có tham số Mounting Technology.
HasCompParameterValue
Tóm tắt
Trả về các linh kiện PCB có tham số mang tên được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Trả về tất cả các đối tượng linh kiện cha có tham số mang tên Mounting Technology với thuộc tính giá trị khớp với SMT. Các đối tượng con liên quan của đối tượng linh kiện thỏa mãn điều kiện, chẳng hạn như đường mạch, cung tròn, pad, văn bản, v.v., cũng được trả về.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Trả về tất cả các linh kiện và các đối tượng con liên quan không có tham số Design Item Status với giá trị RoHS-Compliant.
HasFootprintParameter
Tóm tắt
Trả về các linh kiện PCB có tham số footprint mang tên được chỉ định.
Cú pháp
HasFootprintParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Trả về tất cả các đối tượng linh kiện cha có tham số footprint mang tên IPC Density. Các đối tượng con liên quan của đối tượng linh kiện thỏa mãn điều kiện, chẳng hạn như đường mạch, cung tròn, pad, văn bản, v.v., cũng được trả về.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Trả về tất cả các linh kiện và các đối tượng con liên quan, except đối với các đối tượng linh kiện cha có tham số footprint IPC Density.
HasFootprintParameterValue
Tóm tắt
Trả về các linh kiện PCB có tham số footprint mang tên được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Trả về tất cả các đối tượng linh kiện cha có tham số footprint mang tên Mounting Method với thuộc tính giá trị khớp với Press Fit. Các đối tượng con liên quan của đối tượng linh kiện thỏa mãn điều kiện, chẳng hạn như đường mạch, cung tròn, pad, văn bản, v.v., cũng được trả về.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Trả về tất cả các linh kiện và các đối tượng con liên quan không có tham số footprint Mounting Method với giá trị Press Fit.
HasParameter
Tóm tắt
Trả về các đối tượng PCB có tham số mang tên được chỉ định.
Cú pháp
HasParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Trả về tất cả các đối tượng có tham số mang tên Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Trả về tất cả các đối tượng except những đối tượng có tham số Mounting Technology.
HasParameterValue
Tóm tắt
Trả về các đối tượng PCB có tham số mang tên được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Trả về tất cả các đối tượng có tham số mang tên Mounting Technology và thuộc tính giá trị khớp với SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Trả về tất cả các đối tượng không có tham số Design Item Status với giá trị RoHS-Compliant.
ParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số đối tượng PCB; có thể kiểm tra giá trị này để trả về các đối tượng PCB thỏa mãn truy vấn.
Cú pháp
ParameterValue(ParameterName : String) : String
Ví dụ sử dụng
ParameterValue('Mounting Technology') Like 'SM*'
Trả về tất cả các đối tượng có tham số Mounting Technology với giá trị chuỗi bắt đầu bằng SM, chẳng hạn như SMT, SMD, v.v.
ParameterValue('Mounting Technology') Like '*SM*'
Trả về tất cả các đối tượng có tham số Mounting Technology với giá trị chuỗi chứa SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Trả về tất cả các đối tượng có giá trị tham số VoltageRating lớn hơn 50 vôn. Giá trị chuỗi do ParameterValue trả về được chuyển đổi thành số để so sánh bằng hàm StrToNumber có khả năng nhận biết đơn vị.
StrToNumber
Tóm tắt
Chuyển đổi chuỗi giá trị tham số được chỉ định thành số bằng loại đơn vị đã quy định.
Cú pháp
StrToNumber(Value : String , Unit : String) : Number
Ví dụ sử dụng
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Chuyển đổi chuỗi giá trị do tham số VoltageRating trả về thành số, sử dụng vôn (V) làm đơn vị, sau đó trả về tất cả các đối tượng có giá trị lớn hơn 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Chuyển đổi chuỗi giá trị do tham số Resistance trả về thành số, sử dụng ôm làm đơn vị, sau đó trả về tất cả các đối tượng có giá trị trong khoảng từ 1kΩ đến 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Chuyển đổi chuỗi giá trị do tham số CapacitanceValue trả về thành số, sử dụng đơn vị điện dung (F), sau đó trả về tất cả các đối tượng có giá trị nhỏ hơn 2nF (2e-9 theo ký hiệu khoa học).
Lưu ý
Một lỗi tập lệnh sẽ được phát sinh nếu không thể chuyển đổi chuỗi giá trị thành số. Để xử lý tình huống này, hãy sử dụng hàm StrToNumber, hàm này trả về một số mặc định được chỉ định nếu quá trình chuyển đổi thất bại.
Hàm chuyển đổi chuỗi thành số có nhận biết đơn vị hỗ trợ nhiều định nghĩa kiểu đơn vị, bao gồm:
- V – Điện áp
- A – Dòng điện
- Ohm – Điện trở
- Z – Trở kháng
- F – Điện dung
- H – Điện cảm
- G – Điện dẫn
- W – Công suất
- Hz – Tần số
- Q – Điện tích
- C – Nhiệt độ
- dB – Decibel
- % – Phần trăm
- m – Chiều dài
- Kg – Khối lượng
- s – Thời gian
Hàm chuyển đổi hỗ trợ các hệ số tỷ lệ giá trị tiêu chuẩn (micro, kilo, mega, v.v.) và do đó hỗ trợ các chuỗi tham số chứa ký hiệu viết tắt của tiền tố như mV, uA, kHz,, v.v.
Nhiều cách biểu diễn giá trị cũng được hỗ trợ. Ví dụ, cùng một giá trị điện trở có thể được biểu diễn như sau:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Tóm tắt
Chuyển đổi chuỗi giá trị của tham số được chỉ định thành một số hoặc một số mặc định, sử dụng kiểu đơn vị đã quy định.
Cú pháp
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Ví dụ sử dụng
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Chuyển đổi chuỗi giá trị do tham số VoltageRating trả về thành một số, sử dụng điện áp (V) làm đơn vị, sau đó trả về tất cả các đối tượng có giá trị lớn hơn 50V. Nếu chuỗi tham số hoặc đơn vị không được nhận dạng (không thể chuyển đổi), giá trị mặc định 10 sẽ được trả về.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Chuyển đổi chuỗi giá trị do tham số VoltageRating trả về thành một số, sử dụng điện áp (V) làm đơn vị, sau đó trả về tất cả các đối tượng có giá trị định mức trong khoảng từ 10V đến 50V. Nếu không thể đọc giá trị, điện áp được giả định là 6V (giá trị mặc định đã xác định).
Ghi chú
Hàm chuyển đổi chuỗi thành số có nhận biết đơn vị hỗ trợ nhiều định nghĩa kiểu đơn vị, bao gồm:
- V – Điện áp
- A – Dòng điện
- Ohm – Điện trở
- Z – Trở kháng
- F – Điện dung
- H – Điện cảm
- G – Điện dẫn
- W – Công suất
- Hz – Tần số
- Q – Điện tích
- C – Nhiệt độ
- dB – Decibel
- % – Phần trăm
- m – Chiều dài
- Kg – Khối lượng
- s – Thời gian
Hàm chuyển đổi hỗ trợ các hệ số tỷ lệ giá trị tiêu chuẩn (micro, kilo, mega, v.v.) và do đó hỗ trợ các chuỗi tham số chứa ký hiệu viết tắt của tiền tố như mV, uA, kHz,, v.v.
Nhiều cách biểu diễn giá trị cũng được hỗ trợ. Ví dụ, cùng một giá trị điện trở có thể được biểu diễn như sau:
- 2k2
- 2.2k
- 2200
- 2,200