summaryrefslogtreecommitdiffstats
path: root/src/usr/pnor/pnordd.H
blob: df953e203f1feb3c2ee184cf0dc93f2ec17e6bb1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
#ifndef __PNOR_PNORDD_H
#define __PNOR_PNORDD_H

/** @file pnordd.H
 *  @brief Provides the interfaces to the PNOR Device Driver
 */

namespace PNOR
{

//Not sure if this is the right place for these enums, open to suggestions.
/**
 * PNOR Modes
 */
enum lscMode
{
  MMRD = 0,  /**< Indicates PNOR is in MMRD Mode */
  PMWR,      /**< Indicates PNOR is in PMWR Mode */    

  LAST_MODE = PMWR,
};


/**
 *  @brief  Type definition for PNOR address
 */
typedef uint64_t PNORAddress_t;


//@TODO: comment args
/**
 * @brief External interface for setting LSC mode
 */
errlHndl_t setLSCAccessMode(lscMode i_mode);



class PnorDD
{

  public:
    //@TODO: comment args
    /**
     * @brief Performs an PNOR Read Operation
     */
    errlHndl_t read(void* o_buffer,
                    size_t& io_buflen,
                    uint64_t i_address);

    //@TODO: comment args
    /**
     * @brief Performs an PNOR Write Operation
     */
    errlHndl_t write(void* i_buffer,
                     size_t& io_buflen,
                     uint64_t i_address);

    //@TODO: comment args
    /**
     * @brief Set LSC to desired access mode
     */
    errlHndl_t setAccessMode(lscMode i_mode);



  protected:
    /**
     * @brief Constructor
     */
    PnorDD();


    /**
     * @brief Destructor
     */
    ~PnorDD();

    //@TODO: comment args
    /**
     * Verify Request is in appropriate address range
     *
     */
    errlHndl_t verifyAddressRange(uint64_t i_address,
                                  size_t& i_length);


  private:

    /**
     * PNOR Mode Flag
     */
    lscMode iv_lscMode;

};

}; //end PNOR namespace

#endif
OpenPOWER on IntegriCloud