To report machine data to your applications you have to be able to acquire it from your devices. For Citizen machines equipped with Mitsubishi controls you can use the graphical utility program MitsubishiCitizen to do so. The application uses our unique manufacturer specific Citizen Mitsubishi API (Application Program Interface) to access the controller and query data.
To directly read/write data from/to machines with Mitsubishi Citizen controllers connected to CNCnetPDM with your applications you can use our free Open Source Client (C-Sharp)
To be able to verify the results it is recommended to use this utility on a laptop with a network connection at the shop-floor in front of the machine.
If you have installed CNCnetPDM on your PC with a license other than a ‘free license’ and run this program from the folder where CNCnetPDM is installed you get unlimited output. Otherwise the program outputs 'Running Status' and 'Running Mode'. Please see licensing for details or contact us if you have any questions.
If you like to run this program from a different location on your PC you can simply copy your licensed CNCnetPDM.ini file to this directory.
SETUP
Extract all contents of MitsubishiCitizen.zip to a folder on your PC.
In this folder open file melcfg.ini with a text editor and scroll down to section [HOSTS] (1).
melcfg.ini comes with predefined entries for up to 54 machines, every line in section [HOSTS] contains Mitsubishi machine number (the number after TCP), IP Address and TCP Port of a single machine.
Replace the default IP Address 192.168.1.100 with the IP Address of your controller (2), note down the machine number (3) and save the file. If, for example, the IP Address of your first controller is 192.168.1.2 the line should look like TCP1=192.168.1.2,683
FIG 2: Adjust melcfg.ini file
USAGE
In Windows Explorer double click MitsubishiCitizen
In field ‘Mitsubishi Machine Number’ enter the number as defined in melcfg.ini
Check ‘Basic Test Only’
Click on button ‘Query’
If you don’t get an error, repeat the test with ‘Basic Test Only’ unchecked
You should see a result similar to the following:
FIG 3: Output of Citizen MitsubishiCitizen (full test, licensed version)
If you run the program with a 'free license' it outputs 'Running Status' and 'Running Mode'
In case your controller runs multiple part systems MitsubishiCitizen outputs the data of the selected part system, check with part system 1 first
PROGRAM OUTPUT
MitsubishiCitizen outputs the following data:
Running Status (= Basic Test)
Running Mode
Parts required
Parts machined
Parts (total)
Current NC Program
NC Program comment
Commanded Feed Rate
Actual Feed Rate
Running Program
Spindle Number
Spindle Speed(1)
Syncronize Speed
Actual Block
Number of Part Systems
Power on time
Automatic OP time
Start time
NC Date (local)
NC Time (local)
Alarm (0-10): Displays up to 10 active alarms sorted by priority
Block number of the currently active NC Program
Current block outputs up to 10 lines of the current NC Program
STATUS AND MODE OUTPUT
The following tables shows possible values for ‘Running Status’ and ‘Running Mode’: