4 Main operation
This chapter Introduction Register, Button, Indicator, Trace, Monitor, Universal Read Write, I2C Set and operation of Log
4.1 Register
Register area shows as Figure 4-1. It contains the segment area (the top of it) and register area. Can add,modify and delete segment or register, monitor the value of the register and create a register file by button and right-click menu. The form of register in the area decided by [Bit Register] and [Word Register] in the [Setting] menu, Figure 4-1 show the form of bit register.
Figure 4-1 Register view
4.1.1 segement area
Click the combo in the segment area, it will show all segment name(and the base of it), shown as Figure 4-2, choose a segment, the registers of it will be shown in the register area. The last one in the combo is "All", means to show all registers.
Figure 4-2 Selectting segment
The "Add". "Modify", "Delete" button in the segment area can add, modify and delete the segments. "All" will always exist(that need not to add and can't be deleted). It corresponding registers of all segments.
- Add -- Click "Add" button, shown as Figure 4-3, input the base and segment name, can add a segment.
Figure 4-3 Add segment
- Modify -- Click "Modify" button, shown as Figure 4-4, can modify the base and name of the segment.
Figure 4-4 Modify the select
- Delete -- Click "Delete" button, can delete the segment and all register in it, a confirmation dialog will appear, shown as Figure 4-5:
Figure 4-5 Confirm delete
4.1.2 Register area
Register shown as Figure 4-6, include name, offset, default and value. Default and value can be displayed by specify base. The prefix 'd', 'h' and 'b' means dec, hex and bin. When you select "All", the offset use absolute address, the registers in the table will also show by an absolute address.
Figure 4-6 Register area
- Select -- Click a row in the table(except the value column), the selected row will change to blue.
- Read Register -- Double click a row in the table(except the value column). The register will read its value from the device and shown in the value column.
- Write Register -- Click the value of a register can input a value, shown as the blue part of Figure 4-7, and click anywhere in the table except the current grid can write the new value into device.
Figure 4-7 Editting the value of register
Reading register in the tool means getting content of register from chip or FPGA and shows it in the table.
4.1.3 Right click menu of register area
Selecting a register in the register area, right click will show a menu, shown as Figure 4-8. When the segment is "All", the "Add","Modify","Delete" in the reght-click menu will be disabled.
Figure 4-8 Right click menu
- Update -- Read value for the register
- Update All -- Read values for all register in the segment(If register not in current segment will not update).
- Add -- Add register, shown as Figure 4-9, can input name, offset(hex), bit range(dec, left larger than right), base and default.
Figure 4-9 Add register
- Modify -- modify register, the dialog is same as Figure 4-9, there is the old value of the text.
- Delete -- Delete the selected register without warning.
- Write by file -- Import register data from file.
- Save as file -- Write the data of register in the register area into an appointment file.
4.2 Button
All button in the Button area can set C script functions by the user. Press the button can execute the function of the C script.
Right clicking on a button will open a dialog, can set the function of the button, shown as Figure 4-10:
Figure 4-10 Button configuration
- Button -- Show the number of buttons, can select different button to configure them.
- Caption -- Input the string which will be shown on the button to prompt the function of the button.
- Function -- Can select C script functions in the combo.
- ParamNum -- Choose the number of param, the default value is 0. If select 0, the "default" and "Remind" are disable, be careful, the HiChannel tool does not care what you input. It just transforms them to the script functions as string.
- Default -- Input the default value of param, multiple values separated by commas.
- Remind -- Input remind param.
- Show Return Value -- If this button is selected, it will show the return value of C script functions after executing the function.
- Uninstall -- Used to uninstall the button.
Click a button which has configured, a dialog will open if the ParamNum is not 0, input programs, multiple values separated by commas. Shown as Figure 4-11, the string in referrence is param. If there is default of param, it will show in the text.
Figure 4-11 Parameter setting
4.3 Indicator
The Indicator, shown as 4-12, User can configure C script functions to indicator. The HiChannel will invoke the function periodicly, the color of indicator will be updated according the returned value.
Figure 4-12 Indicator area
Right clicking on the right string of the indicator can configure the function of the indicator, shown as Figure 4-13:
Figure 4-13 Indicator setting
- Lamp -- Lamp -- Show the number of indicator, can choose different indicators to configure.
- Caption -- Input a string to show on the right of the indicator to express the meaning of the indicator.
- Lamp Mode -- Can choose the mode of Lamp: the Gray+Green(Gray corresponding 0 and Green corresponding >=1) and the Gray+Green+Red(corresponding 0/1/>=2).
- Others are sama as "Button".
4.4 Trace
Trace showed as Figure 4-14. User can configure the C script functions for trace. The HiChannel will invoke the functions periodicly, and show the returned string on the trace.
Figure 4-14 Trace area
Right clicking on the lable(not word) can configure the function, shown as Figure 4-15:
Figure 4-15 Trace setting
- Trace -- The number of trace can choose different trace to configure.
- Caption --Input the string which will show at the left of the trace to express the meaning of trace.
- Others are the same as "Button".
4.5 Monitor
Monitor showed as Figure 4-16. User can configure the C script functions for every monitor. The HiChannel will call the function periodic, and show the return string in the corresponding frame or progress bar.
Figure 4-16 Monitor area
Right clicking on every monitor, can choose C script functions from combo.
- Lock Time -- System lock time is calculated by C script functions.
- Symbol Error -- Symbol error is calculated by C script functions.
- Carrier Error -- Carrier error is calculated by C script functions.
- Signal Intensity -- Signal intensity is calculated by C script functions(0~100).
- Signal Quality -- Signal quality is calculated by C script functions(0~100).
- C/N -- C/N value is calculated by C script functions.
- Error Rate -- Error rate is calculated by C script functions.
- Function—— In the drop-down box to select the corresponding C-script function, if the script functions bound to the C function specified in the configuration file does not exist, then the selected item is empty.
- Uninstall——Remove the binding function
4.6 Universal Read Write
Universal read write shown as Figure 4-17. The "Dec", "Hex" and "Bin" in the base means dec, hex, and bin.
Figure 4-17 Universal read write area
- Read -- Inputing the register address(hex) into the text after "Address", pressing the "Read" button can read values from device, and the value will be shown on the text.
- Write --Inputing the register address(hex) and value(must match the base selected in the "Base" combo), press "Write" to write it to the device.
Note：
- Address and configuration files related to AddressBytes set Address can not be greater than the length of AddressBytes
- Value Enter the value of the length and configuration files RegisterBytes settings, Base hex select relevant the The Value the length can not be greater than 2 * RegisterBytes when Base equal HEX,.
When the Base equal BIN, Value's length can not be greater than 8 * RegisterBytes.
4.7 I2C Set
I2C Set shown as Figure 4-18, used to set I2C address and monitor the status of I2C.
Figure 4-18 I2C set area
The four check boxes used to choose the I2C device and address(hex).Only can select one of the four, the ones which not selected are disabled. Chip address uses to communicate with Hisilicon channel chips, large FPGA and middle FPGA usually use to debug and test FPGA, small FPGA uses to control an auxiliary function of FPGA. In the Main page can only choose one of the first three ones. In the Slave page can only use small FPGA.
The picture shows the status of I2C, show Online(green) when it normal, and shows Offline(red) when it abnormal. The HiChannel will call the function periodic, and decide wether it normal or not(the value >1 is normal). Right click on the picture, selects a C script function. Shown as Figure 4-19:
Figure 4-19 I2C set dialog
- Function—— In the drop-down box to select the corresponding C-script function, if the script functions bound to the C function specified in the configuration file does not exist, then the selected item is empty.
- Uninstall——Remove the binding function
4.8 Log
Log area shown as Figure 4-20, the result of operation in register area and informatin of operation in the button area will show in the Log area, there is a scroll bar on the right.
Figure 4-20 Log area
- Clear -- Clear the information of the Log area.
- Save -- Save the information of the Log area to a file.