1. Configure all the necessary para

1. Configure all the necessary parameters to set up the TSS for a new application. Whenever a code
is recompiled, the TSS_SystemSetupData.c and TSS_SystemSetupVal.h files verify whether valid
values for all the parameters are provided in the TSS_SystemSetup.h file. If any parameter is out
of range, the compiler gives an error pointing towhat parameter is out of its specified range.
2. If you want to see diagnostic messages or recommendations during compile time, define the
TSS_ENABLE_DIAGNOSTIC_MESSAGES macro in the TSS_SystemSetup.h. In this case, the
compiler generates warnings to indicate possible issues.
3. The simple version of TSS low level routines is supported by the HCS08 and ColdFire V1. The
code footprint is smaller than the full version, butthe TSS_Task needs to always wait for an end
of measurement and auto triggering is not available. The simple version is selected by the
TSS_USE_SIMPLE_LOW_LEVEL macro.
4. In case your application needs to handle raw measured data (delta orsignal values to calibrate the
baseline), define the TSS_USE_DELTA_LOG macro. The TSS then creates the
tss_ai8InstantDelta[TSS_N_ELECTRODES] array and keeps it updated.
For signal values, define the TSS_USE_SIGNAL_LOG macro. The TSS then creates the
tss_au16InstantSignal[TSS_N_ELECTRODES] array and keeps it updated.
5. If your application is expected to run in a harsh environment, the IIR filter may help to achieve a
more robust operation. Define the TSS_USE_IIR_FILTER macro to enable IIR option.
6. The TSS provides automatic sensitivity calibration feature. When the
TSS_USE_AUTO_SENS_CALIBRATION macro is set, the TSS monitors the noise level of each
electrode and controls the sensitivity thresholds. When enabled, this feature also needs the
TSS_USE_AUTO_SENS_CALIB_INIT_DURATION parameter which defines the duration of
noise calibration and the initialization phase in the number of TSS task calls. A longer initialization
phase may result in better touch recognition and robustness.
7. The macro TSS_USE_BASELINE_INIT_DURATION defines a duration of the baseline
initialization. The longer duration can improvethe noise immunity and touch recognition
reliability.
8. The signal can be normalized with macros TSS_USE_SIGNAL_DIVIDER and
TSS_USE_SIGNAL_MULTIPLIER. The value of the normalization for defined electrode is set by
TSS_Ex_SIGNAL_DIVIDER or TSS_Ex_SIGNAL_MULTIPLIER. These macros are primary
intended to be used for analog decoders (the analog slider, the analog rotary, and the matrix).
9. If the application needs to handle any faults detected by the TSS library, define the
TSS_ONFAULT_CALLBACK macro as the name of your application callback function. If
defined, the TSS library calls this user-defined function whenever there is a Fault event detected.
The fault is also reported in the Faults register. This function mustbe included in one of the higher
layers of the application (in main.cor another application layer file).
10. Your application must handle special initialization requirements when the TSS library is used.
Define the TSS_ONINIT_CALLBACK macro as the name of your application callback function.
If defined, the TSS library calls this user-defined function whenever the TSS_Init() function is
called. The function is intended to perform peripheral initializations. In case the Processor Expert
TSS component is used, an initialization function is generated which automatically enables the
clock for all peripherals used by TSS library. Call this function from the OnInit callback

Kết quả (Việt) 1:

