Software Update
CF1500 RVM 
(distributor report version)
12/9/02                  Vol. 10 No. 10

This is a special RVM version with the "distributor reports" feature enabled, coin hoppers are disabled. It is intended for use in Iowa and Michigan only.

Note: this version adds the ability for the pickup agent to enter the actual number of bags picked up, by commodity. Three individual report tickets are now printed. A 4-digit password is now required to reset the distributor counts after a keypad command #4,02.

Description of operation:

A stand-alone RVM can now perform basic distributor bag reporting without requiring an "El Diablo" system running on a PC. A report can be printed indicating the number of bags due a specific distributor, then this distributor's bag counts can be reset.

To print an individual distributor report each distributor keys in a different keypad command. Keypad commands #4, 40 to 55 represent the 16 different distributors. For example: #4,40 = distributor 0, #4,41 = distributor 1, #4,42 = distributor 2...#4,55 = distributor 15. When a distributor such as Coke enters his code such as #4,43 the RVM will prompt to verify the distributor's name such as:

    ARE YOU THE Coke DIST?
    3 = YES * = NO

If he is indeed the Coke distributor, he should press 3. 

If there are can bags available for this distributor, the RVM will display:

3 CAN BAG(S) AVAILABLE, HOW MANY ARE
YOU TAKING:__   (A=ALL, *=CLEAR, #=ABORT)

The pickup agent should now enter the number of bags he is going to pick up. He must enter a 2-digit number, so for numbers less than 10, he must enter a 0 first such as 03. As a shortcut he can simply press the 'A' key to indicate he's picking up all bags of this commodity. The software will not allow him to take more than the number of bags indicated. He should enter 00 if he's not pickup up any bags of this commodity.
If he realizes he made a mistake, he can press '#' to abort the process and return to the main pickup mode screen.

The RVM will then prompt for the number of PET and glass bags he's picking up. 

10 PET BAG(S) AVAILABLE, HOW MANY ARE
YOU TAKING:__   (A=ALL, *=CLEAR, #=ABORT)

11 GLASS BAG(S) AVAILABLE, HOW MANY ARE
YOU TAKING:__   (A=ALL, *=CLEAR, #=ABORT)

Note: if no bags of a specific commodity are available for this distributor, the display will not ask how many bags he's picking up for that commodity. For example, if no PET bags are available, the RVM will prompt for the number of can bags, then prompt for the number of glass bags, skipping the PET bag prompt. If there are no bags of any commodity available for this distributor the RVM will not print a ticket but instead display:

    NO BAGS ARE TO BE PICKED UP

Otherwise, the RVM will then print three copies of the individual distributor report ticket, indicating the number of bags to be picked up:

  Safeway
    123
 INDIVIDUAL
DISTRIBUTOR
   COUNTS
   TICKET

Distributor:
Coke

Please pick up:
3 can bag(s)
10 glass bag(s)
11 PET bag(s)

Value: $324.00
( 2520 cans x 6.00 cents)
( 2000 glass x 6.00 cents)
( 880 PET x 6.00 cents)

Meter:47831
Machine #650123
Voucher #00000029
10/16/02  11:39:20

The RVM will display:
    
    DID THE TICKETS PRINT OK?
    3 = YES 9 = REPRINT   (IF MISTAKE TURN OFF)

If all tickets didn't print correctly he should correct the printer problem and press 9 to reprint a ticket. If he realizes he entered the wrong number of bags or he entered the wrong distributor code, he can abort the process without changing any counts by turning off the RVM power. Otherwise he should press 3 which subtracts an appropriate number of containers from that distributor's bag counts, based on the number of bags picked up. The display will then return to the pickup mode screen:

    PICKUP FUNCTION MODE
    ENTER FUNCTION #:__

It is very important that the distributor press 3 to reset the counts to prevent bag accounting errors.
Potential pitfalls:

  1. The distributor must key in the correct #4 command otherwise he will clear the wrong distributor's counts. If he realizes he punched in the wrong #4 command, he can turn the RVM off and back on without clearing the wrong counts if he does this prior to pressing 3 in response to the "DID THE TICKETS PRINT OK?" prompt.
  2. The machine must not be emptied prior to the machine going full, as the reporting software assumes each bag has a preset number of containers in it (the full-by-count number defined in the appropriate silos table).

It is possible to recover from the two above two errors. The RVM's internal counters can be modified by using the Window's version of PCRVM (WinRVM). Use WinRVM's "Advanced | Edit RVM's internal counters" feature.

Note: the above LCD prompts can easily be changed to different wording by simply changing the message table.
The format of the individual distributor report can also be changed easily by changing ind_dist.vou.


Keypad command #4,02 prints a report detailing the current can and PET counts accumulated for every distributor and shows the last individual distributor report voucher number. The store can use this feature every day as a poor-man's data backup in case of catastrophic RVM memory failure. Sample report:

  Safeway
    123
DISTRIBUTOR
  COUNTS
  TICKET

7-up:2732
can:120, PET:17

Pepsi:4312
can:543, PET:4

Coke:9815
can:94, PET:66

Private Lbl:1432
can:432, PET:39

Unknown:0
can:0, PET:0
glass:0

Unknown:0
can:0, PET:0
glass:0

Unknown:0
can:0, PET:0
glass:0

Unknown:0
can:0, PET:0
glass:0

Unknown:0
can:0, PET:0
glass:0

Unknown:0
can:0, PET:0
glass:0

Last dist. voucher
number: 00000021

Meter:123456
Machine #650123
09/27/02  11:39:33

Note that the current report only shows the first 10 distributors, this can easily be changed to include all 16 distributors by changing the dist.vou file. Also, the last 6 distributor names have not been chosen, the ticket uses "Unknown" as the distributor name for these distributors.

Note that the number after the distributor's name such as "Coke:9815" represents the total number of containers the machine has accepted for that distributor since the last time that count was reset using keypad command #4,02's reset feature. 
The "can" and "PET" counts just below each distributor's name represent the current number of that distributor's cans and PET bottles the machine has accepted since the last time an individual distributor report ticket was printed via #4,40-66. These "can" and "PET" counts are not set to zero after a #4,40-66 command, rather they are reset to the remainder of cans that didn't fit into a bag. For example, if the machine is configured to go full after accepting 840 cans and the RVM redeems 900 Coke cans, the individual distributor report will indicate the Coke distributor is due one bag. The internal can count is reset to 60 after the distributor prints the report. If you perform keypad command #4,02, this report will indicate the Coke distributor has a can count of 60.

The old distributor report functionality is still supported (i.e. just use keypad command #4,02 to print a list of all distributors which will then clear all distributor counts). The #4,40-56 commands should not be used in this mode.

After the #4,02 report prints, the RVM displays:

    CLEAR ALL DISTRIBUTOR COUNTS
        * = NO    3 = YES

Normally the user should press '*'. If you have a valid reason to clear the counts, press '3' and the RVM will  display:

ENTER PASSWORD TO CLEAR COUNTS:____

To clear all the distributor counts, the password 3179 must be entered. This password can't be changed without a software change.


New voucher template commands (used to customize voucher/LCD messages):

%M0 = number of can bags the current distributor is entitled to
%M1 = number of glass bags the current distributor is entitled to
%M2 = number of PET bags the current distributor is entitled to
%M3 = number of cans in current distributor's bag(s)
%M4 = number of glass bottles in current distributor's bag(s)
%M5 = number of PET bottles in current distributor's bag(s)
%M6 = number of containers in current distributor's bag(s) = %M3 + %M4 + %M5
%M7 = value of cans in current distributor's bag(s), including handling fee
%M8 = value of glass bottles in current distributor's bag(s), including handling fee
%M9 = value of PET bottles in current distributor's bag(s), including handling fee
%MA = value of all containers in current distributor's bag(s), including handling fee = %M7+%M8+%M9
%MB = number of the current distributor can's RVM has accepted since last time bag counts were reset
%MC = number of the current distributor glass bottles RVM has accepted since last time bag counts were reset
%MD = number of the current distributor PET bottles RVM has accepted since last time bag counts were reset

%U0 = current distributor's name (defined in dist.vou)
%U1 = individual distributor report voucher number (both copies printed at same time have same number)
%U2 = previous individual distributor report voucher number
%U3 = can handling fee in cents (corresponds to HANDLINGFEE_C parameter)
%U4 = glass handling fee in cents (corresponds to HANDLINGFEE_G parameter)
%U5 = PET handling fee in cents (corresponds to HANDLINGFEE_P parameter)


New parameters:

Note: The handling fee parameters above define how much to pay per container including the deposit amount. If the handling fee is the same for all commodities then set all 3 parameters to the same value such as 0600 for 6 cents. Fractional cents are supported, so you could configure the RVM to pay 4.5 cents per can by setting HANDLINGFEE_C=0450.


Installation Notes:

Unzip the files (see below) into \CF1500 then run WinRVM. Select "Update RVM program". After completion, load the individual distributor report voucher template (ind_dist.vou) via Send To RVM | Printer Tickets/coupons | Distributor Report. Also see note below concerning the counters ticket template.

RVM table 14 was added which is the individual distributor report voucher template (ind_dist.vou). A new version of PCRVM is required to load this table. Currently, only the new Windows version of PCRVM (WinRVM) supports this via the Send To RVM | Printer Tickets/coupons | Distributor Report.

When loading the software, choose an RVM type of "AP" and set the crusher type to "shredder". This is the typical configuration for this distributor reporting software. However, the RVM can be configured as a stand-alone can, glass, or PET RVM or even as a multi-commodity can, glass, and PET RVM.

The bin configuration file must be configured for "full by count", as the reporting feature uses these numbers to determine how many containers are in a bag.

The counters ticket template defines the distributor report voucher (the counters ticket feature is not supported in this version of software). Therefore, dist.vou should be loaded in place of counters.vou (in Options, check "counters ticket" under "prompt for file name when sending these tables to RVM"). Or simply rename dist.vou to counters.vou if you've dedicated a directory on your hard disk for this distributor report software (counters.vou is used by regular versions of RVM software).
Every barcode must specify which distributor it belongs to. The coupon barcode attribute byte ( the 'c' in the barcode table: "barcode,v,c,t,o") identifies each barcode as belonging to one of 16 different distributors (0-F hex). 
The dist.vou file defines what distributor number (0-F hex) correspond to what distributor name. If some RVMs use different distributors than other RVMs, a system must be designed to handle this. For example, it's logical to assign certain distributor's permanent distributor numbers. 7-up can be distributor 1, Pepsi #2, Coke #3, etc. However, if you have more than 16 total distributors in a particular area (but not more than 16 different distributors in a single RVM) it becomes more complicated to manage the barcode files. You may have to configure distributor 9 in one RVM to be a different distributor than distributor 9 in another RVM down the street. The dist.vou file would be different for these two RVMs.

Troubleshooting: if keypad commands #4,40-55 doesn't display the distributor name, make sure dist.vou has been loaded in place of counters.vou and that dist.vou contains the name of the desired distributor such as "Coke:%H3" for distributor 3 which corresponds to keypad command #4,43.
Note: a ":" must be present after the distributor name as in "Coke:%H3", otherwise it will not show up on the RVM.

The distributor counts are not cleared after performing a software update as the new distributor counts are stored at the end of the counters table.

 

Software Updated:

Files Updated:

CF1500.IMG  (Oct 16 02 11:05) 

MESSAGES.TBL (10/16/02) 

  ERRLIST      (09/19/02)
  DIST.VOU     (10/10/02)
  IND_DIST.VOU (10/10/02)

Click here to download these files.