Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ cvt_at — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

2.0;cvt_at (convert_AT_addresses), revision 2.0, 86/10/08
CVT_AT (CONVERT_AT_ADDRESSES) -- Convert AT addresses to DOMAIN addresses
usage:    CVT_AT  [at_addr [at_addr] ...]   [at_addr1-at_addr2]


FORMAT

  CVT_AT  [at_addr [at_addr] ...]   [at_addr1-at_addr2]

  The  cvt_at  command  converts  AT addresses to DOMAIN addresses.  The command
  reports any conflict between the AT address you specify and any DOMAIN  system
  devices.  It  also  gives  you  the CSR page iova that you supply to the crddf
  command when building the device descriptor file (DDF)  for  the  device.   If
  you  specify one or more at_addrs, cvt_at translates each address and displays
  its DOMAIN physical address, DOMAIN page number, DOMAIN offset within a  page,
  and  CSR  iova.   In pairs, the command gives a warning if two addresses  fall
  on the same DN3000 page.  Also in pairs, if one address is a  PC-type  (0-3FF)
  and  the  other  is an AT-type (0-FFFF), cvt_at issues a warning if they would
  conflict with each other on the bus.

  If  you  specify  a  dashed  parameter,  cvt_at  generates  and  converts  all
  addresses  between  those  values.   Both  addresses  must  be  either PC-type
  (0-3FF) or AT-type (0-FFFF).  If the specified at_addr conflicts with a  known
  DN3000 system device control page, the command issues a warning.

  If  you  specify  two  separate at_addrs, the command translates the addresses
  and gives a warning if they fall on the same DN3000 page.

ARGUMENTS

  at_addr             Specify an AT I/O address (in hexadecimal)


  at_addr1-at_addr2   Specify a range of AT I/O addresses (in hexadecimal)

EXAMPLES:


  1.  $ cvt_at 5100
      AT Addr   DOMAIN Phys Addr   DOMAIN PPN   Page offset   Csr Iova
      5100          48140             120          140          100

  The cvt_at command converts  the  AT  address  5100  to  the  DOMAIN  physical
  address  48140  and  issues  a  CSR  iova  of 100.  When you create the device
  descriptor file for the AT device, use this iova  (not  the  AT  address)  as
  input  to  the  crddf  command  option  -csr_page (for example, crddf /dev/at1
  -csr_page 100).

  2.  $ cvt_at 1a4
      AT Addr   DOMAIN Phys Addr   DOMAIN PPN   Page offset   CSR Iova
      1A4          4D004             134            4          1A4
      Warning:  Above address (1A4) may occupy same physical page as
      DOMAIN device, if present: winchester (4D000).

  The cvt_at command converts the AT address 1A4 to  the  DOMAIN  address  4D004
  and  issues a warning that a conflict between device control pages exists if a
  Winchester disk is present in the configuration.

  3.  $ cvt_at 41a4
      AT Addr   DOMAIN Phys Addr   DOMAIN PPN   Page offset   Csr Iova
      41A4          4D104             134          104          1A4
      Warning:  Above address (41A4) may occupy same physical page as
      DOMAIN device, if present: winchester (4D000).




Typewritten Software • bear@typewritten.org • Edmonds, WA 98026