1. cấu hình tất cả các thông số cần thiết để thiết lập TSS cho một ứng dụng mới. bất cứ khi nào một mã
được biên dịch lại, các tss_systemsetupdata.c và các tập tin tss_systemsetupval.h xác minh xem các giá trị hợp lệ
cho tất cả các tham số được cung cấp trong tệp tss_systemsetup.h. nếu có tham số là ra
phạm vi, trình biên dịch cho một lỗi chỉ towhat tham số là ra khỏi phạm vi của nó quy định.
2.nếu bạn muốn xem các thông báo chẩn đoán hoặc đề nghị trong thời gian biên dịch, xác định
tss_enable_diagnostic_messages vĩ mô trong tss_systemsetup.h. trong trường hợp này,
biên dịch tạo ra các cảnh báo để chỉ ra các vấn đề có thể.
3. phiên bản đơn giản của TSS thói quen cấp thấp được hỗ trợ bởi hcs08 và coldfire v1. các
đang dấu chân nhỏ hơn phiên bản đầy đủ,butthe tss_task cần phải luôn luôn chờ đợi cho một kết thúc
đo lường và tự động kích hoạt không có sẵn. phiên bản đơn giản là lựa chọn của
tss_use_simple_low_level vĩ mô.
4. trong trường hợp ứng dụng của bạn cần để xử lý dữ liệu đo thô (đồng bằng giá trị orsignal để hiệu chỉnh
cơ sở), xác định vĩ mô tss_use_delta_log. TSS sau đó tạo ra các
tss_ai8instantdelta [tss_n_electrodes] mảng và giữ nó cập nhật.
Cho các giá trị tín hiệu, xác định vĩ mô tss_use_signal_log. TSS sau đó tạo ra các tss_au16instantsignal [tss_n_electrodes] mảng
và giữ nó cập nhật.
5. nếu ứng dụng của bạn sẽ chạy trong một môi trường khắc nghiệt, các bộ lọc IIR có thể giúp đạt được một
hoạt động mạnh mẽ hơn.xác định vĩ mô tss_use_iir_filter bật tùy chọn iir.
6. TSS cung cấp độ nhạy tự động tính năng hiệu chuẩn. khi
tss_use_auto_sens_calibration vĩ mô được thiết lập, TSS kiểm tra mức độ tiếng ồn của mỗi điện cực
và kiểm soát các ngưỡng nhạy cảm. khi được kích hoạt, tính năng này cũng cần
tham số tss_use_auto_sens_calib_init_duration trong đó xác định thời gian
hiệu chuẩn tiếng ồn và giai đoạn khởi tạo số lượng TSS cuộc gọi nhiệm vụ. một khởi
giai đoạn còn có thể dẫn đến sự công nhận cảm ứng tốt hơn và mạnh mẽ.
7. các tss_use_baseline_init_duration vĩ mô xác định thời gian của đường cơ sở
khởi tạo. thời gian còn có thể improvethe tiếng ồn miễn dịch và liên lạc công nhận
độ tin cậy.
8.tín hiệu có thể được bình thường hóa với các macro tss_use_signal_divider và
tss_use_signal_multiplier. giá trị của sự bình thường hóa cho điện cực được xác định là do
tss_ex_signal_divider hoặc tss_ex_signal_multiplier. các macro là chính
dự định sẽ được sử dụng cho các bộ giải mã tương tự (thanh trượt tương tự, quay analog, và ma trận).
9.nếu ứng dụng cần xử lý bất kỳ lỗi phát hiện bởi các thư viện TSS, xác định
tss_onfault_callback vĩ mô như tên của ứng dụng chức năng gọi lại của bạn. nếu
xác định, thư viện TSS gọi chức năng người dùng định nghĩa này bất cứ khi nào có một sự kiện lỗi được phát hiện.
Lỗi cũng được báo cáo trong sổ đăng ký lỗi. chức năng mustbe này bao gồm trong một trong những cao
lớp ứng dụng (trong main.cor một tập tin lớp ứng dụng).
10. ứng dụng của bạn phải xử lý các yêu cầu khởi tạo đặc biệt khi các thư viện TSS được sử dụng.
Xác định vĩ mô tss_oninit_callback như tên của ứng dụng chức năng gọi lại của bạn.
Nếu được xác định, các thư viện TSS gọi chức năng người dùng định nghĩa này bất cứ khi nào tss_init () đang được gọi là
.chức năng được thiết kế để thực hiện khởi tạo thiết bị ngoại vi. trong trường hợp bộ vi xử lý chuyên gia
TSS thành phần được sử dụng, một chức năng khởi tạo được tạo ra tự động cho phép người
đồng hồ cho tất cả các thiết bị ngoại vi sử dụng thư viện TSS. gọi chức năng này từ gọi lại oninit

Kết quả (Việt) 2:

1. Đặt cấu hình tất cả các thông số cần thiết để thiết lập TSS cho một ứng dụng mới. Bất cứ khi nào một mã
biên, TSS_SystemSetupData.c và TSS_SystemSetupVal.h các tập tin xác minh cho dù hợp lệ
giá trị cho tất cả các tham số được cung cấp trong các tập tin TSS_SystemSetup.h. Nếu bất kỳ tham số là ra
phạm vi, trình biên dịch cho một lỗi chỉ towhat tham số là ra khỏi phạm vi cụ thể của nó.
2. Nếu bạn muốn xem thư chẩn đoán hoặc đề nghị trong thời gian biên dịch, xác định các
TSS_ENABLE_DIAGNOSTIC_MESSAGES vĩ mô trong TSS_SystemSetup.h. Trong trường hợp này, các
biên dịch tạo ra các cảnh báo để cho biết có thể vấn đề.
3. Phiên bản đơn giản của TSS thấp cấp thói quen được hỗ trợ bởi HCS08 và ColdFire V1. Các
mã dấu chân nhỏ hơn so với phiên bản đầy đủ, nhưng TSS_Task cần phải luôn luôn chờ đợi cho một kết thúc
đo lường và tự động kích hoạt là không có sẵn. Phiên bản đơn giản được chọn bởi các
TSS_USE_SIMPLE_LOW_LEVEL vĩ mô.
4. Trong trường hợp ứng dụng của bạn cần phải xử lý dữ liệu đo thô (delta orsignal giá trị hiệu chỉnh các
đường cơ sở), xác định các vĩ mô TSS_USE_DELTA_LOG. TSS sau đó tạo ra các
tss_ai8InstantDelta [TSS_N_ELECTRODES] mảng và giữ cho nó được Cập Nhật.
Cho giá trị tín hiệu, xác định các vĩ mô TSS_USE_SIGNAL_LOG. TSS sau đó tạo ra các
tss_au16InstantSignal [TSS_N_ELECTRODES] mảng và giữ cho nó được Cập Nhật.
5. Nếu ứng dụng của bạn dự kiến sẽ chạy trong một môi trường khắc nghiệt, IIR lọc có thể giúp đỡ để đạt được một
hoạt động mạnh mẽ hơn. Xác định các vĩ mô TSS_USE_IIR_FILTER để cho phép IIR tùy chọn.
6. TSS cung cấp tự động nhạy cảm hiệu chuẩn tính năng. Khi các
vĩ mô TSS_USE_AUTO_SENS_CALIBRATION được thiết lập, TSS kiểm soát mức độ tiếng ồn của mỗi
điện cực và điều khiển ngưỡng nhạy cảm. Khi kích hoạt, tính năng này cũng cần các
tham số TSS_USE_AUTO_SENS_CALIB_INIT_DURATION được định nghĩa trong suốt thời gian của
hiệu chuẩn tiếng ồn và khởi tạo giai đoạn trong số TSS nhiệm vụ cuộc gọi. Một khởi tạo dài
giai đoạn có thể dẫn đến tốt hơn công nhận touch và mạnh mẽ.
7. Vĩ mô TSS_USE_BASELINE_INIT_DURATION xác định một thời gian trong đường cơ sở
khởi tạo. Trong thời gian dài hơn có thể improvethe tiếng ồn miễn dịch và touch công nhận
độ tin cậy.
8. Các tín hiệu có thể được chuẩn hoá với macro TSS_USE_SIGNAL_DIVIDER và
TSS_USE_SIGNAL_MULTIPLIER. Giá trị bình thường hóa cho các điện cực được xác định được thiết lập
TSS_Ex_SIGNAL_DIVIDER hoặc TSS_Ex_SIGNAL_MULTIPLIER. Các macro được chính
nhằm mục đích được sử dụng cho bộ giải mã tương tự (analog trượt, quay tương tự và ma trận).
9. Nếu nhu cầu ứng dụng để xử lý bất kỳ lỗi được phát hiện bởi thư viện TSS, xác định các
TSS_ONFAULT_CALLBACK vĩ mô như tên của ứng dụng chức năng gọi lại của bạn. Nếu
được xác định, thư viện TSS gọi chức năng người dùng định nghĩa này bất cứ khi nào có một sự kiện lỗi phát hiện.
Lỗi cũng được báo cáo trong đăng ký lỗi. Này mustbe chức năng bao gồm trong một trong các cao
lớp của ứng dụng (trong main.cor một ứng dụng lớp tập tin).
10. Ứng dụng của bạn phải xử lý yêu cầu khởi tạo đặc biệt khi thư viện TSS được sử dụng.
Xác định vĩ mô TSS_ONINIT_CALLBACK tên chức năng gọi lại ứng dụng của bạn.
Nếu được xác định, thư viện TSS gọi chức năng người dùng định nghĩa này bất cứ khi nào các chức năng TSS_Init() là
được gọi là. Các chức năng được thiết kế để thực hiện ngoại vi initializations. Trong trường hợp các chuyên gia xử lý
TSS thành phần được sử dụng, một hàm khởi tạo được tạo ra tự động cho phép các
đồng hồ cho tất cả các thiết bị ngoại vi được sử dụng bởi TSS thư viện. Gọi hàm này từ gọi lại OnInit